API de traducción
Envía tus documentos a Edgepedia Translate desde un script y recibe las traducciones. Es el mismo servicio que la página de Traducción, con los mismos precios y con cargo a los mismos créditos.
Obtener una clave
Crea una clave en la página de Traducción: inicia sesión, abre tu cuenta en la esquina superior derecha y selecciona Crear en Claves de API.
Envía la clave en cada solicitud como Authorization: Bearer ept_…. Mantenla en secreto: cualquiera que la tenga puede gastar tus créditos.
Precios
- Estándar: 1 crédito por cada 250 palabras (mínimo 1).
- Pro: 1 crédito por cada 75 palabras (mínimo 2).
- Si ninguno de los dos idiomas es el inglés, el precio se duplica.
- 100 créditos = 1 USD.
Si una traducción falla, se devuelven los créditos.
Rutas
URL base: https://translate.edgepedia.ai. Las solicitudes y las respuestas están en formato JSON; los errores se expresan como {"error": "…"}.
GET /api/v1/languages
Los idiomas, con indicación de si Pro está disponible para cada uno.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/languages
GET /api/v1/balance
Tus créditos.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/balance
POST /api/v1/quote
El precio y el tiempo estimado de una traducción, sin iniciarla. mode es standard o pro.
La consulta de precio también admite "source": "auto": la respuesta indica, mediante "detected": true, el idioma detectado en "source"; luego se inicia una traducción con ese código.
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard"}' \
https://translate.edgepedia.ai/api/v1/quote
POST /api/v1/translations
Inicia la traducción de un texto o de un archivo .txt, .md, .docx o .pdf de hasta 10 MB. Añade "expect_credits" para que se rechace la solicitud (409) si el precio no es el que esperas. Añade "wait" (hasta 120 segundos) para recibir la traducción terminada en la misma respuesta.
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard", "wait": 60}' \
https://translate.edgepedia.ai/api/v1/translations
curl -H "Authorization: Bearer $KEY" -F file=@report.docx -F source=en -F target=ar -F mode=standard \
https://translate.edgepedia.ai/api/v1/translations
GET /api/v1/translations/{id}
El estado de una traducción (queued, running, done o failed) y, cuando termina, su texto. Si falla, se indica el motivo. Una traducción terminada se puede recuperar durante 30 días.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations/$ID
GET /api/v1/translations/{id}/download
El resultado de la traducción de un archivo: un .docx para archivos .docx y .pdf, y texto para .txt y .md.
curl -H "Authorization: Bearer $KEY" -o translated.docx https://translate.edgepedia.ai/api/v1/translations/$ID/download
GET /api/v1/translations
Tus traducciones, de la más reciente a la más antigua, hasta un máximo de 50.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations
Códigos de estado
| Código | Significado |
|---|---|
| 200 | OK; al iniciar con wait, la traducción ha terminado o ha fallado. |
| 202 | Iniciada, o sigue en curso tras wait. |
| 400 | La solicitud no se puede traducir tal como se envió; el error indica el motivo. |
| 401 | Clave ausente, desconocida o revocada. |
| 402 | No tienes suficientes créditos. |
| 404 | No existe esa traducción en tu cuenta. |
| 409 | El precio no coincide con tu expect_credits; no se ha realizado ningún cargo. |
| 413 | El archivo supera los 10 MB. |
| 429 | Más de 60 solicitudes en un minuto; vuelve a intentarlo cuando pasen los segundos que indica Retry-After. |