Haz tu primera solicitud de traducción
Crea un trabajo con JSON integrado, inícialo y guarda el resultado en español con Node.js.
Traduce dos mensajes del inglés al español y guárdalos como es.json. Necesitas Node.js 22 o una versión posterior, una organización de Lingo.dev, un motor configurado con un modelo de traducción y una clave de API con acceso de traducción a ese motor.
Para esta primera solicitud, configura el motor para traducir sin revisión humana. Puedes agregar la revisión cuando el flujo de envío y descarga funcione.
Configura la solicitud #
Define estos valores en tu terminal con los ID de tu organización y tu motor. En Seleccionar la organización y el motor se explica cómo encontrarlos.
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 identifica este envío. Reutilízalo cuando vuelvas a intentar la misma solicitud. Elige un valor nuevo si cambian el contenido de origen, los idiomas u otras opciones de la solicitud.
Crea, inicia y descarga #
Guarda este programa como 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");Ejecútalo:
node translate.mjsAbre es.json y revisa save y cancel. Ambos deberían contener texto en español. La API almacena el JSON integrado durante la creación, pero aún debes realizar la solicitud /start por separado.
Recupera una solicitud interrumpida #
Si el programa se detiene después de la creación, lee el ID de translation-job.json y recupera el trabajo. Repetir la misma solicitud de creación con el mismo Idempotency-Key recupera el trabajo original. Repetir /start permite continuar el mismo trabajo en lugar de crear otro.
Cuando se agota el tiempo de espera del sondeo, el programa deja de esperar, pero no cancela el trabajo del servidor. Conserva el ID del trabajo y vuelve a consultar más tarde. Si falla un destino, revisa su mensaje y los resultados de las etapas antes de enviar una solicitud corregida con una clave nueva.
Después, traduce archivos, agrega indicaciones para JSON y controles de claves o integra el ciclo de vida en tu aplicación.