API Partenaires · Sprint 4
Dataset émotionnel MWA
Récits humains annotés sur 4 axes émotionnels. Consentement explicite. Licence CC-BY-NC 4.0.
Axes d'annotation émotionnelle
Chaque récit est annoté par son auteur sur 4 dimensions issues de la psychologie cognitive.
Authentification
Toutes les requêtes au dataset nécessitent un en-tête Authorization avec votre clé Bearer.
Si vous n'avez pas encore de clé, demandez l'accès ici.
Authorization: Bearer votre_cle_api_ici
Les clés sont générées par l'équipe MWA après validation de votre usage. Elles ne sont affichées qu'une seule fois à la création.
Référence API
Retourne les récits du dataset avec leurs annotations émotionnelles, paginés. Seuls les récits dont les auteurs ont donné leur consentement à l'entraînement IA sont inclus.
Paramètres
| Paramètre | Type | Description |
|---|---|---|
| limitoptionnel | integer | Nombre de résultats (défaut 100, max 500) |
| offsetoptionnel | integer | Décalage pour la pagination (défaut 0) |
| sinceoptionnel | ISO 8601 | Ne retourner que les récits ajoutés après cette date — ex. 2026-01-01 |
Réponse
{
"data": [
{
"id": "mwa-a3f9b2c1",
"text": "Il y avait dans sa façon de poser les mains...",
"theme": "memoire",
"lang": "fr",
"emotions": {
"valence": 0.72,
"arousal": 0.45,
"agency": 0.68,
"lien": 0.90
},
"dominant": "tendresse",
"license": "CC-BY-NC-4.0"
}
],
"count": 1,
"offset": 0,
"limit": 100,
"license": "CC-BY-NC-4.0",
"attribution": "MWA.IVLABS.IO — Triads / Ahlvi Dowlut"
}
Exemple d'utilisation
Requête cURL
curl https://mwa.ivlabs.io/api/dataset \
-H "Authorization: Bearer votre_cle_api_ici" \
-G --data-urlencode "limit=50" \
--data-urlencode "since=2026-01-01"
Python
import requests
headers = {"Authorization": "Bearer votre_cle_api_ici"}
params = {"limit": 50, "offset": 0}
r = requests.get("https://mwa.ivlabs.io/api/dataset",
headers=headers, params=params)
data = r.json()
for record in data["data"]:
print(record["text"][:80], record["emotions"])
Testeur en ligne
Entrez votre clé API pour tester l'accès directement depuis cette page.
Licence et attribution
Le dataset MWA est publié sous licence Creative Commons Attribution — Non Commercial 4.0.
Autorisé : recherche académique, développement de modèles d'IA bienveillante, projets non-commerciaux avec attribution.
Interdit : ré-identification des auteurs, usage publicitaire ou de ciblage, scoring individuel, manipulation émotionnelle, revente des données brutes.
Attribution requise : MWA.IVLABS.IO — Triads / Ahlvi Dowlut — CC-BY-NC-4.0
Limites et bonnes pratiques
| Paramètre | Valeur |
|---|---|
| Max records par requête | 500 |
| Format des IDs | mwa-{uuid8} |
| Langues actuelles | Français (fr) — EN, DE, ES planifiés Sprint 5 |
| Mise à jour des données | Continue (nouveaux récits approuvés quotidiennement) |
| Révocation consentement | Un enregistrement peut disparaître si l'auteur révoque son consentement |