manxue-2.5
manxue-2.5 查询视频任务
使用 GET /v1/videos/{task_id} 查询 manxue-2.5 视频任务状态、结果和错误信息。
GET
manxue-2.5 查询视频任务
manxue-2.5 任务提交成功后,通过 GET /v1/videos/{task_id} 轮询任务状态。任务完成后优先读取响应中的 video_url 或 url;如果没有可访问直链,再使用 GET /v1/videos/{task_id}/content 下载 MP4。
- 根据创建任务返回的
id或task_id查询。 - 任务处理中继续轮询,不要重复提交同一个生成请求。
- 任务完成后读取
video_url、url或metadata.content_url。 - 任务失败时读取
error.code和error.message,并记录请求参数与素材地址,便于排查。
方法与路径
请求示例
响应示例
认证
Path Parameters
string
required
视频任务 ID。创建视频任务接口返回的
id 或 task_id。Response
string
视频任务 ID。
string
视频任务 ID 的兼容字段。通常与
id 相同。string
对象类型,通常为
video。string
任务实际使用的模型,例如
manxue-2.5。string
任务状态。常见值为
queued、in_progress、completed、failed。integer
任务进度百分比。部分上游不会稳定更新进度,客户端不应只依赖该字段判断任务是否卡住。
string
任务输出时长。上游通常按字符串返回秒数。
string
任务完成后的视频地址。不同渠道可能同时返回
url 和 video_url。string
任务完成后的视频地址。为空或不可访问时,可使用
GET /v1/videos/{task_id}/content 下载。object
任务元信息。可能包含
content_url、expires_in、cost_credits、cached 等字段。object
任务失败原因。通常包含
message 和 code。状态处理建议
建议轮询间隔保持在
5 到 10 秒。长时长任务、高清任务或多素材任务可能需要更长处理时间,只要状态仍为处理中,就继续轮询。
下载视频内容
如果查询结果没有直接返回可访问的video_url,或直链下载失败,可以请求内容下载端点:
/content 时建议继续携带鉴权头:
常见错误码
注意事项
- 查询接口只读取任务状态,不会重新提交生成任务。
progress长时间不变不一定代表任务失败,应以终态状态为准。- 如果任务失败,建议记录
model、duration、ratio、resolution、参考素材 URL 和完整error。