读取视频

先调用「创建视频」，用返回的 ID 替换 video_123；下载前须轮询至 completed。

GET /model/v1/videos/{video_id}● 支持

请求参数

video_idstring必填
path: Id of the video job whose output you want, the `id` returned by createVideo. The job must be completed; before that the call answers 400.

200

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

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

响应

HTTP 200

Success

application/json

名称	类型	说明
id	string	Id of the video job; pass it as `video_id` to retrieve, download or delete it.
object	string	Object type; always `video`.
model	string	Model that generates the video.
status	string	Lifecycle of the job. Poll until it is `completed` or `failed`.
progress	integer	Progress from 0 to 100. It is 0 until the job completes and 100 once it has.
created_at	integer	Unix time in seconds at which the job was created.
completed_at	integer \| null	Unix time in seconds at which the job completed; null until then.
expires_at	integer \| null	Unix time in seconds after which the output expires; null because outputs currently have no expiry.
seconds	string	Length of the video in seconds, as a string; for a completed job it is the delivered length.
size	string	Resolution of the video as `WIDTHxHEIGHT`; null when the provider did not report one.
prompt	string \| null	Prompt the job was created with.
remixed_from_video_id	null	Always null; remix is not supported.
error	object \| null	Why the job failed; null unless status is `failed`.
error.code	string	Machine-readable failure code.
error.message	string	Human-readable failure message.
polling_url	string	Relative URL to poll for the job state; same as retrieveVideo for this job.
unsigned_urls	array<string>	Relative URLs of the finished output; empty until the video is ready. Download them with the same API key.
usage	object	Cost of the job; present once a price applies.
usage.cost	number	Cost of the job in USD: delivered seconds times the per-second price once completed, 0 while running.

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