列出视频

GET /model/v1/videos● 支持

请求参数

afterstring可选
query: Cursor: the id of the video job after which the page starts, normally the `last_id` of the previous page. It must refer to an existing job of yours, otherwise the call fails.
分页参数生效；limit 为 1–100，order 为 asc/desc，after 必须引用存在的任务。
limitinteger可选
默认 20
query: Maximum number of jobs per page, from 1 to 100; defaults to 20.
分页参数生效；limit 为 1–100，order 为 asc/desc，after 必须引用存在的任务。
orderany可选
默认 "desc"
query: Sort order by creation time: desc (default) lists the newest job first, asc the oldest first.
分页参数生效；limit 为 1–100，order 为 asc/desc，after 必须引用存在的任务。
取值 ascdesc

200

按输出秒数计费；每秒价格见 GET /model/v1/models 的 pricing.video_second（USD/秒）。

鉴权、限流、参数校验等平台错误按 problem+json 返回；OCR 的错误也为 problem+json，其它模型调用的错误按该端点所属格式（OpenAI 或 Anthropic）返回，参见错误码

响应

HTTP 200

Success

application/json

名称	类型	说明
object	string	Object type; always `list`.
data	array<object>	Video jobs of the caller, newest first by default.
data[].id	string	Id of the video job; pass it as `video_id` to retrieve, download or delete it.
data[].object	string	Object type; always `video`.
data[].model	string	Model that generates the video.
data[].status	string	Lifecycle of the job. Poll until it is `completed` or `failed`.
data[].progress	integer	Progress from 0 to 100. It is 0 until the job completes and 100 once it has.
data[].created_at	integer	Unix time in seconds at which the job was created.
data[].completed_at	integer \| null	Unix time in seconds at which the job completed; null until then.
data[].expires_at	integer \| null	Unix time in seconds after which the output expires; null because outputs currently have no expiry.
data[].seconds	string	Length of the video in seconds, as a string; for a completed job it is the delivered length.
data[].size	string	Resolution of the video as `WIDTHxHEIGHT`; null when the provider did not report one.
data[].prompt	string \| null	Prompt the job was created with.
data[].remixed_from_video_id	null	Always null; remix is not supported.
data[].error	object \| null	Why the job failed; null unless status is `failed`.
data[].polling_url	string	Relative URL to poll for the job state; same as retrieveVideo for this job.
data[].unsigned_urls	array<string>	Relative URLs of the finished output; empty until the video is ready. Download them with the same API key.
data[].usage	object	Cost of the job; present once a price applies.
has_more	boolean	Whether more jobs exist beyond this page; pass `last_id` as `after` to read them.
first_id	string \| null	Id of the first job in this page; null for an empty page.
last_id	string \| null	Id of the last job in this page; null for an empty page.

先创建视频，保存返回的 id；再读取视频轮询 status，queued / in_progress 时继续等待，failed 时停止并查看 error；只有 completed 后才下载视频内容。