订单创建

AI翻译接口仅支持原始字幕为单语类型的字幕，可提供字幕文件链接或字幕文本进行处理。使用接口前需要到zimuFy创建api key方可使用。
api订单跟普通订单一样，需要消耗字符量，处理后，也可通过站内的订单记录进行查询与下载。
下面是几个复杂字段的备注说明，点击展开可以查看详情。

排版模式-原字幕是单语类型（mode1）

值	代表的排版模式
1	目标语言1
2	源语言+目标语言1
3	目标语言1+源语言
4	目标语言1+目标语言2
5	目标语言2+目标语言1

AI模型（ai_model）

值	代表的AI模型	模型倍率	可用性
1	grok-3	2	√
2	claude-3.7-sonnet	2	√
3	gpt-4.1	1.5	√
4	claude-3.5-sonnet	2	√
6	deepseek-v3	1	√
7	gemini-1.5-pro	1	√
8	deepseek-r1	2	√
9	gemini-2.0-flash	0.6	√
10	doubao-1.5-pro-32k	0.6	√
11	[官]claude-3.7-sonnet	5.5	√
12	qwen-turbo	0.4	×
13	qwen-plus	0.6	√
15	qwen-max	1.5	√
16	gemini-2.5-pro	2	√
17	gemini-2-pro	1	×
18	[官]claude-3.5-sonnet	5.5	√

源语言（origin_lang1）

简体中文, 繁体中文, 英语, 日语, 韩语, 俄语, 德语, 法语, 葡萄牙语, 西班牙语, 意大利语, 阿拉伯语, 印地语, 越南语, 泰语, 印尼语, 马来语, 蒙古语, 孟加拉语, 缅甸语, 菲律宾语, 维吾尔语, 捷克语, 丹麦语, 荷兰语, 芬兰语, 希腊语, 土耳其语, 乌克兰语, 波兰语, 希伯来语, 匈牙利语, 挪威语, 瑞典语, 爱尔兰语, 爱沙尼亚语, 白俄罗斯语, 保加利亚语, 阿尔巴尼亚语, 阿姆哈拉语, 阿塞拜疆语, 冰岛语, 波斯尼亚语, 波斯语, 布尔语, 鞑靼语, 弗里西语, 奥利亚语, 巴斯克语, 高棉语, 格鲁吉亚语, 古吉拉特语, 哈萨克语, 海地克里奥尔语, 豪萨语, 吉尔吉斯语, 加利西亚语, 加泰罗尼亚语, 卡纳达语, 科西嘉语, 克罗地亚语, 库尔德语, 拉丁语, 拉脱维亚语, 老挝语, 立陶宛语, 卢森堡语, 卢旺达语, 罗马尼亚语, 马尔加什语, 马耳他语, 马拉地语, 马拉雅拉姆语, 马其顿语, 毛利语, 南非科萨语, 南非祖鲁语, 尼泊尔语, 旁遮普语, 普什图语, 齐切瓦语, 萨摩亚语, 塞尔维亚语, 塞索托语, 僧伽罗语, 世界语, 斯洛伐克语, 斯洛文尼亚语, 斯瓦希里语, 苏格兰盖尔语, 宿务语, 苗语, 索马里语, 塔吉克语, 泰卢固语, 泰米尔语, 土库曼语, 威尔士语, 乌尔都语, 乌兹别克语, 夏威夷语, 信德语, 修纳语, 亚美尼亚语, 伊博语, 意第绪语, 印尼巽他语, 印尼爪哇语, 约鲁巴语

目标语言（target_lang1、target_lang2）

