DeepL翻译-订单创建

DeepL翻译接口支持原始字幕为单语或双语类型的字幕，可提供字幕文件链接或字幕文本进行处理。使用接口前需要到zmaiFy创建api key方可使用。

api订单跟普通订单一样，需要消耗字符量，处理后，也可通过站内的订单记录进行查询与下载。

并发请求限制：推荐10-30并发。单文件字符上限 500000 字符。

请求地址为 /translate_api/create/deepl（与 /translate_api/create + 请求体 api=deepl 等价）。

下面是几个复杂字段的备注说明，点击展开可以查看详情。

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

值	代表的排版模式
1	目标语言1
2	源语言+目标语言1
3	目标语言1+源语言
4	目标语言1+目标语言2（需提供 target_lang2）
5	目标语言2+目标语言1（需提供 target_lang2）

排版模式-原字幕是双语类型（mode2）

值	代表的排版模式
3	源语言1+目标语言1
4	目标语言1+源语言1
5	源语言2+目标语言1
6	目标语言1+源语言2
7	目标语言1+目标语言2（需提供 target_lang2）
8	目标语言2+目标语言1（需提供 target_lang2）
9	目标语言1

源语言（origin_lang1、origin_lang2）

简体中文、繁体中文、英语、日语、韩语、西班牙语、法语、德语、俄语、葡萄牙语、阿拉伯语、印地语、印尼语、马来语、泰语、越南语、菲律宾语、缅甸语、孟加拉语、蒙古语、粤语、波斯语、希伯来语、土耳其语、意大利语、荷兰语、波兰语、瑞典语、丹麦语、挪威语、芬兰语、希腊语、匈牙利语、乌克兰语、乌尔都语、旁遮普语、古吉拉特语、马拉地语、尼泊尔语、泰米尔语、泰卢固语、马拉雅拉姆语、印尼爪哇语、印尼巽他语、阿塞拜疆语、哈萨克语、吉尔吉斯语、乌兹别克语、塔吉克语、土库曼语、普什图语、捷克语、斯洛伐克语、罗马尼亚语、保加利亚语、克罗地亚语、塞尔维亚语、波斯尼亚语、斯洛文尼亚语、白俄罗斯语、马其顿语、阿尔巴尼亚语、拉脱维亚语、立陶宛语、爱沙尼亚语、冰岛语、爱尔兰语、威尔士语、马耳他语、卢森堡语、加泰罗尼亚语、加利西亚语、巴斯克语、布尔语、斯瓦希里语、豪萨语、伊博语、马尔加什语、塞索托语、南非科萨语、南非祖鲁语、亚美尼亚语、格鲁吉亚语、世界语、拉丁语、毛利语、海地克里奥尔语、林加拉语、鞑靼语、巴什基尔语、梵语、阿萨姆语、博杰普尔语、亚齐语、阿拉贡语、艾马拉语、布列塔尼语、宿务语、库尔德语（索拉尼）、库尔德语（库尔曼吉）、瓜拉尼语、孔卡尼语、奥克语、奥罗莫语、邦阿西楠语、卡潘潘甘语、达里语、克丘亚语、西西里语、伦巴第语、迈蒂利语、聪加语、茨瓦纳语、沃洛夫语、意第绪语

目标语言（target_lang1、target_lang2）

简体中文、繁体中文、美式英语、英式英语、日语、韩语、西班牙语、西班牙语（拉丁）、法语、德语、俄语、葡萄牙语、葡萄牙语（巴西）、阿拉伯语、印地语、印尼语、马来语、泰语、越南语、菲律宾语、缅甸语、孟加拉语、蒙古语、粤语、波斯语、希伯来语、土耳其语、意大利语、荷兰语、波兰语、瑞典语、丹麦语、挪威语、芬兰语、希腊语、匈牙利语、乌克兰语、乌尔都语、旁遮普语、古吉拉特语、马拉地语、尼泊尔语、泰米尔语、泰卢固语、马拉雅拉姆语、印尼爪哇语、印尼巽他语、阿塞拜疆语、哈萨克语、吉尔吉斯语、乌兹别克语、塔吉克语、土库曼语、普什图语、捷克语、斯洛伐克语、罗马尼亚语、保加利亚语、克罗地亚语、塞尔维亚语、波斯尼亚语、斯洛文尼亚语、白俄罗斯语、马其顿语、阿尔巴尼亚语、拉脱维亚语、立陶宛语、爱沙尼亚语、冰岛语、爱尔兰语、威尔士语、马耳他语、卢森堡语、加泰罗尼亚语、加利西亚语、巴斯克语、布尔语、斯瓦希里语、豪萨语、伊博语、马尔加什语、塞索托语、南非科萨语、南非祖鲁语、亚美尼亚语、格鲁吉亚语、世界语、拉丁语、毛利语、海地克里奥尔语、林加拉语、鞑靼语、巴什基尔语、梵语、阿萨姆语、博杰普尔语、亚齐语、阿拉贡语、艾马拉语、布列塔尼语、宿务语、库尔德语（索拉尼）、库尔德语（库尔曼吉）、瓜拉尼语、孔卡尼语、奥克语、奥罗莫语、邦阿西楠语、卡潘潘甘语、达里语、克丘亚语、西西里语、伦巴第语、迈蒂利语、聪加语、茨瓦纳语、沃洛夫语、意第绪语

异步通知

AI订单一般耗时20-600秒，DeepL订单一般耗时5-30秒。创建订单时设置异步通知链接（notify_url）后，订单完成时系统会主动通知订单结果信息到设定的链接。通知结果信息字段如下：

订单处理成功：

字段名	类型	示例
code	integer	1
msg	string	订单处理成功
status	integer	1
file_url	string	https://www.zmaify.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：2152781735
（返回zmaiFy官网）

application/json

创建结果

Bodyapplication/json

示例

订单创建成功字符额度不足key校验失败

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

请求参数

请求示例代码

返回响应