API 文件

翻譯圖片內的文字,保留原版面,並重新繪製回圖片上。

快速開始

curl -X POST https://api.imagetranslate.ai/translate/image \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "imageBase64": "iVBORw0KGgoAAAANSUhEUgAA...",
    "sourceLanguage": "ja",
    "targetLanguage": "en",
    "mode": "general",
    "translator": "Grok"
  }'

身分驗證

每個請求的 Authorization 標頭都要帶上 Bearer Token 格式的 API key:

Authorization: Bearer YOUR_KEY

API key 是帶 sk_imagetranslate_ 前綴的 32 位元組隨機字串,請當成密碼來保管 —— 放在伺服器端的金鑰管理服務,不要 commit 進程式碼倉庫,也不要寫進前端程式碼。

冪等性

連線逾時想重送請求時,請帶上同一個 Idempotency-Key 標頭,避免被重複扣點:

Idempotency-Key: <your-uuid>

• 第一次帶某個 key 呼叫:正常處理。
• 同一把 API key 再用同一個 key 呼叫:回傳 409 Conflict 與原本的 recordId,重試不會扣點。
• key 不同就視為不同呼叫。

請在客戶端產生這個 key(UUIDv4 即可)。沒帶的話,每次重試都會重新扣一次點數,Torii 也會被重複呼叫。

翻譯圖片

同步端點。回傳 base64 編碼(帶 data:image/png;base64, 前綴)的翻譯結果圖片。

Base URL

https://api.imagetranslate.ai

請求內容

回應

範例

curl -X POST https://api.imagetranslate.ai/translate/image \
  -H "Authorization: Bearer $IMAGETRANSLATE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "imageBase64": "YOUR_BASE64_IMAGE",
    "sourceLanguage": "ja",
    "targetLanguage": "en",
    "mode": "general",
    "translator": "Grok"
  }'

回應範例

{
  "success": true,
  "recordId": "Z3l4abc...",
  "resultImage": "data:image/png;base64,iVBORw0KGgoAAAANSU...",
  "remainingCredit": 9990
}

錯誤碼

錯誤回應格式

• 4xx / 500: { "detail": "<message>" }
• 422: { "detail": [{ "loc": [...], "msg": "...", "type": "..." }] }
• 409: { "error": "idempotency_replay", "recordId": "<id>", "message": "..." }

速率限制

每個 API key 以分鐘為單位限速,各方案上限不同:

需要更高上限,歡迎來信 [email protected]。

計費

每次呼叫扣 10 點高級點數。各方案與點數包詳情請見計費頁面。

附錄

語言代碼

sourceLanguage 用 ISO 639-1 / BCP-47 代碼,或填 auto 讓系統自動辨識。 targetLanguage 用同一套代碼,但不支援 auto。

常用代碼:

mode 值

mode 決定渲染風格,挑一個最貼近圖片內容的即可:

translator 模型

translator 決定用哪個 AI 模型翻譯,每個模型都是一次 10 點。

• Grok (預設)
• Gemini
• Deepseek
• ChatGPT
• Claude

開始整合

準備好整合了?建立第一個 API key →