Criar uma tarefa de aprovisionamento

Submeta as fontes que já tem e receba um motor de volta. POST /jobs/provisioning aceita um nome para um novo motor e até 10 fontes — links para rastrear ou texto simples — e devolve 202 Accepted com o ID do motor. Não tem de esperar que a IA acabe de ler o seu conteúdo: o motor existe no momento em que a chamada devolve, e a respetiva configuração é aplicada à medida que a tarefa decorre.

POST /jobs/provisioning

Esta página cobre a chamada de criação: os parâmetros, o formato do pedido e a resposta 202. É novo no aprovisionamento assíncrono? Comece pela Visão geral da API de Aprovisionamento Assíncrono para perceber o modelo. O que conta como uma boa fonte tem página própria — Tipos de fonte — e o que a IA extrai dessas fontes está em O que a IA extrai.

Parâmetros#

Só engine.name é obrigatório. Tudo o resto molda o que o motor aprende — ou, se omitir tudo, fica com um motor limpo com as predefinições.

Pedido#

Uma fonte é um objeto { type, payload }. Aponte as fontes link para páginas com contexto real — diretrizes da marca, guias de estilo, documentação do produto — e use content para regras de terminologia e tom que pode colar diretamente. O pedido abaixo combina ambos: duas páginas para rastrear e um bloco de regras 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 now

Resposta (202 Accepted)#

A chamada devolve sem esperar pelo rastreio nem pela análise — entrega-lhe um ID de tarefa para acompanhar e um ID de motor que fica ativo a partir desse momento.

{
  "jobId": "pjb_A1b2C3d4E5f6G7h8",
  "engineId": "eng_X1y2Z3a4B5c6D7e8",
  "status": "in_progress"
}

O detalhe que faz desta uma chamada assíncrona que vale a pena, em vez de ficar à espera: engineId volta no mesmo 202 e aponta desde logo para um motor real. Pode guardá-lo, enviar um pedido Localize síncrono através dele ou integrá-lo na sua aplicação antes de a IA ter acabado de ler uma única fonte. À medida que as vozes da marca, os itens do glossário e as instruções vão sendo extraídos, a plataforma aplica cada um deles a esse mesmo motor — o motor existe antes de a configuração estar concluída. Para saber exatamente o que a tarefa criou, leia O que a IA extrai.

Próximos passos#