API 文档

https://api.imagetranslate.cn

鉴权

Header

Authorization: Bearer <API_KEY>
# 或
X-API-Key: <API_KEY>

专业版 / 旗舰版（≥ ¥99）开通 · POST /api/web/apikey 创建 Key

响应格式

Envelope（统一外层）

// 成功 HTTP 200
{
  "success": true,
  "code": 0,
  "message": "成功",
  "data": { },
  "requestId": "<request_id>",
  "timestamp": 0
}

// 失败
{
  "success": false,
  "code": 40100,
  "message": "<error_message>",
  "requestId": "<request_id>",
  "timestamp": 0
}

成功统一 HTTP 200；业务是否成功看 code === 0。详情一律放在 data.metadata

数据结构

请求 · 图片翻译 URL（JSON）

Request

{
  "imageUrl": "https://example.com/sample.jpg",
  "from": "auto",
  "to": "en",
  "model": "deepseek",
  "font": "noto",
  "textAlign": "auto",
  "strokeDisabled": false,
  "minFontSize": 6,
  "bubblesOnly": false,
  "customPrompt": "",
  "context": "",
  "renderImage": true
}

请求 · multipart（翻译上传）

multipart/form-data

file=@./sample.jpg
from=auto
to=zh-cn
model=deepseek
font=noto
textAlign=auto
strokeDisabled=false
minFontSize=6
bubblesOnly=false
customPrompt=
context=

响应 · data（任务）

data: Task

{
  "taskId": "<task_id>",
  "status": "success",
  "resultUrl": "https://cdn.example.com/<object_id>",
  "creditsConsumed": 0,
  "failureReason": null,
  "metadata": {
    "taskNo": "<task_no>",
    "taskType": "translate",
    "model": "<model>",
    "sourceLanguage": "auto",
    "targetLanguage": "en",
    "inputUrl": "https://cdn.example.com/<object_id>",
    "durationMs": 0,
    "async": false,
    "createdAt": "<iso8601>",
    "updatedAt": "<iso8601>"
  }
}

响应 · data（积分）

data: Credits

{
  "credits": 0,
  "availableCredits": 0,
  "apiAccessEnabled": false,
  "metadata": {
    "totalRecharged": 0,
    "totalConsumed": 0
  }
}

响应 · data（创建 Key，完整 key 仅出现一次）

data: ApiKey

{
  "id": "<key_id>",
  "name": "default",
  "prefix": "it_****",
  "enabled": true,
  "key": "<API_KEY>",
  "metadata": {
    "requestCount": 0,
    "lastUsedAt": null,
    "expiresAt": null,
    "createdAt": "<iso8601>"
  }
}

接口

GET/v1/languages支持的语言列表
GET/v1/options排版与模型选项
POST/v1/images/translations图片翻译 · URL
POST/v1/images/translations/upload图片翻译 · 上传
GET/v1/tasks/{taskId}查询任务
POST/v1/watermark-removals去水印
GET/v1/credits积分余额
POST/api/web/apikey创建 Key（登录后）
GET/api/web/apikeyKey 列表（登录后）

翻译参数

适用于 POST /v1/images/translations 与 POST /v1/images/translations/upload。JSON 与 multipart 字段名均为驼峰（除 from / to）。

参数	类型	必填	说明
imageUrl	string (URL)	URL 接口必填	公网可访问的原图地址（仅 JSON 接口）
file	file	upload 接口必填	图片文件，multipart 字段名 file；JPEG/PNG/WebP，建议 ≤ 10MB
from	string	否	源语言代码，默认 "auto"。也可用 JSON 字段 from_lang
to	string	是	目标语言代码，见下方「支持语言」表。JSON 也可用 targetLang
model	string	否	产品模型 key，如 deepseek / google / kimi / openai 等；缺省走默认线路
font	string	否	排版字体，默认 "noto"。可选值见「排版选项」
textAlign	string	否	文本对齐：auto \| left \| center \| right，默认 "auto"
strokeDisabled	boolean / string	否	是否关闭文字描边；JSON 用 boolean，multipart 可用 true/false
minFontSize	integer	否	最小字号，范围 6–100，默认 6
bubblesOnly	boolean / string	否	仅翻译气泡/对话框内文字，默认 false
customPrompt	string	否	自定义翻译提示词，最多约 1000 字符，影响翻译风格
context	string	否	上下文背景（角色、剧情等），最多约 10000 字符
renderImage	boolean	否	兼容字段，默认 true（保留渲染后的译图）

支持语言

源语言可传 auto 自动检测，或下列任意代码；目标语言使用 to 传入代码。完整列表也可通过 GET /v1/languages 获取（无需鉴权）。

源语言特殊值：auto· 目标语言共 133 种

