订单查询

AI订单一般耗时20-600秒，具体取决于字幕内容大小与AI模型。一般创建订单后，可以通过查询接口（/query）轮询结果，建议每次轮询间隔3-5秒。
也可以在创建订单时设置异步通知链接（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)

下载不同标点符号版本

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

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

比如某个订单号是：zmb38243d40e580
默认下载链接为：https://www.zimufy.com/translate_api/file_down?order_id=zmb38243d40e580

那么通过下面链接可以下载去尾标点版本文件：
https://www.zimufy.com/translate_api/file_down?order_id=zmb38243d40e580&punctuation=0

那么通过下面链接可以下载无标点版本文件：
https://www.zimufy.com/translate_api/file_down?order_id=zmb38243d40e580&punctuation=2

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

application/json

Body

code

enum<integer>

校验码

必需

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

枚举值:

msg

string

信息提示

必需

status

enum<integer>

订单状态

可选

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

枚举值:

014

file_url

string

下载地址

可选

file_size

string

文件大小

可选

cost_time

integer

订单耗时（秒）

可选

示例

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

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

请求参数

示例代码

返回响应