Documentación de la API

La API de TranslateMyImage traduce el texto de una imagen y devuelve una imagen nueva, no una lista de cadenas. Envía un JPG, PNG o WebP y un idioma de destino a un único endpoint: la respuesta JSON enlaza a la imagen traducida, generada conservando el diseño original.

¿Es tu primera vez con la API? Lee qué hace la API de traducción de imágenes, con ejemplos de peticiones en curl, Python y Node.js.

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

CabeceraValor
Content-Typemultipart/form-data (tu cliente HTTP lo establece automáticamente)
X-API-KeyYOUR_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ámetroTipoDescripció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

EstadoDescripción
200 OK
Traducción completada; se consume un crédito.
202 Accepted
El modelo principal rechazó esta imagen, así que un modelo alternativo la traduce, lo que tarda unos minutos. La respuesta contiene translation.status: "processing". Llama a GET /api/translate?id= con el translation.id devuelto y la misma X-API-Key hasta que translations[0].status sea completed (entonces se consume un crédito) o failed; translations[0].metadata.failureCode indica entonces uno de los códigos siguientes.
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.
402 Payment Required
No quedan créditos suficientes (código insufficient_credits). Reintentar no sirve: añade créditos o espera la renovación mensual.
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" }
    }
}