订单查询

不同接口的订单耗时不同：AI翻译一般20-600秒（取决于字幕内容大小与AI模型），DeepL翻译一般5-30秒（取决于字幕内容大小），谷歌翻译为同步处理（创建订单时直接返回结果，无需轮询）。创建订单后，可通过本接口轮询结果，建议轮询间隔：AI订单3-5秒，DeepL订单2-3秒。

也可以在创建订单时设置异步通知链接（notify_url），订单完成后，系统会主动通知订单结果信息到设定的链接。

异步通知

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)

下载不同标点符号版本

订单处理成功后，默认下载链接提供的是默认标点符号版本（与原始文件一致）的文件，如果您想下载其他标点符号版本的文件，比如[去尾标点]、[无标点]文件，可以手动给下载链接添加punctuation参数即可下载对应版本文件。

punctuation	代表
0	无标点
2	去尾标点

比如某个订单号是：zmb38243d40e580，默认下载链接为：

https://www.zmaify.com/translate_api/file_down?order_id=zmb38243d40e580

下载无标点版本文件：

https://www.zmaify.com/translate_api/file_down?order_id=zmb38243d40e580&punctuation=0

下载去尾标点版本文件：

https://www.zmaify.com/translate_api/file_down?order_id=zmb38243d40e580&punctuation=2

字母语言会提供去尾标点版本；非字母语言会提供去尾、无标点两个版本；

如果排版结果是双语字幕，选择无标点版本文件时，系统会对字母语言行进行去尾操作，对非字母语言行才会进行去除所有标点操作；

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

application/json

查询结果

Bodyapplication/json

示例

订单进行中订单处理成功订单处理失败参数校验失败

{
    "code": 1,
    "msg": "订单进行中",
    "status": 0
}

请求参数

请求示例代码

返回响应