Skip to main content
GET

manxue-2.5 查询视频任务

manxue-2.5 任务提交成功后,通过 GET /v1/videos/{task_id} 轮询任务状态。任务完成后优先读取响应中的 video_urlurl;如果没有可访问直链,再使用 GET /v1/videos/{task_id}/content 下载 MP4。
  • 根据创建任务返回的 idtask_id 查询。
  • 任务处理中继续轮询,不要重复提交同一个生成请求。
  • 任务完成后读取 video_urlurlmetadata.content_url
  • 任务失败时读取 error.codeerror.message,并记录请求参数与素材地址,便于排查。

方法与路径

请求示例

响应示例

认证

Path Parameters

string
required
视频任务 ID。创建视频任务接口返回的 idtask_id

Response

string
视频任务 ID。
string
视频任务 ID 的兼容字段。通常与 id 相同。
string
对象类型,通常为 video
string
任务实际使用的模型,例如 manxue-2.5
string
任务状态。常见值为 queuedin_progresscompletedfailed
integer
任务进度百分比。部分上游不会稳定更新进度,客户端不应只依赖该字段判断任务是否卡住。
string
任务输出时长。上游通常按字符串返回秒数。
string
任务完成后的视频地址。不同渠道可能同时返回 urlvideo_url
string
任务完成后的视频地址。为空或不可访问时,可使用 GET /v1/videos/{task_id}/content 下载。
object
任务元信息。可能包含 content_urlexpires_incost_creditscached 等字段。
object
任务失败原因。通常包含 messagecode

状态处理建议

建议轮询间隔保持在 510 秒。长时长任务、高清任务或多素材任务可能需要更长处理时间,只要状态仍为处理中,就继续轮询。

下载视频内容

如果查询结果没有直接返回可访问的 video_url,或直链下载失败,可以请求内容下载端点:
下载 /content 时建议继续携带鉴权头:

常见错误码

注意事项

  • 查询接口只读取任务状态,不会重新提交生成任务。
  • progress 长时间不变不一定代表任务失败,应以终态状态为准。
  • 如果任务失败,建议记录 modeldurationratioresolution、参考素材 URL 和完整 error

相关页面