Veo 3.1 API

Buble 上的 Veo 3.1 提供 Fast 与 Quality 变体，适合电影感文生视频、参考图视频和帧控制视频生成。

模型 key

google/veo3.1-fast — Veo3.1 Fast
google/veo3.1-quality — Veo3.1 Quality

支持的 mode 与输入

模型	Mode	名称	输入要求
`google/veo3.1-fast`	`text_to_video`	文生视频	Prompt max 2000 chars
`google/veo3.1-fast`	`reference_to_video`	参考图生成视频	Prompt max 2000 chars Images `reference`: 1-3 files, 10 MB, formats jpg, png, webp
`google/veo3.1-fast`	`frames_to_video`	首尾帧生成视频	Prompt max 2000 chars Images `start_frame,end_frame`: 1-2 files, 10 MB, formats jpg, png, webp
`google/veo3.1-quality`	`text_to_video`	文生视频	Prompt max 2000 chars
`google/veo3.1-quality`	`reference_to_video`	参考图生成视频	Prompt max 2000 chars Images `reference`: 1-3 files, 10 MB, formats jpg, png, webp
`google/veo3.1-quality`	`frames_to_video`	首尾帧生成视频	Prompt max 2000 chars Images `start_frame,end_frame`: 1-2 files, 10 MB, formats jpg, png, webp

参数

模型	参数	默认值	可选值	适用 mode
`google/veo3.1-fast`	`duration`	`8s`	`8s`	全部 mode
`google/veo3.1-fast`	`resolution`	`720p`	`720p`, `1080p`, `4k`	全部 mode
`google/veo3.1-fast`	`aspect_ratio`	`16:9`	`16:9`, `9:16`	全部 mode
`google/veo3.1-quality`	`duration`	`8s`	`8s`	全部 mode
`google/veo3.1-quality`	`resolution`	`720p`	`720p`, `1080p`, `4k`	全部 mode
`google/veo3.1-quality`	`aspect_ratio`	`16:9`	`16:9`, `9:16`	全部 mode

价格

模型	价格
`google/veo3.1-fast`	每秒 5 credits；参数倍率：`resolution`=`{"4k":3,"720p":1,"1080p":1}`
`google/veo3.1-quality`	每秒 1 credit；参数倍率：`resolution`=`{"4k":80,"720p":26,"1080p":26}`

生产建议

显式传入 mode。
只使用上表列出的参数值。
媒体输入类 mode 请先用 POST /api/v1/files 上传素材。
如果页面包含多个变体，请使用你真正需要的模型 key。

示例：文生视频

curl https://buble.ai/api/v1/generations \
  -H "Authorization: Bearer $BUBLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo3.1-fast",
    "mode": "text_to_video",
    "prompt": "A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion",
    "duration": "8s",
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

示例：素材驱动视频

curl https://buble.ai/api/v1/generations \
  -H "Authorization: Bearer $BUBLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo3.1-fast",
    "mode": "frames_to_video",
    "prompt": "Animate the source into a polished cinematic motion shot with natural camera movement",
    "start_frame": "https://example.com/start.png",
    "duration": "8s",
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Veo 3.1 API

On this page