# General Translation Platform: 在 Runtime 翻译内容
URL: https://generaltranslation.com/zh/docs/platform/openapi/reference/translation/translate-runtime.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 通过缓存和记忆化翻译一个或多个字符串、结构化内容条目或 markdown 文档。Markdown 和 MDX 文档以字符串形式发送，并将 fileFormat 设置为 MD 或 MDX。接受开发密钥。在 Runtime 翻译内容的 API 参考。

{/* 此文件由 Fumadocs 生成。请勿直接编辑此文件。如需更改，请重新运行生成命令。 */}

## Endpoint

`POST https://api.gtx.dev/v2/translate`

**Operation ID:** `translate`

**Tags:** `Translation`

**Summary:** Translate content at runtime

Translate one or more strings, structured content entries, or markdown documents with caching and memoization. Markdown and MDX documents are sent as strings with `fileFormat` set to MD or MDX. Development API keys are accepted for this endpoint.

Authentication: required. Send an API key in the `Authorization: Bearer <key>` header when authenticating.

### Parameters

- `gt-api-version` (header, "2025-01-01.v0" | "2025-11-03.v1" | "2026-02-18.v1" | "2026-03-06.v1", optional): API contract version. Defaults to the oldest supported version.
- `gt-project-id` (header, string, optional): Target project ID when no project ID is present in the path. Project API keys default to their bound project. If supplied, the header must match both the path target and the key’s bound project.

### Request body (required)

Body (`application/json`, object):
- `requests` (object, required)
  - `<key>` (object, dynamic key)
    - `source` (object)
    - `metadata` (object) Default: `{"dataFormat":"STRING","actionType":"fast"}`.
      - `id` (string)
      - `hash` (string)
      - `context` (string)
      - `maxChars` (number)
      - `dataFormat` ("JSX" | "ICU" | "I18NEXT" | "STRING")
      - `fileFormat` ("MD" | "MDX")
      - `actionType` ("fast" | "standard") Default: `"fast"`.
      - `sourceCode` (object)
        - `<key>` (object[], dynamic key)
- `targetLocale` (string, required)
- `sourceLocale` (string, required)
- `metadata` (object, required)
  - `modelProvider` ("ANTHROPIC" | "OPENAI" | "XAI" | "GOOGLE")

### Responses

**200**: All translations were served from cache
Response body (`application/json`, object):
- `<key>` (object | object, dynamic key)

**201**: Translations completed
Response body (`application/json`, object):
- `<key>` (object | object, dynamic key)

**400**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**401**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**402**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**403**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**404**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**413**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**429**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**500**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

Complete OpenAPI 3.1 specification: https://generaltranslation.com/openapi.yaml

OpenAPI schema: [openapi.json](https://generaltranslation.com/openapi.json)

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.