通用视频接口 · OpenAI 格式

视频列表

分页列出账号下的视频，按创建时间排序。请求参数和返回结果与 OpenAI 的 List videos 接口一致。

GEThttps://your-domain/v1/videos

请求示例

curl "https://your-domain/v1/videos?limit=20&order=desc" \
  -H "Authorization: Bearer $API_KEY"

返回结果

{
  "object": "list",
  "data": [
    {
      "id": "video_8f3k2m9x4q1w7e5r0t6y2u4p",
      "object": "video",
      "model": "doubao-seedance-2-0-260128",
      "status": "completed",
      "progress": 100,
      "created_at": 1791691200,
      "completed_at": 1791691318,
      "expires_at": null,
      "seconds": "5",
      "size": "1280x720",
      "prompt": "清晨的海边，一只金毛犬沿着浪花奔跑，镜头缓慢跟随，阳光穿过薄雾",
      "remixed_from_video_id": null,
      "error": null,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "audio": false,
      "input_mode": "text",
      "price": "4.968",
      "video_url": "https://your-domain/uploads/videos/2026/10/k3Zq8mVt2LxR9pWa.mp4"
    }
  ],
  "first_id": "video_8f3k2m9x4q1w7e5r0t6y2u4p",
  "last_id": "video_8f3k2m9x4q1w7e5r0t6y2u4p",
  "has_more": false
}

请求参数

查询参数

limitinteger默认值 20

每页的视频数，1 到 100。

orderstring默认值 desc

排序方式：desc 从新到旧，asc 从旧到新。

afterstring

翻页游标，传上一页的 last_id，返回排在它后面的视频。传入的 ID 不存在时返回 400。

返回参数

objectstring

固定为 list。

dataobject[]

当前页的视频，字段见查询视频。

first_idstring | null

当前页第一个视频的 ID，没有视频时为 null。

last_idstring | null

当前页最后一个视频的 ID，翻页时作为下一次请求的 after。没有视频时为 null。

has_moreboolean

后面是否还有视频。

列表包含账号下的所有视频：所有模型、各种接口格式创建的任务，以及在控制台生成的视频。
通过了参数检查、但提交时被模型拒绝或暂时无法提交的请求，创建接口返回错误的同时会留下一条 failed 记录，不扣费。