Skip to main content
POST
Create video generation task

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
prompt
string
必填

Video description/prompt (English recommended for best results)

示例:

"A fluffy orange cat running through a sunny meadow"

action
enum<string>
必填

Video generation action

可用选项:
text2video,
img2video,
ingredients2video
示例:

"text2video"

model
enum<string>
必填

生成模型。

  • Veo:veo31_fast(默认推荐)/ veo31_qualityveo3_* 会自动映射为 veo31_*
  • 3 张引导图:对外仍传 veo31_fast + ingredients2video(或兼容 model veo31_fast_ingredients)。fast 本身只支持最多 2 张首/尾帧,服务端会改走支持 3 张参考图的 Veo 3.1 能力。
  • Omni:omni-flash,仅 text2video / img2video,不支持 ingredients2video
可用选项:
veo2_fast,
veo2_quality,
veo3_fast,
veo3_quality,
veo31_fast,
veo31_quality,
veo31_fast_ingredients,
veo31_lite,
omni-flash
示例:

"veo31_fast"

imageList
string[]

参考图 URL(必须可公网访问的 http/https)。 Veo

  • text2video:不要传图(或空数组)。
  • img2video:1 张 = 首帧;2 张 = 首帧 + 尾帧。不能传 3 张(3 张请用 ingredients2video)。
  • ingredients2video:1~3 张引导图(必填)。3 张时 duration 必须为 8(或不传,默认 8)。
  • 兼容:model=veo31_fast_ingredients 时按 ingredients2video 处理,1~3 张。 Omni(omni-flash
  • text2video:不能带图。
  • img2video:1 张 = 首帧;2~7 张 = 全部作为参考图(不会拆成首/尾帧)。 各渠张数上限不同,服务端按图数选渠;超过全部渠道能力会失败。
示例:
aspectRatio
enum<string>
默认值:16:9

Video aspect ratio

可用选项:
16:9,
9:16
示例:

"16:9"

duration
number

时长(秒)。不传则用服务端默认。

  • Veo:4 / 6 / 83 张引导图只能 8(传 4/6 会 400);不传则按 8。
  • Omni:整数 310(不传约 5 秒)。
示例:

8

generate_audio
boolean

是否生成音频。仅 Veo 生效;Omni 忽略。可选。

resolution
string

分辨率,如 720p / 1080p。仅 Veo 生效;Omni 固定约 720p,传入会被忽略。可选。

translation
boolean
默认值:false
已弃用

[已废弃] Enable automatic prompt translation to English

示例:

false

响应

201 - application/json
taskId
string
必填

task id, used to get task result later