统一视频接口

POSThttps://vip.zen-ai.top/v1/video/generations

统一格式的视频生成接口，适合需要对接多家视频模型的场景。提交与查询的用法与创建视频任务基本一致；如无特殊需要，推荐优先使用 OpenAI 格式的 /v1/videos 系列接口。

提交任务

POST /v1/video/generations

modelstring必填

视频模型名称。

promptstring必填

视频描述。

imagestring

参考图，图片 URL 或 base64 Data URL（图生视频）。

durationnumber

时长（秒），不同模型支持的取值不同。

secondsstring

时长（秒，字符串），Sora 系列使用。

sizestring

分辨率，如 1280x720。

metadataobject

模型专属参数，原样传给上游，如 Veo 的 aspectRatio、durationSeconds、resolution、negativePrompt。

返回任务对象，其中 id（或 task_id）为任务 ID。

查询任务

GET /v1/video/generations/{task_id}

codestring

success 表示查询成功。

dataobject

任务信息。

子字段 5

task_idstring

任务 ID。

statusstring

任务状态。

可选值queuedprocessingsucceededfailed

urlstring

视频地址（成功时）。

formatstring

视频格式，如 mp4。

errorobject

失败原因。

任务完成后，也可以通过下载视频内容（GET /v1/videos/{task_id}/content）直接获取文件。

请求示例

提交任务查询任务

bash

curl https://vip.zen-ai.top/v1/video/generations \
  -H "Authorization: Bearer $VIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-fast-generate-preview",
    "prompt": "海浪拍打礁石，慢动作，夕阳逆光",
    "metadata": {"aspectRatio": "16:9", "durationSeconds": 8}
  }'

bash

curl https://vip.zen-ai.top/v1/video/generations/task_7f3a9c2e \
  -H "Authorization: Bearer $VIP_API_KEY"

响应示例

提交查询

json

{
  "id": "task_7f3a9c2e",
  "task_id": "task_7f3a9c2e",
  "object": "video",
  "model": "veo-3.1-fast-generate-preview",
  "status": "",
  "progress": 0,
  "created_at": 1790684800
}

json

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_7f3a9c2e",
    "status": "succeeded",
    "url": "https://...",
    "format": "mp4",
    "metadata": null,
    "error": null
  }
}

统一视频接口 ​

提交任务 ​

查询任务 ​

统一视频接口

提交任务

查询任务