Envía las fuentes que ya tienes y recibe un motor. POST /jobs/provisioning toma un nombre para un motor nuevo y hasta 10 fuentes — enlaces para rastrear o texto sin formato — y devuelve 202 Accepted con el ID del motor. No tienes que esperar a que la IA termine de leer tu contenido: el motor existe desde el momento en que responde la llamada, y su configuración se va aplicando mientras se ejecuta el trabajo.
POST /jobs/provisioningEsta página cubre la llamada de creación: sus parámetros, la estructura de la solicitud y la respuesta 202. ¿Eres nuevo en el aprovisionamiento asíncrono? Empieza por la Descripción general de la API de aprovisionamiento asíncrono para entender el modelo. Qué se considera una buena fuente tiene su propia página — Tipos de fuente — y lo que la IA extrae de ellas está en Lo que extrae la IA.
Autenticación
Pasa tu clave de API en el encabezado X-API-Key. Las claves tienen alcance a nivel de organización y dan acceso a todos los motores de la organización. Consulta Autenticación para más detalles.
Parámetros#
Solo engine.name es obligatorio. Todo lo demás define lo que aprende el motor o, si lo omites por completo, te deja con un motor limpio y con la configuración predeterminada.
| Parámetro | Tipo | Descripción |
|---|---|---|
engine.name | string | Nombre del nuevo motor de localización. |
engine.description | string (opcional) | Descripción de texto libre para el motor. |
locales | string[] (opcional) | Idiomas de destino en BCP-47 para configurar, por ejemplo, ["es", "ja", "de"]. |
sources | array (opcional) | Hasta 10 fuentes para analizar. Cada una puede ser link (una URL que la plataforma rastrea) o content (texto sin formato o markdown). Consulta Tipos de fuente. |
callbackUrl | string (opcional) | URL HTTPS del webhook para el resultado final. Solo HTTPS: las URL de callback HTTP se rechazan. Consulta Entrega de webhooks. |
Solicitud#
Una fuente es un objeto { type, payload }. Apunta las fuentes link a páginas con contexto real — lineamientos de marca, guías de estilo, documentación del producto — y usa content para terminología y reglas de tono que puedas pegar directamente. La solicitud de abajo combina ambas: dos páginas para rastrear y un bloque de reglas explícitas.
const response = await fetch("https://api.lingo.dev/jobs/provisioning", {
method: "POST",
headers: {
"X-API-Key": process.env.LINGO_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
engine: {
name: "Acme Corp Engine",
description: "Production localization engine for acme.com",
},
locales: ["de", "fr", "ja", "es"],
sources: [
{ type: "link", payload: "https://acme.com/brand-guidelines" },
{ type: "link", payload: "https://acme.com/docs/style-guide" },
{
type: "content",
payload:
"Brand name 'Acme' is never translated. Use formal tone in German (Sie-form). Product names: AcmeFlow, AcmeSync, AcmeVault - always keep in English.",
},
],
callbackUrl: "https://your-app.com/webhooks/provisioning",
}),
});
const { jobId, engineId, status } = await response.json();
// 202 back right away.
// status: "in_progress" – the AI is reading your sources.
console.log(engineId); // "eng_X1y2Z3a4B5c6D7e8" – usable right nowRespuesta (202 Accepted)#
La llamada responde sin esperar al rastreo ni al análisis: te entrega un ID de trabajo para darle seguimiento y un ID de motor que queda activo desde ese momento.
{
"jobId": "pjb_A1b2C3d4E5f6G7h8",
"engineId": "eng_X1y2Z3a4B5c6D7e8",
"status": "in_progress"
}| Campo | Descripción |
|---|---|
jobId | ID del trabajo de aprovisionamiento (prefijo pjb_). Dale seguimiento al trabajo conectando un WebSocket para ver el progreso en vivo, o recibe el resultado en tu webhook cuando termine. |
engineId | ID del nuevo motor (prefijo eng_). Se puede usar de inmediato: la configuración que la IA extrae se le aplica mientras se ejecuta el trabajo. |
status | in_progress cuando proporcionas fuentes; completed cuando no las proporcionas (ver abajo). |
El detalle que hace que esta llamada asíncrona valga la pena, en lugar de ponerse a esperar, es este: engineId vuelve en el mismo 202 y apunta de inmediato a un motor real. Puedes guardarlo, enviar una solicitud Localize sincrónica a través de él o integrarlo en tu app antes de que la IA haya terminado de leer una sola fuente. A medida que se extraen voces de marca, términos del glosario e instrucciones, la plataforma aplica cada uno a ese mismo motor: el motor existe antes que su configuración. Para saber exactamente qué creó el trabajo, consulta Lo que extrae la IA.
¿Sin fuentes? Obtienes un motor, no una espera.
Si omites sources, no hay nada que rastrear, así que el motor se crea con la configuración predeterminada del modelo y se devuelve con status: "completed" en la misma respuesta. Ese es el camino rápido cuando quieres un motor vacío para configurarlo tú mismo: una sola llamada, un engineId listo, sin trabajo en segundo plano al que haya que darle seguimiento.
