日志、任务查询与保留

怎么查一个任务的状态和结果？

用 GET /api/v3/contents/generations/tasks/{task_id}，返回任务的 status、content.video_url（成功时）、usage、error（失败时）等。任务记录长期保留，可随时回查。

怎么批量查 / 筛选任务？

用任务列表接口 GET /api/v3/contents/generations/tasks，支持分页与过滤：

参数	说明
`page_num`	页码，默认 1
`page_size`	每页数量，默认 20，最大 500
`filter.status`	按状态过滤：`queued` / `running` / `succeeded` / `failed` / `cancelled`
`filter.model`	按模型过滤
`filter.task_ids`	按任务 ID 列表过滤

响应为 {"items": [...], "total": n}。跑批场景用它集中查状态，比逐个长轮询高效得多。

任务和成片保留多久？

任务记录长期保留，可随时回查。但成片 video_url 是约 2 小时有效的临时签名链接，过期后重新查询任务会得到新链接；建议生成后尽快转存到自己的存储。

日志中心能看到什么？

控制台「日志中心」记录每次调用的预扣、结算（多退少补）、退款明细，可用 task_id 与 API 侧任务对应。核对费用、排查异常扣费都在这里。

排队中的任务能取消吗？

可以。DELETE /api/v3/contents/generations/tasks/{task_id} 能取消 queued 状态的任务；已经 running 的任务不可取消（返回 400 invalid_task_status）。取消成功返回 {}。

任务列表里查不到别人的任务？

对。任务、素材、认证会话都绑定账号，跨账号查询会 404。这是账号隔离，属于预期行为。

视频生成 API

任务列表与取消接口

扣费记录核对

链接过期与转存