zmaiFy接口文档
  1. AI翻译接口
zmaiFy接口文档
  • AI翻译接口
    • 订单创建
      POST
    • 订单查询
      GET
  • DeepL翻译接口
    • 订单创建
      POST
    • 订单查询
      GET
  1. AI翻译接口

订单查询

GET
https://www.zmaify.com/translate_api/query
AI订单一般耗时20-600秒,具体取决于字幕内容大小与AI模型。一般创建订单后,可以通过查询接口(/query)轮询结果,建议每次轮询间隔3-5秒。
也可以在创建订单时设置异步通知链接(notify_url),这样订单后,系统会主动通知订单结果信息到设定的链接。
异步通知
订单处理成功:
字段名类型示例
codeinteger1
msgstring订单处理成功
statusinteger1
file_urlstringhttps://www.zimufy.com/translate_api/file_down?order_id=zm78377fe0f025t
file_sizestring84 KB
cost_timeinteger251

订单处理失败:
字段名类型示例
codeinteger1
msgstring订单处理失败
statusinteger4
系统以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
字母语言会提供去尾标点版本;非字母语言会提供去尾、无标点两个版本;
如果排版结果是双语字幕,选择无标点版本文件时,系统会对字母语言行进行去尾操作,对非字母语言行才会进行去除所有标点操作;

请求参数

Query 参数
order_id
string 
订单号
必需
示例值:
zm8713cced30642

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://www.zmaify.com/translate_api/query?order_id=zm8713cced30642'

返回响应

🟢200成功
application/json
Body
code
enum<integer> 
校验码
必需
0-参数校验失败 1-参数校验成功
枚举值:
01
msg
string 
信息提示
必需
status
enum<integer> 
订单状态
可选
0-进行中 1-已完成 4-失败
枚举值:
014
file_url
string 
下载地址
可选
file_size
string 
文件大小
可选
cost_time
integer 
订单耗时(秒)
可选
示例
{
    "code": 1,
    "msg": "订单进行中",
    "status": 0
}
修改于 2025-06-23 08:00:09
上一页
订单创建
下一页
订单创建
Built with