edgepedia traduction

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

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

CodeSignification
200OK ; pour un lancement avec wait, la traduction est terminée ou a échoué.
202Lancée, ou toujours en cours après wait.
400La requête ne permet pas de lancer la traduction en l’état ; l’erreur en indique la raison.
401Clé manquante, inconnue ou révoquée.
402Crédits insuffisants.
404Cette traduction est introuvable dans votre compte.
409Le prix ne correspond pas à votre expect_credits ; aucun montant n’a été débité.
413Le fichier dépasse 10 MB.
429Plus de 60 requêtes en une minute ; réessayez après le nombre de secondes indiqué par Retry-After.