Veo 3.1 视频生成 - API Docs

AionRouter 的 Gemini 视频适配器支持 veo-3.0-generate-001、veo-3.0-fast-generate-001、veo-3.1-generate-preview、veo-3.1-fast-generate-preview 和 veo-3.1-lite-generate-preview。模型和权限可能随部署变化。调用前请使用列出模型确认可用性。

模型选择

模型	适合场景	最高分辨率
`veo-3.1-generate-preview`	画质优先	`4k`
`veo-3.1-fast-generate-preview`	速度与质量平衡	`4k`
`veo-3.1-lite-generate-preview`	更轻量的生成	`1080p`

Veo 3.1 接受 4、6 或 8 秒。1080p 和 4k 只能生成 8 秒；Lite 不支持 4k。

请求头

Header	必填	说明
`Authorization`	是	`Bearer <API_KEY>`。
`Content-Type`	是	`application/json`。

请求体字段

字段	类型	必填	说明
`model`	string	是	Veo 3.1 模型 ID。
`prompt`	string	是	文本提示词。
`duration`	integer	否	`4`、`6` 或 `8`。未传时由模型使用默认值。
`seconds`	string	否	兼容字段。建议只使用 `duration`；若同时传入，`duration` 的优先级高于 `seconds`。
`size`	string	否	常见尺寸如 `1280x720`、`1920x1080`、`3840x2160`。
`images`	string[]	图生时可选	仅使用第一张作为首帧。JSON 中只接受完整 data URI 或原始 Base64，不接受公网 URL。
`input_reference`	file	图生时可选	multipart 调用时的本地首帧图片字段。不要与 `images` 同时传入。
`metadata`	object	否	使用 `resolution`、`aspectRatio` 和 `durationSeconds` 进行精确控制。

常用参数

字段	说明
`prompt`	描述镜头、动作、环境和声音意图。
`duration`	推荐字段，使用 `4`、`6` 或 `8`。
`seconds`	兼容字段。只在无法传 `duration` 时使用；同时传入时，`duration` 优先。
`size`	可用 `1280x720`、`1920x1080`、`3840x2160` 等常见尺寸。Router 会转换为 Veo 分辨率和画幅。
`metadata.resolution`	可显式使用 `720p`、`1080p` 或 `4k`。
`metadata.aspectRatio`	使用 `16:9` 或 `9:16` 等目标画幅。
`metadata.durationSeconds`	可选时长控制，使用 `4`、`6` 或 `8`。它优先于顶层 `duration`。建议每次请求只设置一种时长字段。
第一张 `images`	可选首帧图片。传完整 data URI 或原始 Base64；只会使用第一张图。

文生视频示例

curl -X POST "https://router.aionclaw.ai/v1/video/generations" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-fast-generate-preview",
    "prompt": "A cyclist riding through a misty forest at dawn",
    "duration": 8,
    "metadata": {
      "resolution": "1080p",
      "aspectRatio": "16:9"
    }
  }'

单图生视频

JSON 调用时，将完整 data URI 或原始 Base64 图片放在 images[0]，并继续提供完整提示词。当前 AionRouter 的 Veo 适配器不会下载 images 中的公网 URL。若你的图片在本地，请改用下面的 multipart input_reference 示例。

curl -X POST "https://router.aionclaw.ai/v1/video/generations" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -F "model=veo-3.1-fast-generate-preview" \
  -F "prompt=让画面中的纸飞机飞离桌面，穿过明亮的窗边，镜头稳定跟随" \
  -F "duration=8" \
  -F 'metadata={"resolution":"1080p","aspectRatio":"16:9"}' \
  -F "input_reference=@./paper-plane.jpg;type=image/jpeg"

如果使用 JSON，请将 images[0] 替换为完整的 data:image/jpeg;base64,... 字符串或原始 Base64 字符串，不能填 URL。提交后保存响应中的 id，再使用 GET /v1/video/generations/{task_id} 查询。统一接口的提交响应、完成响应、状态字段和下载命令见异步任务工作流。 Veo 3.1 在 AionRouter 中使用统一任务接口。任务提交后，通过统一任务查询接口获取最新状态。请先用列出模型确认你的 API 密钥可调用的模型。

Veo 3.1 请使用 *-preview 模型 ID。Veo 3.0 使用其各自的 *-001 模型 ID。