# 日志、任务查询与保留

> 怎么查历史任务？日志中心看什么？任务和成片保留多久？如何批量筛选任务

<AccordionGroup>
  <Accordion title="怎么查一个任务的状态和结果？">
    用 `GET /api/v3/contents/generations/tasks/{task_id}`，返回任务的 `status`、`content.video_url`（成功时）、`usage`、`error`（失败时）等。任务记录长期保留，可随时回查。
  </Accordion>
  <Accordion title="怎么批量查 / 筛选任务？">
    用任务列表接口 `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}`。跑批场景用它集中查状态，比逐个长轮询高效得多。
  </Accordion>
  <Accordion title="任务和成片保留多久？">
    **任务记录**长期保留，可随时回查。但**成片 `video_url` 是约 2 小时有效的临时签名链接**，过期后重新查询任务会得到新链接；建议生成后尽快转存到自己的存储。
  </Accordion>
  <Accordion title="日志中心能看到什么？">
    [控制台「日志中心」](https://console.looprouter.com) 记录每次调用的预扣、结算（多退少补）、退款明细，可用 `task_id` 与 API 侧任务对应。核对费用、排查异常扣费都在这里。
  </Accordion>
  <Accordion title="排队中的任务能取消吗？">
    可以。`DELETE /api/v3/contents/generations/tasks/{task_id}` 能取消 `queued` 状态的任务；已经 `running` 的任务不可取消（返回 400 `invalid_task_status`）。取消成功返回 `{}`。
  </Accordion>
  <Accordion title="任务列表里查不到别人的任务？">
    对。任务、素材、认证会话都绑定账号，跨账号查询会 404。这是账号隔离，属于预期行为。
  </Accordion>
</AccordionGroup>

## 相关文档

<CardGroup cols={3}>
  <Card title="视频生成 API" icon="clapperboard" href="/api-capabilities/seedance2/video-generation">
    任务列表与取消接口
  </Card>
  <Card title="计费与余额" icon="receipt" href="/faq/billing-and-balance">
    扣费记录核对
  </Card>
  <Card title="网络与下载" icon="download" href="/faq/network-and-download">
    链接过期与转存
  </Card>
</CardGroup>