Documentación de la API

Referencia completa para integrar la API de TranslateMyImage

Detalles del endpoint de la API

Envía una imagen para traducir con una clave API activa. Las claves API están disponibles desde el plan Pro. Cada traducción completada consume un crédito.

Endpoint

POST

https://translatemyimage.com/api/translate

Cabeceras obligatorias

Cabecera	Valor
Content-Type	multipart/form-data (tu cliente HTTP lo establece automáticamente)
X-API-Key	YOUR_API_KEY

Crea tu clave en la página de claves API. Solo se muestra una vez. Envíala en la cabecera X-API-Key; los clientes API no necesitan sesión de navegador.

Parámetros del cuerpo

Parámetro	Tipo	Descripción
file	Obligatorio File	Un archivo de imagen (JPG, PNG o WEBP), de hasta 10 MB y 25 megapíxeles.
target_lang	Obligatorio String	Código de idioma de destino: en, fr, es, de, it, pt, ja, ko o zh.
source_lang	Opcional String	Código de idioma de origen. Si se omite, se detecta automáticamente. Usa «auto» para el mismo comportamiento.
quality	Opcional String	«basic» (predeterminado) o «ultra».
business_type	Opcional String	«default», «marketing», «edition» o «technical documentation».
custom_prompt	Opcional String	Instrucciones de IA opcionales, hasta 1.000 caracteres, disponibles desde el plan Pro.

Respuestas

Estado	Descripción
200 OK	Traducción completada; se consume un crédito.
400 Bad Request	Entrada no válida, formato no compatible o archivo ausente.
401 Unauthorized	Falta una clave API o es inválida/revocada cuando no hay sesión.
403 Forbidden	Las claves API requieren el plan Pro o uno superior; algunas opciones también requieren un plan compatible.
429 Too Many Requests	El servicio de imágenes está limitado. Reintenta más tarde.
500 Internal Server Error	El procesamiento falló.

Las respuestas de error usan JSON con success: false y un mensaje en el campo error.

Una vez autenticada la solicitud, las respuestas de error incluyen además un campo code estable, para que tu integración pueda reaccionar sin analizar el mensaje en inglés:

invalid_request
invalid_image
plan_required
insufficient_credits
content_blocked
service_unavailable
generation_failed
unknown

Los errores de autenticación (clave API ausente, inválida o revocada, o cuenta sin acceso a la API) no tienen código.

Ejemplo de llamada a la API

Selecciona tu lenguaje para ver el ejemplo de implementación

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"

Formato de respuesta

La API devuelve un objeto JSON con los resultados de traducción y las URL.

Carga útil de respuesta correcta

{
    "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" }
    }
}