即时翻译

短文本翻译

POST /api/v1/ai/translate-snippet

{
  "text": "Hello world",
  "source_lang": "auto",
  "target_lang": "zh",
  "engine": "xr-397b"
}

text 为 1–5000 个字符。target_lang 与 source_lang（auto 除外）须为支持的语言代码，否则返回 422。响应：

{ "translated_text": "你好，世界", "source_lang": "auto", "target_lang": "zh" }

批量片段翻译

POST /api/v1/ai/translate-batch

{
  "segments": [
    { "id": "p1", "text": "First paragraph." },
    { "id": "p2", "text": "Second paragraph." }
  ],
  "target_lang": "zh"
}

• segments 为 1–64 段，每段不超过 4000 个字符，id 在请求内唯一。
• 响应按请求顺序返回 segments: [{ "id", "translated_text" }]。
• 只含空白的片段原样返回，不计费。

约定

• 请求体上限 2 MB，单次请求最长 180 秒，客户端超时请不少于 180 秒。
• 建议携带 Idempotency-Key。网络中断或超时后，用同一个键和相同请求体重试，不会重复扣费。
• engine 不可用时返回 400；Key 设置了允许的配置且不包含所选配置时返回 403。
• 按实际处理的原文用量结算。

已下线的接口

POST /api/v1/ai/notes、/ai/chat、/ai/generate、/ai/ocr 已下线，返回 410。图片翻译请上传图片后创建翻译任务。