代码	中文名	English
af	南非荷兰语	Afrikaans
sq	阿尔巴尼亚语	Albanian
am	阿姆哈拉语	Amharic
ar	阿拉伯语	Arabic
hy	亚美尼亚语	Armenian
as	阿萨姆语	Assamese
ay	艾马拉语	Aymara
az	阿塞拜疆语	Azerbaijani
bm	班巴拉语	Bambara
eu	巴斯克语	Basque
be	白俄罗斯语	Belarusian
bn	孟加拉语	Bengali
bho	博杰普尔语	Bhojpuri
bs	波斯尼亚语	Bosnian
bg	保加利亚语	Bulgarian
ca	加泰罗尼亚语	Catalan
ceb	宿务语	Cebuano
ny	齐切瓦语	Chichewa
zh	中文	Chinese
zh-cn	简体中文	Simplified Chinese
zh-tw	繁体中文	Traditional Chinese
co	科西嘉语	Corsican
hr	克罗地亚语	Croatian
cs	捷克语	Czech
da	丹麦语	Danish
dv	迪维希语	Divehi
doi	多格拉语	Dogri
nl	荷兰语	Dutch
eo	世界语	Esperanto
et	爱沙尼亚语	Estonian
ee	埃维语	Ewe
fil	菲律宾语	Filipino
fi	芬兰语	Finnish
fr	法语	French
fy	弗里西语	Frisian
gl	加利西亚语	Galician
lg	干达语	Ganda
ka	格鲁吉亚语	Georgian
de	德语	German
el	希腊语	Greek
gn	瓜拉尼语	Guarani
gu	古吉拉特语	Gujarati
ht	海地克里奥尔语	Haitian Creole
ha	豪萨语	Hausa
haw	夏威夷语	Hawaiian
he	希伯来语	Hebrew
hi	印地语	Hindi
hmn	苗语	Hmong
hu	匈牙利语	Hungarian
is	冰岛语	Icelandic
ig	伊博语	Igbo
ilo	伊洛卡诺语	Iloko
id	印尼语	Indonesian
ga	爱尔兰语	Irish Gaelic
it	意大利语	Italian
ja	日语	Japanese
jv	爪哇语	Javanese
kn	卡纳达语	Kannada
kk	哈萨克语	Kazakh
km	高棉语	Khmer
rw	卢旺达语	Kinyarwanda
gom	孔卡尼语	Konkani
ko	韩语	Korean
kri	克里奥语	Krio
ku	库尔德语(库尔曼吉)	Kurmanji
ckb	库尔德语(索拉尼)	Sorani
ky	吉尔吉斯语	Kyrgyz
lo	老挝语	Lao
la	拉丁语	Latin
lv	拉脱维亚语	Latvian
ln	林加拉语	Lingala
lt	立陶宛语	Lithuanian
lb	卢森堡语	Luxembourgish
mk	马其顿语	Macedonian
mai	迈蒂利语	Maithili
mg	马达加斯加语	Malagasy
ms	马来语	Malay
ml	马拉雅拉姆语	Malayalam
mt	马耳他语	Maltese
mi	毛利语	Maori
mr	马拉地语	Marathi
lus	米佐语	Mizo
mn	蒙古语	Mongolian
my	缅甸语	Burmese
ne	尼泊尔语	Nepali
nso	北索托语	Northern Sotho
no	挪威语	Norwegian
or	奥里亚语	Odia
om	奥罗莫语	Oromo
ps	普什图语	Pashto
fa	波斯语	Persian
pl	波兰语	Polish
pt	葡萄牙语	Portuguese
pa	旁遮普语	Punjabi
qu	克丘亚语	Quechua
ro	罗马尼亚语	Romanian
ru	俄语	Russian
sm	萨摩亚语	Samoan
sa	梵语	Sanskrit
gd	苏格兰盖尔语	Scots Gaelic
sr	塞尔维亚语	Serbian
st	塞索托语	Sesotho
sn	绍纳语	Shona
sd	信德语	Sindhi
si	僧伽罗语	Sinhala
sk	斯洛伐克语	Slovak
sl	斯洛文尼亚语	Slovenian
so	索马里语	Somali
es	西班牙语	Spanish
su	巽他语	Sundanese
sw	斯瓦希里语	Swahili
sv	瑞典语	Swedish
tg	塔吉克语	Tajik
ta	泰米尔语	Tamil
tt	鞑靼语	Tatar
te	泰卢固语	Telugu
th	泰语	Thai
ti	提格利尼亚语	Tigrinya
ts	聪加语	Tsonga
tr	土耳其语	Turkish
tk	土库曼语	Turkmen
ak	契维语	Twi
uk	乌克兰语	Ukrainian
ur	乌尔都语	Urdu
ug	维吾尔语	Uyghur
uz	乌兹别克语	Uzbek
vi	越南语	Vietnamese
cy	威尔士语	Welsh
xh	科萨语	Xhosa
yi	意第绪语	Yiddish
yo	约鲁巴语	Yoruba
zu	祖鲁语	Zulu
en	英语	English

排版选项

以下枚举对应 font / textAlign。也可请求 GET /v1/options 获取字体、对齐、默认值与模型列表。

font（字体）

key	名称	说明
noto	Noto Sans	通用多语言，覆盖最广
wildwords	WildWords	漫画风格
badcomic	BadComic	漫画风格
mashanzheng	MaShanZheng	中文书法风
komika	KomikaJam	漫画风格
bangers	Bangers	标题/强调风格
edo	Edo	英文专用
ridi	RIDIBatang	衬线风格
bushidoo	Bushidoo	日系风格
hayah	Hayah	阿语/波斯语友好
itim	Itim	手写风格
mogul	Mogul Irina	装饰风格
heroika	Heroika	装饰风格
shonen	Shonen	少年漫风格

textAlign（对齐）

auto自动left左对齐center居中right右对齐

状态码

HTTP	code	含义
200	0	成功
400	40001	参数错误
401	40100	未提供或无效 API Key
402	40201	积分不足
403	40300	无 API 权限（需单笔 ≥ ¥99）
404	40400	资源不存在
500	50000	服务器错误

示例

curl

curl -X POST "https://api.imagetranslate.cn/v1/images/translations" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "imageUrl": "https://example.com/sample.jpg",
    "from": "auto",
    "to": "zh-cn",
    "model": "deepseek",
    "font": "noto",
    "textAlign": "auto",
    "minFontSize": 6,
    "bubblesOnly": false
  }'