Haz tu primera solicitud de traducción
Crea un trabajo con JSON en línea, ponlo en marcha 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 para traducir con ese motor.
Para esta primera solicitud, configura el motor para traducir sin revisión humana. Puedes añadir la revisión cuando el flujo de envío y descarga funcione.
Configura la solicitud #
Define estos valores en tu terminal con los identificadores de tu organización y tu motor. En Selecciona 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 al reintentar 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 comprueba save y cancel. Ambos deberían contener texto en español. La API almacena el JSON en línea al crear el trabajo, pero sigue siendo necesario realizar la solicitud independiente /start.
Recupera una solicitud interrumpida #
Si el programa se detiene después de crear el trabajo, lee el identificador en translation-job.json y recupera el trabajo. Al repetir la misma solicitud de creación con el mismo Idempotency-Key, se recupera el trabajo original. Al repetir /start, se continúa el mismo trabajo en lugar de crear otro.
Si se agota el tiempo de espera de las consultas periódicas, el programa deja de esperar, pero el servidor sigue trabajando. Conserva el identificador 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.
A continuación, traduce archivos, añade indicaciones para JSON y controles de claves o integra el ciclo de vida en tu aplicación.