veo 视频生成 API 调用教程

本文将详细介绍如何通过 bestapi.aqi.email 域名下的 /v1/video/create 接口创建视频，包含接口参数说明、请求示例及响应解析，帮助你快速上手调用。

一、接口基础信息

项目	内容
请求地址	`http://bestapi.aqi.email/v1/video/create`
请求方法	POST
核心功能	调用 veo 系列模型生成视频，支持文生视频、首/尾帧控制、图片素材融入等
认证方式	可选 Bearer Token（请求头携带 `Authorization: Bearer {{YOUR_API_KEY}}`）
支持格式	请求/响应均为 JSON 格式

二、请求头参数

调用接口时需在请求头中携带以下参数，确保请求格式和权限合规。

参数名	必选	示例值	说明
`Content-Type`	是	`application/json`	固定值，指定请求体格式
`Accept`	是	`application/json`	固定值，指定响应体格式
`Authorization`	否	`Bearer abc123def456`	认证令牌，部分场景需携带

三、请求体参数（核心）

请求体为 JSON 对象，需包含必填参数和根据需求选择的可选参数，以下是详细说明。

3.1 必选参数

这两个参数是生成视频的基础，必须在请求体中填写。

参数名	类型	说明
`model`	string	视频生成模型，需从指定枚举中选择（见 3.3 模型列表）
`prompt`	string	视频生成提示词，veo 模型默认支持英文；若用中文，需开启 `enhance_prompt`

3.2 可选参数

根据生成需求选择配置，可实现中文提示词转换、画质提升、帧控制等功能。

参数名	类型	可选值	说明
`enhance_prompt`	boolean	`true`/`false`	开启后自动将中文提示词转为英文（因 veo 模型默认支持英文）
`enable_upsample`	boolean	`true`/`false`	开启后提升视频画质（部分模型生效）
`images`	array	图片 URL 列表	用于帧控制或素材融入，数量限制随模型变化（见 3.3 模型列表）
`aspect_ratio`	string	`16:9`/`9:16`	仅 veo3 系列模型支持，指定视频宽高比

3.3 veo 模型列表（含功能差异）

不同模型支持的功能、画质、速度不同，需根据需求选择，关键差异如下：

模型名称	核心特点	支持 `images` 数量	是否带音频
`veo2` / `veo2-fast`	基础文生视频，veo2-fast 速度更快	0	否
`veo2-fast-frames`	支持首帧+尾帧控制（需传 2 张图片）	最多 2 张	否
`veo2-fast-components`	支持 3 张图片作为视频元素（如背景、天空等）	最多 3 张	否
`veo2-pro` / `veo2-pro-components`	高质量模式（价格高），后者支持 3 张图片素材融入	0 / 最多 3 张	否
`veo3` / `veo3-fast`	支持自动生成音频，veo3-fast 性价比高（质量好、价格低）	0	是
`veo3-fast-frames` / `veo3-frames`	支持首帧控制（需传 1 张图片），带自动音频	最多 1 张	是
`veo3-pro` / `veo3-pro-frames`	超高画质（价格高），后者支持首帧控制，带自动音频	0 / 最多 1 张	是
`veo3.1` / `veo3.1-fast` / `veo3.1-pro`	自适应首帧+文生视频，带自动音频，pro 版画质最高	0 或 1 张	是

四、完整请求示例

以下是调用 veo3.1-fast 模型生成 16:9 视频的示例，包含中文提示词转换和画质提升。

{
  "model": "veo3.1-fast",
  "prompt": "一只卡通兔子在草地上跳，背景是蓝天白云，阳光明媚",
  "enhance_prompt": true,  // 中文转英文
  "enable_upsample": true, // 提升画质
  "aspect_ratio": "16:9",  // 宽高比（仅 veo3 系列支持）
  "images": []             // 此模型可选填首帧，这里未使用
}

请求头配置：

Content-Type: application/json
Accept: application/json
Authorization: Bearer {{YOUR_API_KEY}}  // 若需认证则携带

五、响应解析（200 成功）

接口返回 200 状态码时，表示请求已受理，可通过返回的 id 跟踪视频生成状态。

5.1 响应参数说明

参数名	类型	说明
`id`	string	视频任务 ID，用于后续查询生成进度或获取视频文件
`status`	string	任务状态，常见值：`pending`（排队中）、`processing`（生成中）、`completed`（完成）
`status_update_time`	integer	状态更新时间戳（毫秒级）
`enhanced_prompt`	string	若开启 `enhance_prompt`，则返回转换后的英文提示词

5.2 响应示例

{
  "id": "veo3-fast-frames:1757555257-PORrVn9sa9",
  "status": "pending",
  "status_update_time": 1757555257582,
  "enhanced_prompt": "A cartoon rabbit jumping on the grass, with blue sky and white clouds in the background, bright sunshine"
}

六、注意事项

模型功能匹配：若需控制首/尾帧或融入图片，需选择带 frames 或 components 后缀的模型，否则 images 参数无效。

提示词有效性：若未开启 enhance_prompt，prompt 必须为英文，否则可能生成不符合预期的视频。

宽高比限制：aspect_ratio 仅支持 veo3 及以上系列模型，veo2 系列模型不生效。

veo 视频生成 API 调用教程

veo 视频生成 API 调用教程#

一、接口基础信息#

二、请求头参数#

三、请求体参数（核心）#

3.1 必选参数#

3.2 可选参数#

3.3 veo 模型列表（含功能差异）#

四、完整请求示例#

五、响应解析（200 成功）#

5.1 响应参数说明#

5.2 响应示例#

六、注意事项#

veo 视频生成 API 调用教程

一、接口基础信息

二、请求头参数

三、请求体参数（核心）

3.1 必选参数

3.2 可选参数

3.3 veo 模型列表（含功能差异）

四、完整请求示例

五、响应解析（200 成功）

5.1 响应参数说明

5.2 响应示例

六、注意事项