Documentation de l'API

Traduit le texte contenu dans une image tout en préservant la mise en page d'origine, puis réinjecte la traduction directement dans l'image.

Démarrage rapide

curl -X POST https://api.imagetranslate.ai/translate/image \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "imageBase64": "iVBORw0KGgoAAAANSUhEUgAA...",
    "sourceLanguage": "ja",
    "targetLanguage": "en",
    "mode": "general",
    "translator": "Grok"
  }'

Authentification

Chaque requête doit inclure la clé API dans l'en-tête Authorization au format Bearer :

Authorization: Bearer YOUR_KEY

Les clés API sont des chaînes aléatoires de 32 octets préfixées par sk_imagetranslate_. Traitez-les comme des mots de passe : stockez-les dans un gestionnaire de secrets côté serveur, ne les versionnez jamais dans un dépôt et ne les exposez pas dans du code front-end.

Idempotence

Si vous relancez une requête après un délai d'attente réseau, renvoyez le même en-tête Idempotency-Key afin d'éviter de débiter deux fois des crédits :

Idempotency-Key: <votre-uuid>

• Premier appel avec une clé donnée : traité normalement.
• Appel suivant avec la même clé (par clé API) : renvoie 409 Conflict ainsi que le recordId d'origine. La nouvelle tentative ne consomme pas de crédit.
• Des clés différentes correspondent à des appels différents.

Générez la clé côté client (un UUIDv4 convient). Sans elle, chaque nouvelle tentative consomme un crédit supplémentaire et relance Torii.

Traduire une image

Endpoint synchrone. Renvoie l'image traduite encodée en base64 (avec le préfixe data:image/png;base64,).

URL de base

https://api.imagetranslate.ai

Corps de la requête

Réponse

Exemples

curl -X POST https://api.imagetranslate.ai/translate/image \
  -H "Authorization: Bearer $IMAGETRANSLATE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "imageBase64": "YOUR_BASE64_IMAGE",
    "sourceLanguage": "ja",
    "targetLanguage": "en",
    "mode": "general",
    "translator": "Grok"
  }'

Exemple de réponse

{
  "success": true,
  "recordId": "Z3l4abc...",
  "resultImage": "data:image/png;base64,iVBORw0KGgoAAAANSU...",
  "remainingCredit": 9990
}

Codes d'erreur

Format de la réponse d'erreur

• 4xx / 500: { "detail": "<message>" }
• 422: { "detail": [{ "loc": [...], "msg": "...", "type": "..." }] }
• 409: { "error": "idempotency_replay", "recordId": "<id>", "message": "..." }

Limites de débit

Appliquées par clé API et par minute, selon le plan :

Besoin d'une limite plus élevée ? Contactez [email protected].

Tarifs

10 advanced credits par appel. Détail des plans et des packs sur la page tarifs.

Annexe

Codes de langue

sourceLanguage accepte un code ISO 639-1 / BCP-47, ou auto pour détecter automatiquement la langue source. targetLanguage accepte les mêmes codes, à l'exception de auto.

Codes courants :

Valeurs mode

mode définit le style de rendu. Choisissez celui qui correspond le mieux à votre image.

Modèles translator

translator désigne le modèle d'IA chargé de la traduction. Chaque modèle coûte 10 crédits par appel.

• Grok (par défaut)
• Gemini
• Deepseek
• ChatGPT
• Claude

Pour commencer

Prêt à intégrer l'API ? Créez votre première clé API →