Estás poniendo en marcha un motor de localización. El motor que traduce bien no es el vacío, sino el que incorpora tu voz de marca, tu glosario y tus instrucciones, para que cada traducción suene como tu producto y nunca desvirtúe un término que ya tienes decidido.
Ese conocimiento suele existir antes que el propio motor. Está en una página de directrices de marca, una guía de estilo, una hoja terminológica o unos párrafos de reglas que en su día se entregaron a un traductor. Crear el motor a mano implica leer todo eso y volver a introducirlo como registros de voz de marca, glosario e instrucciones, uno a uno: un trabajo tedioso, fácil de empezar y fácil de dejar a medias.
La API de aprovisionamiento asíncrono cierra esa brecha: apúntala a lo que ya tienes. Envías en una sola solicitud enlaces y texto sin procesar mediante POST, recibes al instante un ID de motor y un agente de IA rastrea las fuentes, extrae voces de marca, términos del glosario e instrucciones, y aplica cada elemento al nuevo motor a medida que lo encuentra. El motor se puede usar desde el momento en que recibes el ID: la configuración se va completando mientras se ejecuta el trabajo.
En esta página
El problema#
Un motor de localización es tan bueno como su configuración. Elegir el modelo te da una traducción; las voces de marca, los términos del glosario y las instrucciones son lo que hace que esa traducción encaje con la forma en que ya habla tu producto: el grado de formalidad que has elegido, los nombres de producto que nunca traduces, el formato de fecha que siempre usas. Esos son los mismos elementos que, de otro modo, crearías a mano: voces de marca, términos del glosario e instrucciones en un motor.
El problema es que todo eso ya existe en algún sitio. Un equipo que ha lanzado un producto en un idioma tiene una página de directrices de marca, una guía de estilo y un glosario de términos que se indica a los agentes de soporte que no traduzcan nunca. Para configurar el motor a mano, lees esos documentos y los transcribes a registros, decisión por decisión, idioma por idioma. Es lento, y la parte más lenta es la menos interesante: copiar a otro formato un conocimiento que ya está escrito.
El aprovisionamiento elimina ese paso. Le entregas a la plataforma los propios documentos, ya sea como URL para rastrear o como texto sin procesar, y un agente de IA se encarga de leerlos y transcribirlos. Crea por ti los registros de voz de marca, glosario e instrucciones en un motor real, aplicando cada uno en cuanto lo identifica. Después los revisas y ajustas en el panel, igual que editarías cualquier cosa que hubieras creado tú mismo. El punto de partida es un motor configurado, no uno en blanco.
El aprovisionamiento configura un motor; no traduce.
Esta API crea y configura el motor. Para traducir con el motor una vez exista, usa la API de localización asíncrona para muchos idiomas a la vez, o el endpoint Localize síncrono para un solo par de idiomas. El aprovisionamiento es el paso de configuración que hace que esas llamadas lleven tu voz de marca y tu glosario desde la primera traducción.
Cómo funciona#
Son tres pasos, y solo el primero ocurre dentro de tu solicitud. Los otros dos se ejecutan en la plataforma, a su ritmo; por eso la llamada devuelve el resultado enseguida y el motor se puede usar antes de que termine el trabajo.
Envía tus fuentes
Haz un POST a /jobs/provisioning con un nombre para el nuevo motor y un array de fuentes: URL para rastrear, texto sin procesar para analizar, o ambos. La API crea el motor de inmediato y devuelve 202 con el ID del motor (eng_) y el ID del trabajo (pjb_). Tu aplicación puede seguir adelante; nada de la respuesta espera a la extracción. Consulta Crear un trabajo de aprovisionamiento para ver la estructura completa de la solicitud y la respuesta, y Tipos de fuentes para saber qué hace que merezca la pena enviar una fuente.
El agente de IA rastrea y extrae
Las fuentes enlazadas se rastrean en paralelo y se convierten en texto; el contenido sin procesar se lee directamente. Después, un agente de IA lo analiza todo y extrae tres tipos de configuración: voces de marca, términos del glosario e instrucciones, aplicando cada uno al motor en cuanto lo identifica. Una fuente que no pueda rastrearse, o un elemento concreto que no pueda crearse, no detiene el resto. Qué extrae la IA explica estos tres componentes y cómo se asignan a los idiomas.
El motor está listo
Cuando termina la extracción, el motor está completamente configurado y listo para traducir a través de la API de localización. La plataforma informa de la finalización, con un resumen de todo lo que se ha creado, a tu URL de webhook, o en directo mediante el WebSocket del trabajo si quieres mostrar el progreso mientras se ejecuta.
El ID del motor se puede usar inmediatamente.
El ID eng_ de 202 corresponde a un motor real en el mismo instante en que lo recibes. Puedes guardarlo, referenciarlo y traducir con él de inmediato: la configuración se aplica mientras se ejecuta el trabajo, así que una traducción hecha pronto verá menos registros extraídos que una hecha después de que el trabajo termine. No tienes que esperar a que termine el aprovisionamiento para empezar a usar el motor.
Autenticación
Todas las solicitudes, REST y WebSocket, se autentican con tu cabecera X-API-Key. Las claves tienen alcance de organización y dan acceso a todos los motores de la organización. Consulta Autenticación para ver los detalles y Claves de API para crear una.
Qué recibes#
Quien lea esto con escepticismo ya se está haciendo las dos preguntas que determinan si es seguro depender de ello: ¿qué pasa si una fuente es mala? ¿Y esto es una caja negra que no puedo corregir?
Ninguna de las dos respuestas está oculta. El aprovisionamiento no devuelve un blob propietario: crea registros normales de voz de marca, glosario e instrucciones en un motor real, exactamente los mismos objetos que crearías a mano, y todos se pueden editar después en el panel. Cuando termina el trabajo, devuelve un resumen que identifica cada registro que ha creado y cada fallo que ha encontrado, para que puedas confirmar la configuración en lugar de darla por supuesta. Qué extrae la IA explica ese resumen y cómo un elemento fallido se aísla en una lista errors mientras el resto del motor sigue configurándose.
Las fuentes también son opcionales. Envía un nombre sin sources y obtendrás un motor limpio con la configuración predeterminada para configurarlo tú mismo; Crear un trabajo de aprovisionamiento cubre esa ruta junto con la estructura de la respuesta 202. El aprovisionamiento es la forma de saltarte la configuración manual, no un requisito previo para tener un motor.
Las páginas genéricas producen una configuración genérica.
La configuración solo será tan buena como lo que envíes: las directrices de marca y las listas terminológicas le dan al agente algo concreto que extraer; una página de inicio de marketing apenas aporta nada. Tipos de fuentes explica a qué debes apuntarlo.
Ese es el intercambio que propone el aprovisionamiento: inviertes una solicitud y una breve espera y, a cambio, te ahorras transcribir un conocimiento que ya habías puesto por escrito. Apúntalo a lo que ya tienes y empieza con un motor configurado. Las páginas siguientes desarrollan esa idea.
