创建视频生成任务

本页示例中的 {BASE_URL} 表示 https://api.uniall.ai。

说明

新增sora2 Pro 公共模型sora2-pro-720p,sora2-pro-1080p,sora2-pro-true-1080p

Endpoint

POST /v1/video/generations

Header 参数

Name	Type	Required	Description	Example
Authorization	string	No		Bearer {your_token}

请求体参数

Field	Type	Required	Title	Description
model	string	Yes	模型名称	可选：sora2-landscape-4s，sora2-landscape-8s，sora2-landscape-12s，sora2-portrait-4s，sora2-portrait-8s，sora2-portrait-12s, sora2-pro-720p, sora2-pro-1080p
prompt	string	Yes	提示词
image_url	string	Yes	参考图URL	必须是公开可访问的URL图片链接
aspect_ratio	string	No	画幅比例	“16:9”, "9:16"
duration	string	No	输出描述	4, 8, 12, 16, 20

请求示例

示例 1

{
    "model": "sora2-portrait-12s",
    "prompt": "一只猫在草地上奔跑",
    "image_url": "https://example.com/image.jpg" // 可选
}

curl -X POST "{BASE_URL}/v1/video/generations" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora2-portrait-12s",
    "prompt": "一只猫在草地上奔跑",
    "image_url": "https://example.com/image.jpg" // 可选
}'

响应字段

Field	Type	Required	Title	Description
id	string	Yes	任务ID
object	string	Yes	任务类型
model	string	Yes	模型名称
status	string	Yes	状态
progress	string	Yes	进度
created_at	string	Yes	创建时间
seconds	string	Yes	秒数

响应示例

示例 1

{
  "id": "gen_xxxxxxxxxxxx",
  "object": "video.generation.job",
  "model": "sora2",
  "status": "queued",
  "progress": 0,
  "created_at": 1770405483,
  "seconds": "12"
}

任务状态与结果

创建成功后保存 id 或 task_id，随后调用 GET /v1/videos/{task_id}，直到任务进入 completed 或 failed。统一的轮询间隔、状态字段、错误结构、结果地址和鉴权下载方式见视频生成概览。