Documentation de l’API

Référence complète pour intégrer l’API TranslateMyImage

Détails du point d’accès API

Envoyez une image à traduire avec une clé API active. Les clés API sont disponibles à partir de l’offre Pro. Chaque traduction terminée consomme un crédit.

Point d’accès

POST

https://translatemyimage.com/api/translate

En-têtes requis

En-tête	Valeur
Content-Type	multipart/form-data (défini automatiquement par votre client HTTP)
X-API-Key	YOUR_API_KEY

Créez votre clé sur la page des clés API. Elle n’est affichée qu’une fois. Envoyez-la dans l’en-tête X-API-Key ; les clients API n’ont pas besoin de session navigateur.

Paramètres du corps

Paramètre	Type	Description
file	Obligatoire File	Un fichier image (JPG, PNG ou WEBP), jusqu’à 10 Mo et 25 mégapixels.
target_lang	Obligatoire String	Code de langue cible : en, fr, es, de, it, pt, ja, ko ou zh.
source_lang	Facultatif String	Code de langue source. S’il est omis, la langue est détectée automatiquement. Utilisez « auto » pour le même comportement.
quality	Facultatif String	« basic » (par défaut) ou « ultra ».
business_type	Facultatif String	« default », « marketing », « edition » ou « technical documentation ».
custom_prompt	Facultatif String	Instructions IA facultatives, jusqu’à 1 000 caractères, disponibles à partir de l’offre Pro.

Réponses

Statut	Description
200 OK	Traduction terminée ; un crédit est consommé.
400 Bad Request	Entrée invalide, format non pris en charge ou fichier manquant.
401 Unauthorized	Clé API absente, invalide ou révoquée sans session active.
403 Forbidden	Les clés API nécessitent l’offre Pro ou une offre supérieure ; certaines options exigent aussi une offre éligible.
429 Too Many Requests	Le service d’images est limité. Réessayez plus tard.
500 Internal Server Error	Le traitement a échoué.

Les erreurs renvoient du JSON avec success: false et un message dans le champ error.

Une fois la requête authentifiée, les réponses d’erreur incluent aussi un champ code stable, pour que votre intégration puisse y réagir sans analyser le message en anglais :

invalid_request
invalid_image
plan_required
insufficient_credits
content_blocked
service_unavailable
generation_failed
unknown

Les erreurs d’authentification (clé API absente, invalide ou révoquée, ou compte sans accès à l’API) n’ont pas de code.

Exemple d’appel API

Choisissez votre langage pour afficher l’exemple d’implémentation

curl -X POST https://translatemyimage.com/api/translate \
    -H "X-API-Key: YOUR_API_KEY" \
    -F "file=@/path/to/image.jpg" \
    -F "target_lang=en" \
    -F "source_lang=auto"

Format de réponse

L’API renvoie un objet JSON contenant les résultats de traduction et les URL.

Charge utile de réponse réussie

{
    "success": true,
    "translation": {
      "id": "clxb1234567890",
      "originalUrl": "https://storage.com/original.jpg",
      "translatedUrl": "https://storage.com/translated.jpg",
      "sourceLang": "fr",
      "targetLang": "en",
      "status": "completed",
      "createdAt": "2026-09-21T15:27:39.000Z",
      "metadata": { "quality": "basic", "model": "muse-image" }
    }
}