HY 翻译

原文

按行批量

0 字符 / 0 条每次翻译输入上限为500字符

译文

译文会显示在这里。

0 字符

准备就绪。

回车翻译，Command+回车换行

对接信息

接口概览

Base URL	`$BASE_URL`
鉴权	`Authorization: Bearer <API_KEY>`
推荐接口	`POST /language/translate/v2`
支持语种	`GET /language/translate/v2/languages`
OpenAI 兼容	`POST /v1/chat/completions`
限制	每条输入上限为 500 字符，每批最多 128 条。这些是服务端限制，接入方请求不能修改。

V2 参数

字段	类型	必填	说明
`q`	string 或 string[]	是	待翻译文本；数组会按顺序批量返回。
`source`	string	否	源语言，支持 `auto`。
`target`	string	是	目标语言代码，不支持 `auto`。
`format`	string	否	固定使用 `text`。

V2 请求示例

curl -X POST "$BASE_URL/language/translate/v2" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API_KEY>" \
  -d '{
    "q": "今天的天气很好",
    "source": "auto",
    "target": "en",
    "format": "text"
  }'

批量请求示例

curl -X POST "$BASE_URL/language/translate/v2" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API_KEY>" \
  -d '{
    "q": ["保存成功", "网络连接失败", "订单已取消"],
    "source": "auto",
    "target": "en",
    "format": "text"
  }'

支持语种示例

curl "$BASE_URL/language/translate/v2/languages?target=zh-CN" \
  -H "Authorization: Bearer <API_KEY>"

{
  "data": {
    "languages": [
      {"language": "en", "name": "英语"},
      {"language": "vi", "name": "越南语"},
      {"language": "zh-CN", "name": "简体中文"}
    ]
  }
}

当前返回 HY-MT1.5-1.8B 官方支持的 38 个语言或变体。target 可选，用于指定语言名称的显示语言。省略时每项只返回 language 代码；target 不支持 auto。官方调用使用 GET，同时兼容 TranslatePress 使用 POST 表单并在 body 中携带 key。

语言检测示例

curl -X POST "$BASE_URL/language/translate/v2/detect" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API_KEY>" \
  -d '{"q": ["Hello world", "Xin chào"]}'

{
  "data": {
    "detections": [
      [{"language": "en", "isReliable": false, "confidence": 0.0}],
      [{"language": "vi", "isReliable": false, "confidence": 0.0}]
    ]
  }
}

OpenAI 请求示例

curl -X POST "$BASE_URL/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API_KEY>" \
  -d '{
    "model": "/workspace/HY-MT1.5-1.8B",
    "messages": [
      {
        "role": "user",
        "content": "Translate to English: 我们可以去玩吗"
      }
    ],
    "temperature": 0,
    "max_tokens": 128
  }'

响应与错误

V2 接口译文位于 data.translations[].translatedText，模型名称位于 data.model。独立语言检测使用 POST /language/translate/v2/detect；isReliable 和 confidence 是 Google 已废弃的兼容字段。不支持的语言代码会返回 400；超过长度限制会返回 400，并说明超出的条目序号。

逐条结果