Translate content

Translate text, HTML, or structured JSON. Provide exactly one of text, html, or content. Translation memory is checked first (free), then glossary terms are enforced, and remaining strings are translated via LLM (metered by source word count).

Authorization

apiKey

x-api-key<token>

API key from the LangRelay dashboard. Org-level keys can access all projects; project-scoped keys are restricted to one project.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

projectId*string

Project ID to translate for

targetLanguage*string

Target language code (ISO 639-1)

sourceLanguage?string

Source language code. Optional — auto-detected from project settings.

glossaryId?string

Optional glossary ID to enforce terminology

text?|array<>

Plain text string or array of strings (max 100)

html?string

HTML string — structure is preserved, text nodes are translated

content?

Structured JSON — same shape in, same shape out. All string values are translated, non-strings pass through.

translateKeys?array<>

Override default skip keys (id, url, href, src, email, slug) — force these keys to be translated

Response Body

`application/json`

curl -X POST "https://api.langrelay.com/v1/translate" \  -H "Content-Type: application/json" \  -d '{    "projectId": "proj_abc123",    "text": "Hello world",    "targetLanguage": "fr"  }'

{
  "sourceText": "string",
  "translatedText": "string",
  "language": "string"
}

{
  "type": "https://api.langrelay.com/errors/bad-request",
  "title": "Bad Request",
  "status": 400,
  "detail": "projectId and language query parameters are required."
}

{
  "type": "https://api.langrelay.com/errors/bad-request",
  "title": "Bad Request",
  "status": 400,
  "detail": "projectId and language query parameters are required."
}

{
  "type": "https://api.langrelay.com/errors/bad-request",
  "title": "Bad Request",
  "status": 400,
  "detail": "projectId and language query parameters are required."
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`