POST
https://zx1.deepwl.net
/
v1
/
video
/
create
创建视频
curl --request POST \
  --url https://zx1.deepwl.net/v1/video/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "images": [
    {}
  ],
  "model": "<string>",
  "orientation": "<string>",
  "prompt": "<string>",
  "size": "<string>",
  "duration": 123,
  "aspect_ratio": "<string>",
  "enable_upsample": true
}
'
{
  "id": "video_8b8232a3-847b-40e2-a3a3-912813b7ac60",
  "object": "video",
  "model": "veo3.1-fast-components",
  "status": "queued",
  "progress": 0,
  "created_at": 1768489641,
  "size": "1280x720",
  "detail": {
    "input": {
      "aspect_ratio": "16:9",
      "images": [
        "https://example.com/frame-1.png",
        "https://example.com/frame-2.png"
      ],
      "model": "veo3.1-fast-components",
      "prompt": "牛飞上天了"
    }
  },
  "status_update_time": 1768489641
}

​
创建视频

Veo 统一视频入口使用 POST /v1/video/create，请求体为 JSON。与 OpenAI 格式的 Veo 视频生成 不同，本接口使用 images、orientation、aspect_ratio 等字段表达参考图与画幅。
  • 路由入口是 POST /v1/video/create。
  • 参考图通过 images 数组传入 URL 列表。
  • 常见模型示例包括 veo3.1-fast-components 等，以当前渠道实际可用模型为准。
  • 提交成功后返回带 id、status、progress 的任务对象，后续用 查询任务 轮询结果。

​
方法与路径

POST /v1/video/create

​
请求示例

curl -X POST https://zx1.deepwl.net/v1/video/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "prompt": "牛飞上天了",
    "model": "veo3.1-fast-components",
    "images": [
      "https://example.com/frame-1.png",
      "https://example.com/frame-2.png"
    ],
    "orientation": "landscape",
    "size": "1280x720",
    "duration": 8,
    "aspect_ratio": "16:9",
    "enable_upsample": false
  }'

​
响应示例

{
  "id": "video_8b8232a3-847b-40e2-a3a3-912813b7ac60",
  "object": "video",
  "model": "veo3.1-fast-components",
  "status": "queued",
  "progress": 0,
  "created_at": 1768489641,
  "size": "1280x720",
  "detail": {
    "input": {
      "aspect_ratio": "16:9",
      "images": [
        "https://example.com/frame-1.png",
        "https://example.com/frame-2.png"
      ],
      "model": "veo3.1-fast-components",
      "prompt": "牛飞上天了"
    }
  },
  "status_update_time": 1768489641
}

​
认证

Authorization: Bearer YOUR_API_KEY

​
Body

​
images
array
必填
图片链接数组。传入参考图片 URL 列表。
​
model
string
必填
模型名字。例如 veo3.1-fast-components。
​
orientation
string
必填
画面方向。portrait 表示竖屏，landscape 表示横屏。
​
prompt
string
必填
提示词。描述视频内容的文本。
​
size
string
必填
输出尺寸。默认为 720x1280。可选值：720x1280、1280x720。
​
duration
integer
必填
视频时长（秒）。Veo 默认为 8 秒。
​
aspect_ratio
string
必填
宽高比。16:9 或者 9:16。
​
enable_upsample
boolean
是否高清增强（仅支持横屏）。

​
Response

​
id
string
任务 ID，后续查询时作为 id 参数传入。
​
object
string
对象类型，常见为 video。
​
model
string
实际使用的模型名。
​
status
string
任务状态，常见值包括 queued、processing、completed、failed、cancelled。
​
progress
integer
任务进度百分比。
​
created_at
integer
创建时间（Unix 时间戳）。
​
size
string
输出尺寸。
​
detail
object
提交详情，通常包含回显的 input 字段。
​
status_update_time
integer
状态最近更新时间（Unix 时间戳）。

​
相关接口