API de traduction
Envoyez vos propres documents à Edgepedia Translate depuis un script et récupérez leurs traductions. C’est le même service que la page Traduction, aux mêmes tarifs, payé avec les mêmes crédits.
Obtenir une clé
Créez une clé sur la page Traduction : connectez-vous, ouvrez votre compte en haut à droite, puis choisissez Créer sous CLÉS API.
Transmettez la clé avec chaque requête sous la forme Authorization: Bearer ept_…. Gardez-la secrète : toute personne qui la possède peut dépenser vos crédits.
Tarifs
- Standard : 1 crédit pour 250 mots (1 minimum).
- Pro : 1 crédit pour 75 mots (2 minimum).
- Pour une traduction entre deux langues autres que l’anglais, le prix est doublé.
- 100 crédits = 1 USD.
En cas d’échec d’une traduction, les crédits sont remboursés.
Routes
URL de base : https://translate.edgepedia.ai. Les requêtes et les réponses sont au format JSON ; une erreur prend la forme {"error": "…"}.
GET /api/v1/languages
Les langues, avec pour chacune la disponibilité du mode Pro.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/languages
GET /api/v1/balance
Vos crédits.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/balance
POST /api/v1/quote
Le prix et la durée estimée d’une traduction, sans la lancer. mode vaut standard ou pro.
Une estimation accepte aussi "source": "auto" : sa réponse indique dans "source" la langue détectée, avec "detected": true ; lancez ensuite la traduction avec ce code.
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard"}' \
https://translate.edgepedia.ai/api/v1/quote
POST /api/v1/translations
Lancez la traduction d’un texte ou d’un fichier .txt, .md, .docx ou .pdf de 10 MB maximum. Ajoutez "expect_credits" pour que la requête soit refusée (409) si le prix ne correspond pas à celui attendu. Ajoutez "wait" (jusqu’à 120 secondes) pour recevoir la traduction terminée dans la même réponse.
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard", "wait": 60}' \
https://translate.edgepedia.ai/api/v1/translations
curl -H "Authorization: Bearer $KEY" -F file=@report.docx -F source=en -F target=ar -F mode=standard \
https://translate.edgepedia.ai/api/v1/translations
GET /api/v1/translations/{id}
L’état d’une traduction (queued, running, done ou failed) et, une fois terminée, son texte. En cas d’échec, la raison est indiquée. Une traduction terminée peut être récupérée pendant 30 jours.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations/$ID
GET /api/v1/translations/{id}/download
Le résultat de la traduction d’un fichier : un fichier .docx pour les fichiers .docx et .pdf, du texte pour les fichiers .txt et .md.
curl -H "Authorization: Bearer $KEY" -o translated.docx https://translate.edgepedia.ai/api/v1/translations/$ID/download
GET /api/v1/translations
Vos traductions, de la plus récente à la plus ancienne, dans la limite de 50.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations
Codes de statut
| Code | Signification |
|---|---|
| 200 | OK ; pour un lancement avec wait, la traduction est terminée ou a échoué. |
| 202 | Lancée, ou toujours en cours après wait. |
| 400 | La requête ne permet pas de lancer la traduction en l’état ; l’erreur en indique la raison. |
| 401 | Clé manquante, inconnue ou révoquée. |
| 402 | Crédits insuffisants. |
| 404 | Cette traduction est introuvable dans votre compte. |
| 409 | Le prix ne correspond pas à votre expect_credits ; aucun montant n’a été débité. |
| 413 | Le fichier dépasse 10 MB. |
| 429 | Plus de 60 requêtes en une minute ; réessayez après le nombre de secondes indiqué par Retry-After. |