Veo 视频生成

提交 Veo 视频生成任务（文生、首帧、首尾帧、参考图）。

请求地址仍为 POST /v1/video/generations，完成后用 GET /v1/video/generations/{task_id} 查询。

素材只通过 metadata.content 传入。首帧写 role=first_frame，尾帧必须和首帧一起传。参考图写 reference_image，并用 reference_type 标明 asset 或 style。不支持参考视频。

时长固定 8 秒。分辨率使用大写 720P、1080P，宽高比只支持 16:9、9:16。

各版本能力与字段说明见下方接口文档。

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

In: header

Request Body

application/json

model*string

模型 ID。两个模型能力相同。

model	说明
`veo-video-3.1`	文生、首帧、首尾帧、参考图；时长固定 8 秒；支持音频
`veo-video-3.1-fast`	同上

prompt?string

文本描述提示词。t2v 模式必填；i2v / 参考图模式建议填写以精确描述运动效果。

duration?number

视频时长固定为 8 秒。传入其他值会被忽略。

resolution?string

分辨率。720P、1080P，默认 720P，使用大写 P。

ratio?string

宽高比。只支持 16:9、9:16。

seed?integer

随机种子，控制生成结果可复现性。全部模型支持。

metadata?

扩展参数。尾帧必须和首帧一起传。不支持参考视频。

字段	类型	说明
`content`	array	素材列表。见下方元素字段
`negative_prompt`	string	反向提示词
`audio_generation`	string	是否生成 AI 音频，`Enabled` / `Disabled`。有值即转发

`content` 元素结构

字段	类型	说明
`type`	string	`image_url`
`role`	string	见下表
`image_url.url`	string	图片地址
`reference_type`	string	参考图类型。`asset` 素材参考，`style` 风格参考

role 取值：

role	适用 type	说明
`first_frame`	image_url	首帧。必须显式填写，省略时按参考图提交
`last_frame`	image_url	尾帧。必须和首帧一起传
`reference_image`	image_url	参考图

Response Body

application/json

curl -X POST "https://loading/v1/video/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-video-3.1",
    "prompt": "保持画面风格，让场景流动起来",
    "metadata": {
      "audio_generation": "Enabled",
      "content": [
        {
          "type": "image_url",
          "role": "reference_image",
          "reference_type": "style",
          "image_url": {
            "url": "https://example.com/scene.jpg"
          }
        }
      ]
    }
  }'

curl -X POST "https://loading/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "veo-video-3.1",    "prompt": "保持画面风格，让场景流动起来",    "metadata": {      "audio_generation": "Enabled",      "content": [        {          "type": "image_url",          "role": "reference_image",          "reference_type": "style",          "image_url": {            "url": "https://example.com/scene.jpg"          }        }      ]    }  }'

{
  "task_id": "task_aehCmxJ5YUNOIQGgkhvxaco4T9P2h3Dw",
  "status": "queued"
}

{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}

Authorization

Request Body

content 元素结构

Response Body

200application/json

400application/json

`content` 元素结构

application/json

application/json