documentación

Referencia de la API.

Cada punto de conexión al que puedes llamar con una clave de API se genera a partir del mismo manifiesto desde el que se enruta la API, con ejemplos prácticos de solicitud y respuesta validados con los esquemas activos. Empieza con inicio rápido para desarrolladores para conocer el flujo completo.

¿Desarrollas en JavaScript o TypeScript? Es posible que no necesites la API básica en absoluto. Ver los paquetes →

convenciones

La estructura de cada solicitud.

Una URL base, una cabecera de autenticación mediante token, JSON de entrada y de salida. Las claves incluyen ámbitos (translate:write, jobs:read) y cada ruta requiere el correspondiente. La gestión de cuentas, facturación, equipos, webhooks y claves se realiza en la interfaz de la aplicación, no en la API; una clave no puede crear otras claves ni modificar la facturación.

URL base
https://api.echo-lingua.com/v1
cada solicitud
Authorization: Bearer elk_live_2b7f…
Content-Type: application/json
referencia · 19 puntos de conexión

Puntos de conexión a los que puedes llamar con una clave.

Haz clic en cualquier punto de conexión para ver sus opciones, un ejemplo de solicitud y respuesta, y código listo para copiar en cURL, JS/TS, Python y PHP. Cada uno indica el ámbito que necesita; GET /v1/health es Público y no requiere autenticación. Las operaciones exclusivas del panel y de administración no se muestran, ya que requieren una sesión iniciada y no una clave.

Trabajos

El flujo por lotes: crea un trabajo, calcula su tamaño, revísalo y descarga el paquete con la estructura del repositorio. Revisa, reintenta lo fallido o vuelve a procesar desde el origen.

Traducción sincrónica

Traduce una cadena o los literales de un fragmento de código en línea, sin necesidad de consultar trabajos. Se cobra a la par de los trabajos regulares.

Plantillas

Genera archivos PO vacíos por idioma a partir de un origen, sin traducciones ni costos.

Uso y costos

Consulta mediante programación el uso, los gastos y los límites del periodo actual.

Servicio

Una sonda de actividad pública para comprobaciones de estado y monitorización.

Se muestran 19 de 19 puntos de conexión
costes de lectura

Todos los importes están en micro-USD.

El dinero en la API es un recuento entero de micro-USD (millonésimas de dólar estadounidense), por lo que 1.000.000 equivale a 1 $. Divida por un millón para obtener dólares. El uso de números enteros significa que las fracciones de centavo nunca se redondean: un trabajo pequeño puede costar legítimamente unas pocas décimas de centavo.

micro-USD → USD
// Every *Micros field is an integer count of micro-USD (millionths of a dollar).
const usd = (micros) => micros / 1_000_000;

usd(52500);      // 0.0525   → about 5¢
usd(322500);     // 0.3225   → about 32¢
usd(1_000_000);  // 1.00     → one dollar

// Format it for display:
const fmt = (micros) =>
  new Intl.NumberFormat('en-US', { style: 'currency', currency: 'USD' })
    .format(micros / 1_000_000);   // fmt(52500) → "$0.05"

Los campos de dinero

chargedMicros — lo que un trabajo o presupuesto deduciría de su saldo.

creditRequiredMicros — el saldo que necesita para iniciar un trabajo: el cargo más un pequeño margen de seguridad.

Los totales de uso de GET /v1/usage utilizan la misma unidad.

Ejemplo: un chargedMicros de 52500 es $0.0525.

intégralo en tu canal de desarrollo.

Crea una clave con ámbito, haz un POST con un trabajo y deja que el webhook firmado te avise cuando termine.

Leer la guía para desarrolladores