简体中文, 繁体中文, 英式英语, 美式英语, 日语, 韩语, 俄语, 德语, 法语, 葡萄牙语, 西班牙语, 意大利语, 阿拉伯语, 印地语, 越南语, 泰语, 印尼语, 马来语, 蒙古语, 孟加拉语, 缅甸语, 菲律宾语, 维吾尔语, 捷克语, 丹麦语, 荷兰语, 芬兰语, 希腊语, 土耳其语, 乌克兰语, 波兰语, 希伯来语, 匈牙利语, 挪威语, 瑞典语, 爱尔兰语, 爱沙尼亚语, 白俄罗斯语, 保加利亚语, 阿尔巴尼亚语, 阿姆哈拉语, 阿塞拜疆语, 冰岛语, 波斯尼亚语, 波斯语, 布尔语, 鞑靼语, 弗里西语, 奥利亚语, 巴斯克语, 高棉语, 格鲁吉亚语, 古吉拉特语, 哈萨克语, 海地克里奥尔语, 豪萨语, 吉尔吉斯语, 加利西亚语, 加泰罗尼亚语, 卡纳达语, 科西嘉语, 克罗地亚语, 库尔德语, 拉丁语, 拉脱维亚语, 老挝语, 立陶宛语, 卢森堡语, 卢旺达语, 罗马尼亚语, 马尔加什语, 马耳他语, 马拉地语, 马拉雅拉姆语, 马其顿语, 毛利语, 南非科萨语, 南非祖鲁语, 尼泊尔语, 旁遮普语, 普什图语, 齐切瓦语, 萨摩亚语, 塞尔维亚语, 塞索托语, 僧伽罗语, 世界语, 斯洛伐克语, 斯洛文尼亚语, 斯瓦希里语, 苏格兰盖尔语, 宿务语, 苗语, 索马里语, 塔吉克语, 泰卢固语, 泰米尔语, 土库曼语, 威尔士语, 乌尔都语, 乌兹别克语, 夏威夷语, 信德语, 修纳语, 亚美尼亚语, 伊博语, 意第绪语, 印尼巽他语, 印尼爪哇语, 约鲁巴语

异步通知

AI订单一般耗时20-600秒，具体取决于字幕内容大小与AI模型。一般创建订单后，可以通过查询接口（/query）轮询结果。也可以在创建订单时设置异步通知链接（notify_url），这样订单后，系统会主动通知订单结果信息到设定的链接。通知结果信息字段如下：

订单处理成功：

字段名	类型	示例
code	integer	1
msg	string	订单处理成功
status	integer	1
file_url	string	https://www.zimufy.com/translate_api/file_down?order_id=zm78377fe0f025t
file_size	string	84 KB
cost_time	integer	251

订单处理失败：

字段名	类型	示例
code	integer	1
msg	string	订单处理失败
status	integer	4

系统以json头部与json内容形式发送POST通知，下面是主流语言接收通知的代码示例，确保最后返回HTTP200状态码即可，如果遇到网络异常或者返回状态码不是200，系统会再重试2次进行通知。

python接收示例

php接收示例

JavaScript接收示例

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/notify', methods=['POST'])
def handle_notify():
  data = request.json  # 自动解析JSON数据
  print("收到通知数据:", data)
  
  # 这里处理业务逻辑，比如验证数据、更新订单状态等
  
  # 返回成功响应 (HTTP 200)
  return 'success'

if __name__ == '__main__':
  app.run(port=5000)

API接口公测上线中，欢迎反馈问题与建议，客服QQ：2801088826 （返回zimuFy官网）

application/json

Body

code

enum<integer>

校验码

必需

0-参数校验失败 1-参数校验成功

枚举值:

msg

string

提示信息

必需

order_id

string

订单号

可选

15位由小写字母数字组成

status

enum<integer>

订单状态

可选

0-进行中 1-已完成 4-失败

枚举值:

014

file_tokens

integer

文件字符

可选

cost_tokens

integer

消耗字符

可选

示例

订单创建成功订单创建失败参数校验失败

{
  "code": 1,
  "msg": "订单创建成功",
  "order_id": "zm78354fe0f03ac",
  "status": 0,
  "file_tokens": 5625,
  "cost_tokens": 2574
}

请求参数

示例代码

返回响应