Localize

Translates a set of key-value pairs from one locale to another using a configured localization engine.

Request#

POST /process/localize

{
  "engineId": "eng_abc123",
  "sourceLocale": "en",
  "targetLocale": "de",
  "data": {
    "greeting": "Hello, world!",
    "cta": "Get started"
  }
}

Response#

Returns the same structure with translated values.

{
  "sourceLocale": "en",
  "targetLocale": "de",
  "data": {
    "greeting": "Hallo, Welt!",
    "cta": "Jetzt starten"
  }
}

Examples#

const response = await fetch(
  "https://api.lingo.dev/process/localize",
  {
    method: "POST",
    headers: {
      "X-API-Key": "your_api_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      engineId: "eng_abc123",
      sourceLocale: "en",
      targetLocale: "de",
      data: {
        greeting: "Hello, world!",
        cta: "Get started",
      },
    }),
  }
);

const { data } = await response.json();
// { greeting: "Hallo, Welt!", cta: "Jetzt starten" }

What happens during localization#

When a request hits the localize endpoint, the engine applies its full configuration:

1. Model selection - Selects the highest-priority LLM model matching the locale pair. Locale-specific models take precedence over wildcard (*) models. If the primary model fails, the engine falls through to the next ranked model automatically.

2. Brand voice - Loads the brand voice for the target locale (falls back to the wildcard brand voice if no locale-specific one exists).

3. Instructions - Loads all instructions matching the target locale, including wildcard instructions.

4. Glossary lookup - Splits input values into searchable chunks, generates embeddings, and performs a vector similarity search against the engine's glossary. Matched terms enforce exact translations or mark terms as non-translatable.

5. Generation - Sends the composed prompt to the selected model. Parses and validates the JSON response.

Next Steps#