API de Traducción
Amplía tu alcance traduciendo tus subtítulos a más de 100 idiomas con IA de última generación.
POST
/api/v1/translateImplementación Rápida
curl -X POST https://api.srtgen.com/api/v1/translate \ -H "x-api-key: <YOUR_API_KEY>" \ -F "projectId=proj_8k2n9m1b" \ -F "targetLanguageCode=es" \ -F "modelId=pro"
POSThttps://api.srtgen.com/api/v1/translate
Parámetros de Solicitud
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
projectId | String | Yes | El identificador único del proyecto a traducir. |
targetLanguageCode | String | Yes | Código ISO 639-1 (ej. 'es', 'fr', 'zh-CN'). |
modelId | String | No | 'pro' (Alta Calidad, 1 crédito/min) o 'basic' (Rápido, 1 crédito/2 mins). Por defecto es 'basic'. |
Avanzado: Modelo Básico (Optimización de costes)
curl -X POST https://api.srtgen.com/api/v1/translate \ -H "x-api-key: <YOUR_API_KEY>" \ -F "projectId=proj_8k2n9m1b" \ -F "targetLanguageCode=zh-CN" \ -F "modelId=basic"
POSThttps://api.srtgen.com/api/v1/translate
Respuesta Exitosa
Una solicitud exitosa devuelve un estado 200 OK. Los subtítulos traducidos se sincronizan inmediatamente y están disponibles para su exportación o posterior modificación en el espacio de trabajo.
{ "success": true, "projectId": "proj_8k2n9m1b", "targetLanguageCode": "es", "modelId": "pro" }
Códigos de Error
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| 400 | missing_parameter | Falta el ID del proyecto o el idioma de destino. | |
| 401 | unauthorized | La clave API falta o no es válida. | |
| 404 | not_found | El ID del proyecto no existe. | |
| 403 | insufficient_balance | Créditos insuficientes para la operación. | |
| 500 | translation_failed | El motor de IA falló al procesar la solicitud. | |
| 500 | server_error | Ocurrió un error interno inesperado del servidor. |
Estructura de Respuesta de Error
{ "success": false, "error": "not_found", "message": "No se pudo encontrar el proyecto con ID 'proj_unknown'." }
¿Fue útil esta página?