Deine erste Übersetzungsanfrage stellen
Erstelle einen Job mit Inline-JSON, starte ihn und speichere das spanische Ergebnis mit Node.js.
Übersetze zwei englische Nachrichten ins Spanische und speichere sie als es.json. Dafür brauchst du Node.js 22 oder neuer, eine Lingo.dev-Organisation, eine Engine mit einem konfigurierten Übersetzungsmodell und einen API-Schlüssel mit Übersetzungszugriff auf diese Engine.
Konfiguriere die Engine für diese erste Anfrage so, dass sie die Übersetzung ohne menschliche Prüfung ausführt. Du kannst die Prüfung hinzufügen, sobald der Ablauf zum Einreichen und Herunterladen funktioniert.
Anfrage konfigurieren #
Setze diese Werte in deiner Shell und verwende dabei deine eigenen Organisations- und Engine-IDs. Unter Organisation und Engine auswählen erfährst du, wo du sie findest.
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 kennzeichnet diese Einreichung. Verwende denselben Wert, wenn du dieselbe Anfrage erneut sendest. Wähle einen neuen Wert, wenn sich der Ausgangstext, die Sprachen oder andere Anfrageoptionen ändern.
Erstellen, starten und herunterladen #
Speichere dieses Programm als 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");Führe es aus:
node translate.mjsÖffne es.json und sieh dir save und cancel an. Beide sollten spanischen Text enthalten. Die API speichert das Inline-JSON beim Erstellen, aber die separate /start-Anfrage ist weiterhin erforderlich.
Eine unterbrochene Anfrage fortsetzen #
Wenn das Programm nach dem Erstellen stoppt, lies die ID aus translation-job.json aus und rufe den Job ab. Wenn du dieselbe Erstellungsanfrage mit demselben Idempotency-Key erneut sendest, wird der ursprüngliche Job abgerufen. Wenn du /start wiederholst, wird derselbe Job fortgesetzt, statt ein neuer erstellt.
Eine Zeitüberschreitung beim Polling beendet nur das Warten dieses Programms; die Verarbeitung auf dem Server läuft weiter. Bewahre die Job-ID auf und rufe den Status später erneut ab. Wenn die Verarbeitung für ein Ziel fehlgeschlagen ist, sieh dir die zugehörige Meldung und die Ergebnisse der einzelnen Phasen an, bevor du eine korrigierte Anfrage mit einem neuen Schlüssel einreichst.
Als Nächstes kannst du Dateien übersetzen, JSON-Hinweise und Steuerungsoptionen für Schlüssel hinzufügen oder den Lebenszyklus in deine Anwendung integrieren.