创建视频任务

POSThttps://vip.zen-ai.top/v1/videos

使用 OpenAI 视频接口格式提交视频生成任务。接口会立即返回一个视频对象（status 为 queued），之后通过 查询视频任务 轮询状态，完成后通过 下载视频内容 获取 MP4。完整流程见 异步任务说明。

当前可用的视频模型（点击复制）：

请求体

请求体可以是 JSON；需要上传参考图时改用 multipart/form-data。

modelstring必填

视频模型，如 sora-2、veo-3.1-fast-generate-preview。

promptstring必填

视频描述，建议写清主体、动作、场景、镜头与风格。

secondsstring

视频时长（秒），Sora 2 支持 "4"、"8"、"12"，注意为字符串。

sizestring

分辨率，Sora 2 支持 1280x720（横屏）与 720x1280（竖屏）。

input_referencefile

参考图（首帧），需使用 multipart 上传，尺寸应与 size 一致。

metadataobject

模型专属参数，原样传给上游。Veo 系列常用：

子字段 5

aspectRatiostring

宽高比。

可选值16:99:16

durationSecondsnumber

时长（秒），如 4、6、8。

resolutionstring

分辨率。

可选值720p1080p

negativePromptstring

不希望出现的内容。

personGenerationstring

人物生成策略，如 allow_all、allow_adult。

响应

返回视频对象：

idstring

任务 ID，后续查询与下载都使用它。

objectstring

固定为 video。

modelstring

使用的模型。

statusstring

任务状态，刚提交时通常为 queued。

可选值queuedin_progresscompletedfailed

progressinteger

进度 0–100。

created_atinteger

创建时间戳。

secondsstring

视频时长。

sizestring

分辨率。

请求示例

cURL

curl https://vip.zen-ai.top/v1/videos \
  -H "Authorization: Bearer $VIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "一只橘猫在洒满阳光的窗台上伸懒腰，镜头缓慢推近",
    "seconds": "4",
    "size": "1280x720"
  }'

cURL 带参考图

curl https://vip.zen-ai.top/v1/videos \
  -H "Authorization: Bearer $VIP_API_KEY" \
  -F "model=sora-2" \
  -F "prompt=让画面中的人物转身微笑，镜头缓慢拉远" \
  -F "seconds=4" \
  -F "size=1280x720" \
  -F "input_reference=@first_frame.jpg"

Python

import requests

resp = requests.post(
    "https://vip.zen-ai.top/v1/videos",
    headers={"Authorization": "Bearer sk-xxxxxxxx"},
    json={
        "model": "sora-2",
        "prompt": "一只橘猫在洒满阳光的窗台上伸懒腰，镜头缓慢推近",
        "seconds": "4",
        "size": "1280x720",
    },
).json()
print(resp["id"], resp["status"])

响应示例

{
  "id": "video_68d9b1c2e4f0a8b3",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1790684800,
  "seconds": "4",
  "size": "1280x720"
}