创建任务

POST /v1/videos

通过该端点异步创建任务：提交后返回 task_id，再轮询获取结果。

请求体（VideoRequest）

请求示例

{
  "model": "gpt-image-2",
  "prompt": "a neon fox, cinematic",
  "seconds": "8",
  "size": "1024x1024",
  "tier": "2k",
  "reference_images": ["https://.../ref.png"]
}

响应（规范化任务对象）

字段	类型	必填	说明
`model`	`string`	必填	公开模型名，见“模型”页
`prompt`	`string`	必填	提示词
`seconds`	`string \`	number	可选	视频时长，接受 "8" 或 8（默认 4，范围 1–60）。图片模型忽略
`size`	`string`	可选	像素尺寸 WxH，如 1024x1024 / 1280x720。比例由 size 自动判定，无需单独传 aspect_ratio；各模型可选尺寸见对应模型页
`tier`	`string`	可选	分辨率/质量档：图片 1k/2k/4k，veo 视频 lite/720p/1080p（lite = 720p 画面的轻量档）。不传按模型默认
`reference_images`	`string[]`	可选	参考图（https URL 或 base64 data URL）。张数与是否必填见对应模型页
`metadata`	`object`	可选	自定义/扩展参数容器：顶层字段保持稳定，模型专属参数统一放这里。当前 omni 用到 metadata.first_last_frame（bool，首尾帧）、metadata.source_video_url（string，视频编辑源视频）。OpenAI SDK 通过 extra_body 传
字段	类型	必填	说明
`id`	`string`	必返	平台公开任务 ID task_xxxx，查询/下载用
`task_id`	`string`	必返	与 id 相同，兼容旧接口（待废弃）
`object`	`string`	必返	固定 video（图片任务亦然）
`model`	`string`	必返	公开模型名
`status`	`string`	必返	queued / in_progress / completed / failed
`progress`	`number`	必返	进度 0–100
`created_at`	`number`	必返	创建时间（Unix 秒）
`completed_at`	`number`	可选	完成时间，仅有值时返回
`expires_at`	`number`	可选	过期时间，仅有值时返回
`output_url`	`string`	可选	统一下载地址，仅完成后返回，恒为 {base}/v1/videos/{task_id}/content
`error`	`object`	可选	失败时 {message, code}，否则不返回

响应示例

{
  "id": "task_xxxxxxxx",
  "task_id": "task_xxxxxxxx",
  "object": "video",
  "model": "gpt-image-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1700000000,
  "seconds": "8",
  "size": "1024x1024"
}