即時翻譯
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" }批量片段翻譯
Section titled “批量片段翻譯”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。- 按實際處理的原文用量結算。
圖片文字識別
Section titled “圖片文字識別”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為兼容舊版擴展保留,不會影響結果。 - 需要直接得到譯好的圖片時,上傳圖片後創建翻譯任務。
已下線的介面
Section titled “已下線的介面”POST /api/v1/ai/notes、/ai/chat、/ai/generate 已下線,返回 410。