跳转到主要内容
POST
创建视频

创建视频

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

方法与路径

请求示例

响应示例

认证

Body

images
array
必填
图片链接数组。传入参考图片 URL 列表。
model
string
必填
模型名字。例如 veo3.1-fast-components
orientation
string
必填
画面方向。portrait 表示竖屏,landscape 表示横屏。
prompt
string
必填
提示词。描述视频内容的文本。
size
string
必填
输出尺寸。默认为 720x1280。可选值:720x12801280x720
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
任务状态,常见值包括 queuedprocessingcompletedfailedcancelled
progress
integer
任务进度百分比。
created_at
integer
创建时间(Unix 时间戳)。
size
string
输出尺寸。
detail
object
提交详情,通常包含回显的 input 字段。
status_update_time
integer
状态最近更新时间(Unix 时间戳)。

相关接口