Отправьте первый запрос на перевод
Создайте задание со встроенным JSON, запустите его и сохраните результат на испанском с помощью Node.js.
Переведите два сообщения с английского на испанский и сохраните их в es.json. Вам понадобятся Node.js 22 или новее, организация Lingo.dev, движок с настроенной моделью перевода и ключ API с правом выполнять перевод в этом движке.
Для первого запроса настройте движок на перевод без ручной проверки. Вы сможете добавить проверку, когда отправка запроса и скачивание результата заработают.
Задайте параметры запроса #
Задайте эти значения в командной оболочке, указав ИД своей организации и движка. О том, где их найти, читайте в разделе «Выберите организацию и движок».
export LINGO_API_KEY="YOUR_API_KEY"
export LINGO_ORGANIZATION_ID="YOUR_ORGANIZATION_ID"
export LINGO_ENGINE_ID="YOUR_ENGINE_ID"
export LINGO_REQUEST_ID="welcome-messages-v1-es"LINGO_REQUEST_ID — идентификатор этого запроса. Используйте то же значение при повторной попытке отправить тот же запрос. Выберите новое значение, если изменились исходный текст, локали или другие параметры запроса.
Создайте, запустите и скачайте #
Сохраните эту программу в файле translate.mjs:
import { writeFile } from "node:fs/promises";
import { setTimeout as delay } from "node:timers/promises";
const origin = "https://api.lingo.dev";
const {
LINGO_API_KEY: apiKey,
LINGO_ORGANIZATION_ID: orgId,
LINGO_ENGINE_ID: engineId,
LINGO_REQUEST_ID: requestId,
} = process.env;
if (!apiKey || !orgId || !engineId || !requestId) {
throw new Error("Set LINGO_API_KEY, LINGO_ORGANIZATION_ID, LINGO_ENGINE_ID, and LINGO_REQUEST_ID");
}
async function request(path, options = {}) {
const response = await fetch(new URL(path, origin), {
...options,
headers: { "X-API-Key": apiKey, ...options.headers },
signal: AbortSignal.timeout(30_000),
});
if (!response.ok) {
throw new Error(`HTTP ${response.status}: ${await response.text()}`);
}
return response;
}
let job = await (
await request(`/v2/organizations/${encodeURIComponent(orgId)}/localization/jobs`, {
method: "POST",
headers: { "Content-Type": "application/json", "Idempotency-Key": requestId },
body: JSON.stringify({
engineId,
sourceLocale: "en",
targetLocales: ["es"],
documents: [
{
key: "messages.json",
format: { type: "json", options: { context: "Account settings buttons" } },
source: { content: { save: "Save changes", cancel: "Cancel" } },
},
],
}),
})
).json();
await writeFile("translation-job.json", JSON.stringify({ id: job.id, requestId }, null, 2));
console.log(`Created ${job.id}; saved its ID to translation-job.json`);
if (job.uploads.length !== 0) throw new Error("Upload the artifacts listed in job.uploads before starting");
job = await (
await request(`/v2/localization/jobs/${encodeURIComponent(job.id)}/start`, {
method: "POST",
})
).json();
const deadline = Date.now() + 120_000;
while (["Pending", "Running"].includes(job.status._tag)) {
if (Date.now() >= deadline) {
throw new Error(`Still waiting for ${job.id}. Keep its ID and retrieve it again later.`);
}
await delay(2000);
job = await (await request(`/v2/localization/jobs/${encodeURIComponent(job.id)}`)).json();
}
const target = job.documents
.find((document) => document.key === "messages.json")
?.targets.find((item) => item.locale === "es");
if (target?.status._tag !== "Completed") {
throw new Error(`Translation did not complete: ${JSON.stringify(job.status)}`);
}
const translated = await (await request(target.status.downloadUrl)).json();
await writeFile("es.json", JSON.stringify(translated, null, 2) + "\n");
console.log("Saved es.json");Запустите её:
node translate.mjsОткройте es.json и проверьте save и cancel. Оба значения должны содержать текст на испанском. API сохраняет встроенный JSON при создании задания, но отдельный запрос /start всё равно нужен.
Возобновите прерванный запрос #
Если программа остановится после создания задания, возьмите ИД из translation-job.json и получите задание. Повторный запрос на создание с тем же Idempotency-Key возвращает исходное задание. Повторный вызов /start продолжает то же задание, а не создаёт новое.
Когда время ожидания при опросе истекает, программа перестаёт ждать, но сервер продолжает работу. Сохраните ИД задания и проверьте его позже. Если перевод для целевой локали завершился с ошибкой, изучите сообщение и результаты этапов, прежде чем отправлять исправленный запрос с новым ключом.
Далее вы можете перевести файлы, добавить подсказки JSON и настройки обработки ключей или встроить жизненный цикл задания в своё приложение.