文本翻译 API

POST /v2/translate

请求参数

• text (string[], 必填): 要翻译的文本。UTF-8 纯文本。每次请求最多 128 KiB。多次指定时会按序返回翻译。
• target_lang (string, 必填): 目标语言代码，如 "DE", "FR", "ZH"。
• source_lang (string, 可选): 源语言代码。省略时自动检测。
• context (string, 可选): 额外上下文信息，影响翻译但不翻译本身。不计费。
• split_sentences (enum): 句子分割方式 — 0(不分割), 1(标点+换行), nonewlines(仅标点)。
• preserve_formatting (boolean): 是否保留原始格式，默认 false。
• formality (enum): 语气风格 — default, more(正式), less(非正式), prefer_more, prefer_less。仅部分语言支持。
• model_type (enum): quality_optimized(质量优先), prefer_quality_optimized, latency_optimized(速度优先)。
• glossary_id (string): 单个术语表 ID。需同时设置 source_lang。不能与 glossary_ids 同时使用。
• glossary_ids (string[]): 最多 5 个术语表 ID。需同时设置 source_lang。
• style_id (string): 风格规则列表 ID。目标语言需匹配风格规则的语言。
• translation_memory_id (string): 翻译记忆库 ID (UUID 格式)。
• translation_memory_threshold (integer): 匹配阈值，默认 75，范围 0-100。
• custom_instructions (string[]): 最多 10 条自定义翻译指令，每条最多 300 字符。仅支持 DE, EN, ES, FR, IT, JA, KO, ZH。
• tag_handling (enum): XML 或 HTML 标签处理方式。
• outline_detection (boolean): 自动检测 XML 结构，默认 true。
• show_billed_characters (boolean): 设置为 true 时，响应中包含计费字符数。

请求示例

curl -X POST https://api.deepl.com/v2/translate \
  -H "Authorization: DeepL-Auth-Key YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": ["Hello, world!"],
    "target_lang": "ZH",
    "formality": "prefer_more",
    "glossary_ids": ["def3a26b-..."],
    "style_id": "7ff9bfd6-..."
  }'

响应格式

{
  "translations": [
    {
      "detected_source_language": "EN",
      "text": "你好，世界！",
      "billed_characters": 13
    }
  ]
}