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
https://translatemyimage.com/api/translateCabeceras 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. |
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_requestinvalid_imageplan_requiredinsufficient_creditscontent_blockedservice_unavailablegeneration_failedunknown
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.
{
"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" }
}
}