Aller au contenu principal

Guide de démarrage rapide

Commencez avec l'API YODI en seulement 5 minutes.

Prérequis​

  • Un compte YODI
  • Une clĂ© API (vous pouvez en crĂ©er une dans votre tableau de bord)
  • cURL, Postman, ou tout client HTTP

Étape 1 : Obtenez votre clé API​

  1. Connectez-vous sur https://console.yodi.tg
  2. Allez dans Clés API
  3. Cliquez sur Générer une nouvelle clé
  4. Copiez et conservez votre clé en lieu sûr

Étape 2 : Effectuez votre première requête​

Avec cURL​

curl -X POST "https://admin.yodi.tg/api/ai/translate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Bonjour, comment allez-vous?",
    "sourceLanguage": "fra_Latn",
    "targetLanguage": "ewe_Latn"
  }'

Avec Python​

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}

data = {
    'text': 'Bonjour, comment allez-vous?',
    'sourceLanguage': 'fra_Latn',
    'targetLanguage': 'ewe_Latn'
}

response = requests.post(
    'https://admin.yodi.tg/api/ai/translate',
    headers=headers,
    json=data
)

print(response.json())

Avec JavaScript​

const response = await fetch("https://admin.yodi.tg/api/ai/translate", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    text: "Bonjour, comment allez-vous?",
    sourceLanguage: "fra_Latn",
    targetLanguage: "ewe_Latn",
  }),
});

const data = await response.json();
console.log(data);

Étape 3 : Vérifiez votre réponse​

Vous devriez recevoir une réponse JSON avec le texte traduit :

{
  "message": "SUCCESS",
  "error": false,
  "data": {
    "translatedText": "Akɔtaba me, ɔlɔ ɖe?",
    "sourceLanguage": "fra_Latn",
    "targetLanguage": "ewe_Latn"
  },
  "status": 200
}

Langues prises en charge​

YODI prend en charge la traduction pour les langues ouest-africaines :

CodeLangue
fra_LatnFrench (Français)
ewe_LatnEwe
mina_LatnMina
kdh_LatnTem (Kotokoli)

Problèmes courants​

401 Non autorisé​

Votre clé API est invalide ou manquante. Vérifiez que :

  • Vous avez inclus l'en-tĂŞte Authorization
  • Le format de la clĂ© est correct : Bearer YOUR_API_KEY
  • Votre clĂ© n'a pas expirĂ©

400 Mauvaise requête​

Vérifiez que tous les paramètres requis sont inclus dans votre requête.

Prochaines étapes​