Создать задание развёртывания

Передайте источники, которые у вас уже есть, — и сразу получите движок. POST /jobs/provisioning принимает имя нового движка и до 10 источников — ссылки для обхода или сырой текст — и возвращает 202 Accepted с ID движка. Ждать, пока ИИ дочитает ваш контент, не нужно: движок появляется сразу, как только приходит ответ, а его конфигурация применяется по мере выполнения задания.

POST /jobs/provisioning

На этой странице разобран вызов создания: параметры, формат запроса и ответ 202. Впервые работаете с асинхронным развёртыванием? Начните с обзора Async Provisioning API, чтобы понять общую логику. О том, что считается хорошим источником, читайте на отдельной странице — Типы источников. А что именно ИИ из них извлекает, описано в Что извлекает ИИ.

Параметры#

Обязателен только engine.name. Всё остальное определяет, чему будет учиться движок. А если не передавать больше ничего, вы получите чистый движок с настройками по умолчанию.

Запрос#

Источник — это объект { type, payload }. Для источников link указывайте страницы с реальным контекстом — гайдлайны бренда, стилистические руководства, продуктовую документацию. А content используйте для терминологии и правил тональности, которые можно сразу вставить в запрос. В примере ниже сочетаются оба варианта: две страницы для обхода и один блок явных правил.

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

Ответ (202 Accepted)#

Вызов возвращается без ожидания завершения обхода и анализа: вы сразу получаете ID задания для отслеживания и ID движка, который уже можно использовать.

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

Именно это делает асинхронный вызов действительно полезным, а не просто долгим ожиданием: engineId возвращается в том же ответе 202 и сразу указывает на реальный движок. Вы можете сохранить его, отправить через него Синхронный запрос Localize или встроить в приложение ещё до того, как ИИ успеет дочитать хотя бы один источник. По мере того как платформа извлекает тональность бренда, элементы глоссария и инструкции, она применяет их к тому же самому движку — движок существует ещё до появления его конфигурации. Чтобы точно понимать, что создало это задание, см. Что извлекает ИИ.

Что дальше#