edgepedia traducción

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

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ódigoSignificado
200OK; al iniciar con wait, la traducción ha terminado o ha fallado.
202Iniciada, o sigue en curso tras wait.
400La solicitud no se puede traducir tal como se envió; el error indica el motivo.
401Clave ausente, desconocida o revocada.
402No tienes suficientes créditos.
404No existe esa traducción en tu cuenta.
409El precio no coincide con tu expect_credits; no se ha realizado ningún cargo.
413El archivo supera los 10 MB.
429Más de 60 solicitudes en un minuto; vuelve a intentarlo cuando pasen los segundos que indica Retry-After.