跳到內容

即時翻譯

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 在請求內唯一(1–64 個字符)。超過段數或單段長度回傳 413。
  • 回應按請求順序返回 segments: [{ "id", "translated_text" }]。
  • 僅含空白的片段原樣返回,不計費。
  • 請求體上限 2 MB,單次請求最長 180 秒,客戶端超時時間請設定為不少於 180 秒。
  • 建議攜帶 Idempotency-Key。網路中斷或超時後,用同一個鍵和相同請求體重試,不會重複扣費。
  • engine 不可用時返回 400;當 Key 設定了允許的配置且不包含所選配置時,返回 403。
  • 按實際處理的原文用量結算。
POST /api/v1/ai/ocr

使用 multipart/form-data 的 file 欄位上傳圖片(PNG、JPEG、WebP、BMP、GIF,不超過 12 MB、2500 萬像素),也可以直接將圖片作為請求體。返回按行切分的文字和像素座標:

{
"width": 640,
"height": 240,
"engine": "omnidoc-ocr",
"blocks": [
{ "text": "编号 INV-20261029-0042", "confidence": 0.97, "x": 23, "y": 76, "w": 366, "h": 33 }
]
}
  • x、y 是文字行左上角,座標以上傳的圖片為準(帶方向資訊的 JPEG 按擺正後的方向)。
  • 每行一個框,confidence 是這一列的識別置信度(0–1)。未識別到文字時返回 200 和空的 blocks。
  • 圖片文字識別不扣積分。寬或高不足 11 像素的圖片直接回傳空結果。
  • 識別服務暫時不可用時回傳 503,逾時回傳 504,detail 中有中文說明,可以稍後重試。
  • 網頁翻譯擴充功能的登入(omnidoc.translate.use)、API Key 和網頁登入都可以調用。
  • 查詢參數 engine、scene、lang 為兼容舊版擴展保留,不會影響結果。
  • 需要直接得到譯好的圖片時,上傳圖片後創建翻譯任務。

POST /api/v1/ai/notes、/ai/chat、/ai/generate 已下線,返回 410。