GlobalAiOpc

视频去字幕 - 查询任务

查询视频去字幕任务的状态和结果

GET/kyyReactApiServer/v1/result/{id}

视频去字幕查询任务

使用任务 ID 查询视频去字幕任务的状态和结果。

认证

所有请求都需要在请求头中包含 Bearer token:
cURL
Authorization: Bearer {{key}}

基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址,请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

路径参数

idstring必填
视频去字幕任务的唯一标识符,从创建任务接口返回。
创建接口直接返回字段 id,查询时请将该值作为这里的 id 使用。

响应参数

idstring
视频去字幕任务的唯一标识符。
objectstring
对象类型,固定为 video
createdinteger
任务创建时间戳。
modelstring
使用的模型名称,例如 sd2ManxueRemoveSubtitle
statusstring
任务状态:
  • queued - 排队中
  • processing - 处理中
  • completed - 已完成
  • failed - 失败
video_urlstring
去字幕后的视频 URL,当状态为 completed 时返回。
errorstring
错误信息,当状态为 failed 时返回。

状态流程

queued

任务已创建并进入队列,等待处理。

processing

视频去字幕任务正在处理中。

completed

任务完成,可通过 video_url 获取结果。

轮询建议

轮询策略:
  • 建议轮询间隔:30-60 秒
  • 不要过于频繁轮询,避免触发限流
  • 当状态为 completedfailed 时停止轮询

结果说明

重要提示:
  • 生成结果通常为临时下载地址,请及时保存
  • 若输入视频 URL 不可访问或视频不符合平台要求,任务可能失败