Veo-3.1 Fast

模型名称：veo-3.1-fast

面向快速出样、首尾帧驱动和高效率短视频生成
提交成功后返回视频任务 ID
当前按 default / standard 两个分组区分公开能力
default 组必须带参考图；standard 组允许纯文生，也支持首帧或首尾帧参考图
default 组支持 1-2 张图，固定 5 秒，当前公开规格为 720p
standard 组按 frame_pair 维护，支持 4、6、8 秒和 720p / 1080p / 4k

请求鉴权

所有接口均需要使用 Bearer Token 进行认证。

Authorization: Bearer YOUR_API_KEY

提交任务接口

POST /v1/videos

请求参数

字段	类型	必填	默认值	说明
`model`	`string`	是	-	固定传 `veo-3.1-fast`
`prompt`	`string`	是	-	视频生成提示词
`n`	`number`	否	`1`	当前仅支持传 `1`
`images`	`string[]`	按分组	-	`default` 组必须传 `1-2` 张；`standard` 组可不传，传入时最多 `2` 张
`duration`	`number`	否	`按分组能力处理`	`default` 固定 `5`；`standard` 支持 `4/6/8`
`aspect_ratio`	`string`	否	`按分组能力处理`	`default` 当前公开支持 `16:9 / 9:16`；`standard` 支持 `16:9 / 9:16`
`resolution`	`string`	否	`按分组能力处理`	`default` 当前固定公开为 `720p`；`standard` 支持 `720p / 1080p / 4k`
`reference_mode`	`string`	否	`按分组能力处理`	具体行为见下方分组表

standard 组可不传 images 进行纯文生；传图时，reference_mode 未传或传 frame_pair 均按首帧/首尾帧语义处理。不支持 video_urls、audio_urls、草稿、任务链和回调字段。

分组参数说明

以下只列不同分组之间存在差异的字段：

差异项	`standard` 组	`default` 组
生成形态	可纯文生；传图时按首帧或首尾帧处理	只支持参考图视频，不支持纯文生
`images`	可不传；传入时支持 `1-2` 张参考图	必须传 `1-2` 张参考图
`reference_mode`	传入时仅支持 `frame_pair`	默认按图片数量自动判定；第 `2` 张图为可选尾帧
`duration`	支持 `4 / 6 / 8`	固定 `5`
`aspect_ratio`	支持 `16:9 / 9:16`	支持 `16:9 / 9:16`
`resolution`	支持 `720p / 1080p / 4k`	当前固定公开为 `720p`

响应

提交成功响应示例：

{
  "id": "video_task_01KQEXAMPLE_VEO31_FAST",
  "object": "video",
  "model": "veo-3.1-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1711111111
}

提交失败响应示例：

{
  "error": {
    "code": 400,
    "type": "invalid_request_error",
    "message": "参数错误，请检查 prompt、images、duration、aspect_ratio、resolution 或 reference_mode 是否符合当前模型要求"
  }
}

任务查询接口

GET /v1/videos/{task_id}

查询成功示例：

{
  "id": "video_task_01KQEXAMPLE_VEO31_FAST",
  "object": "video",
  "model": "veo-3.1-fast",
  "status": "completed",
  "progress": 100,
  "metadata": {
    "duration": 6,
    "width": 1920,
    "height": 1080
  },
  "result_url": "https://example.com/result/veo31-fast-video.mp4"
}

使用示例

`default` 分组：单参考图快速出样

curl --request POST \
  --url https://api.aimaxa.cn/v1/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo-3.1-fast",
    "prompt": "让参考图中的产品快速推进到镜头中央，保持高光质感和背景节奏",
    "n": 1,
    "images": [
      "https://example.com/first-frame.jpg"
    ],
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

说明：

default 组当前固定 5 秒。
传 1 张图时，平台按单图参考语义处理。
default 组当前不建议显式切换 reference_mode。

`standard` 分组：首尾帧高规格生成

curl --request POST \
  --url https://api.aimaxa.cn/v1/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo-3.1-fast",
    "prompt": "让首帧中的产品沿着镜头轨迹快速推进，尾帧落在更明亮的舞台环境中",
    "n": 1,
    "images": [
      "https://example.com/first-frame.jpg",
      "https://example.com/last-frame.jpg"
    ],
    "duration": 6,
    "aspect_ratio": "9:16",
    "resolution": "1080p",
    "reference_mode": "frame_pair"
  }'

说明：

standard 组当前正式开放 4 / 6 / 8 秒。
standard 组建议显式传 aspect_ratio 与 resolution。
standard 组当前对外按 frame_pair 协议维护，至少要传首帧图。

注意事项

standard 组可纯文生；default 组必须提供至少 1 张参考图。
第 2 张参考图为可选尾帧，不传时平台只按首帧约束镜头延展。
default 组当前固定 5s + 720p；如需要更高规格，请使用 standard 组。
standard 组当前只正式开放 reference_mode=frame_pair。
顶层 size 与 aspect_ratio 兼容，二选一即可。
提交成功后请使用 GET /v1/videos/{task_id} 继续轮询结果。

异步状态与失败响应

视频任务状态只使用 queued、in_progress、completed、failed。处于 queued 或 in_progress 时继续调用查询接口；只有 completed 状态才读取顶层 result_url。任务失败时保持视频对象结构，并返回顶层 error 与 fail_reason，不要按图片接口读取 code/data/works：

{
  "id": "video_task_01KQEXAMPLE_FAILED",
  "object": "video",
  "model": "veo-3.1-fast",
  "status": "failed",
  "progress": 100,
  "error": {
    "code": "task_failed",
    "message": "请求处理失败，请稍后重试"
  },
  "fail_reason": "请求处理失败，请稍后重试"
}

开始使用

图像模型

视频模型

文本模型

Veo-3.1 Fast

请求鉴权

提交任务接口

请求参数

分组参数说明

响应

任务查询接口

使用示例

`default` 分组：单参考图快速出样

`standard` 分组：首尾帧高规格生成

注意事项

异步状态与失败响应

​请求鉴权

​提交任务接口

​请求参数

​分组参数说明

​响应

​任务查询接口

​使用示例

​default 分组：单参考图快速出样

​standard 分组：首尾帧高规格生成

​注意事项

​异步状态与失败响应

请求鉴权

提交任务接口

请求参数

分组参数说明

响应

任务查询接口

使用示例

`default` 分组：单参考图快速出样

`standard` 分组：首尾帧高规格生成

注意事项

异步状态与失败响应