translation · 2026-09-26

clavue-trans · OCR + 翻译 + Jev

专用翻译（NLLB-600M CTranslate2）。可选识图 OCR、译文 Jev 质检。仓库内详细说明见 clavue-trans/API.md。

访问 URL

场景Base URL鉴权
公网 / SDK（推荐）https://ttkk.inping.com/v1Authorization: Bearer sk-…
会员站https://api.clavue.com/v1会员 token
集群内网关http://192.168.2.100:11401/v1内网
集群内 REST 直连http://192.168.2.100:31424内网 · /v1/trans/*
K8s Servicehttp://clavue-trans.default.svc:8080Pod 内

公网请用 POST /v1/chat/completions + model: clavue-trans。/v1/trans/* 仅集群内 / NodePort 31424，ttkk 公网未反代该路径。

Model

公网 model别名端点（公网）
clavue-transclavue-translatePOST /v1/chat/completions

文本翻译 · OpenAI 兼容（ttkk / api.clavue.com）

curl -sS https://ttkk.inping.com/v1/chat/completions \
  -H "Authorization: Bearer $CLAVUE_KEY" -H 'Content-Type: application/json' \
  -d '{
    "model": "clavue-trans",
    "temperature": 0,
    "stream": false,
    "translation_options": {
      "source_lang": "zh",
      "target_lang": "en",
      "jev_check": false
    },
    "messages": [{"role": "user", "content": "你好，世界"}]
  }'

响应在 choices[0].message.content（JSON 字符串），含 translated_text、timings 等。

带图 · OCR + 翻译

curl -sS https://ttkk.inping.com/v1/chat/completions \
  -H "Authorization: Bearer $CLAVUE_KEY" -H 'Content-Type: application/json' \
  -d '{
    "model": "clavue-trans",
    "translation_options": {"source_lang":"zh","target_lang":"en","jev_check":true},
    "messages": [{
      "role": "user",
      "content": [
        {"type":"text","text":"识别并翻译图中文字"},
        {"type":"image_url","image_url":{"url":"data:image/png;base64,..."}}
      ]
    }]
  }'

REST 直连（集群内 · NodePort 31424）

curl -sS http://192.168.2.100:31424/v1/trans/translate \
  -H 'Content-Type: application/json' \
  -d '{
    "text": "你好，世界",
    "source_lang": "zh",
    "target_lang": "en",
    "jev_check": true
  }'

/v1/trans/pipeline 与 /v1/trans/translate 相同。顶层直接返回 JSON（非 chat 包装）。

translation_options / 请求体字段

字段默认说明
source_langzh源语言短码：zh / en / ja / ko / fr …
target_langen目标语言
jev_checkfalse译文 Jev 质检
text—REST 模式正文
image_url—REST 模式图片 URL 或 base64 data URI

语言短码（常用）

zh zh-tw en ja ko fr de es ru ar vi th · 完整列表见仓库 clavue-trans/serve/lang.py

限制