Skip to main content
POST

认证

string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

请求参数

string
必填
视频生成模型名称支持的模型:
  • veo3.1-fast-official - Veo 3.1 官方快速版
  • veo3.1-quality-official - Veo 3.1 官方高质量版
string
必填
正向文本提示词建议详细描述场景、动作、风格等,以获得更好的生成效果。建议使用英文提示词。示例:"a golden retriever running on the beach, sunset, cinematic"
string
负面提示词,用于排除不想要的内容示例:"blurry, low quality, watermark, text"
integer
默认值:"8"
视频时长(秒)建议使用:4 / 6 / 8默认值:8⚠️ 注意: 必须输入纯数字(如 8),不要加引号,否则会报错
string
默认值:"16:9"
视频宽高比可选值:
  • 16:9 - 横屏
  • 9:16 - 竖屏
默认值:16:9
string
默认值:"720p"
视频分辨率可选值:
  • 720p - 标准分辨率
  • 1080p - 高清分辨率
  • 4K - 超高清分辨率
默认值:720p
string
首帧图片 URL,用于图生视频
  • 图片 URL 必须公开可访问,不能有防盗链
  • 建议使用对象存储 URL,而非临时下载地址
string
尾帧图片 URL,用于图生视频first_frame_image 配合使用,实现首尾帧控制
integer
随机种子,用于复现生成结果取值范围:0 - 4294967295
integer
默认值:"1"
生成样本数量 1-4,当前建议填 1默认值:1
boolean
默认值:"false"
是否生成音频轨道
string
默认值:"allow_adult"
人物生成策略可选值:
  • allow_adult - 只允许生成成人人物/成人面孔
  • disallow - 不允许生成人物或人脸
默认值:allow_adult
string
默认值:"pad"
图片缩放策略(图生视频时生效)可选值:
  • pad - 填充模式
  • crop - 裁剪模式
默认值:pad
boolean
默认值:"true"
是否启用上游提示词增强默认值:true
  • 该参数只能设置为 true,设置为 false 会导致请求报错
  • 如不需要此参数,请勿传入

文生视频 vs 图生视频

系统通过是否传入图片参数自动判断模式:不传图片为文生视频,传图片为图生视频。

响应

integer
响应状态码,成功时为 200
array
返回数据数组

使用场景

场景 1:文生视频(基础)

场景 2:文生视频(完整参数)

场景 3:图生视频(单张首帧)

场景 4:图生视频(首帧 + 尾帧)

场景 5:生成带音频的视频

查询任务结果视频生成为异步任务,提交后会返回 task_id。使用 获取任务状态 接口查询生成进度和结果。