订单创建

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

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

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

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

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

源语言（origin_lang1、origin_lang2）

简体中文, 繁体中文, 英语, 日语, 韩语, 俄语, 德语, 法语, 葡萄牙语, 西班牙语, 保加利亚语, 捷克语, 丹麦语, 希腊语, 爱沙尼亚语, 芬兰语, 匈牙利语, 印尼语, 意大利语, 立陶宛语, 拉脱维亚语, 挪威语, 荷兰语, 波兰语, 罗马尼亚语, 斯洛伐克语, 斯洛文尼亚语, 瑞典语, 土耳其语, 乌克兰语, 阿拉伯语

目标语言（target_lang1、target_lang2）

简体中文, 繁体中文, 英式英语, 美式英语, 日语, 韩语, 俄语, 德语, 法语, 葡萄牙语-巴西, 葡萄牙语-除巴西外, 西班牙语, 保加利亚语, 捷克语, 丹麦语, 希腊语, 爱沙尼亚语, 芬兰语, 匈牙利语, 印尼语, 意大利语, 立陶宛语, 拉脱维亚语, 挪威语, 荷兰语, 波兰语, 罗马尼亚语, 斯洛伐克语, 斯洛文尼亚语, 瑞典语, 土耳其语, 乌克兰语, 阿拉伯语

异步通知

DeepL订单一般耗时3-30秒，具体取决于字幕内容大小。一般创建订单后，可以通过查询接口（/query）轮询结果。也可以在创建订单时设置异步通知链接（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

Body

示例

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

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

请求参数

请求示例代码

返回响应