Veo 3.1 异步视频 API

Veo 3.1 Standard 和 Veo 3.1 Fast 通过统一的 POST /v1/video/tasks 创建异步视频任务。Standard 支持首尾帧和最多三图参考；Fast 使用 frame 模式，适合更快的生成流程。

模型

模型	固定分辨率	时长	参考模式
adobe-veo-3.1-standard-720p	720p	4、6、8 秒	frame 最多 2 图；images 最多 3 图
adobe-veo-3.1-standard-1080p	1080p	4、6、8 秒	frame 最多 2 图；images 最多 3 图
adobe-veo-3.1-fast-720p	720p	4、6、8 秒	仅 frame，最多 2 图
adobe-veo-3.1-fast-1080p	1080p	4、6、8 秒	仅 frame，最多 2 图

所有模型只支持 16:9 和 9:16，并拒绝 output.resolution。

视频提示词最多 1200 个 Unicode 字符。output.generate_audio 控制成片音轨，省略时默认启用。

Standard images 的固定组合

Veo 3.1 Standard 使用 images 时必须同时设置 output.duration: 8 和 output.aspect_ratio: "16:9"。其他时长或 9:16 会在扣费和上游提交前返回 400。

查询当前 Token 可用的 Veo 模型：

curl -sS "$SUPERTOKEN_BASE_URL/v1/models" \
  -H "Authorization: Bearer $SUPERTOKEN_KEY" |
jq '.data[] | select(.id | startswith("adobe-veo-3.1"))'

模式选择

场景	模型	reference_mode	图片数量
文生视频或首/尾帧控制	Standard / Fast	frame	0-2 张
多图内容与风格参考	仅 Standard	images	1-3 张

frame 的图片顺序为首帧、尾帧。images 中的图片都是普通参考素材，不映射为首尾帧。

Veo 3.1 不支持 media，不要传参考视频或参考音频。

文档导航

页面	内容
异步任务与示例	Standard 帧模式、Standard 三图、Fast 和轮询示例
参数与错误	字段、组合限制、计费和错误处理
视频 Webhook	成功/失败事件、鉴权和接收代码

开始之前

export SUPERTOKEN_BASE_URL="https://api.supertoken.cc"
export SUPERTOKEN_KEY="YOUR_MODEL_API_TOKEN"
export RESOURCE_API_KEY="YOUR_RESOURCE_API_KEY"
export VIDEO_MODEL="adobe-veo-3.1-fast-720p"

最小示例

下面创建一个 4 秒、16:9 的 Veo Fast 任务：

curl -sS "$SUPERTOKEN_BASE_URL/v1/video/tasks" \
  -H "Authorization: Bearer $SUPERTOKEN_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: veo-fast-20260730-001" \
  -d '{
    "model": "'"$VIDEO_MODEL"'",
    "operation": "generation",
    "input": {
      "prompt": "清晨的山谷云海，镜头平稳向前推进",
      "reference_mode": "frame"
    },
    "output": {
      "duration": 4,
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }'

创建成功返回 202 Accepted。任务完成后，从 result.videos[] 读取 URL，并根据 url_auth 选择访问方式。

下一步

• Veo 异步任务与完整示例
• Veo 参数与错误
• 视频 Webhook