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 header 里带上 API key,格式是 Bearer:

Authorization: Bearer YOUR_KEY

API key 是 32 字节随机串,前缀 sk_imagetranslate_。当密码用就行 —— 放服务端的密钥库里,别提交到代码仓库,也别在前端代码里出现。

幂等性

网络超时后重试请求时,带上同一个 Idempotency-Key header,避免重复扣积分:

Idempotency-Key: <your-uuid>

• 第一次用某个 key 调用:正常处理。
• 同一个 key 再调一次(按 API key 隔离):返回 409 Conflict,带上原来的 recordId。这次重试不扣积分。
• 不同的 key 算不同的调用。

key 在客户端生成就行,UUIDv4 没问题。不带这个 header 的话,每次重试都会重新扣一次积分、重新调一次 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 →