PixMind Docs
API 参考视频模型Veo 3.1 视频生成

Veo 3.1 视频生成

通过 PixMind API 使用 Veo 3.1 生成电影感视频,支持同步音频。

电影感文生或图生视频,支持同步音频和首尾帧控制。

提供方

Google

模型 ID

veo-3.1

请求端点

POST /v1/generations

模型说明

  • 当前质量线路支持最长 8 秒视频。
  • 4K 使用更高的每秒计费档位。

请求参数

参数类型必填说明
modelstring

稳定的 PixMind 模型 ID,请使用 `veo-3.1`。

可选值: veo-3.1

promptstring

用于生成或编辑的自然语言指令。

resolutionstring

输出视频分辨率,该字段会影响每秒价格。

可选值: 720p, 1080p, 4K

默认值: 720p

durationinteger

期望生成的视频时长,单位为秒。

可选值: 5, 6, 8

默认值: 5

aspect_ratiostring

期望输出画面比例。

可选值: 16:9, 9:16, 1:1, 4:3, 3:4

默认值: 16:9

image_urlstring (URI)

图生视频使用的起始图片。

callback_urlstring (URI)

接收任务终态事件的 HTTPS 地址;不填写时仍可使用轮询。

last_frame_urlstring (URI)

与 image_url 配合使用的可选尾帧图片。

generate_audioboolean

在所选模式支持时生成同步音频。

可选值: true, false

默认值: true

请求示例

cURL
curl https://aihub-admin.aimix.pro/v1/generations \
  -H "Authorization: Bearer $PIXMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "veo-3.1",
  "prompt": "A cinematic product reveal with a slow camera push and synchronized studio ambience",
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}'
JavaScript
const response = await fetch("https://aihub-admin.aimix.pro/v1/generations", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.PIXMIND_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "veo-3.1",
  "prompt": "A cinematic product reveal with a slow camera push and synchronized studio ambience",
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "generate_audio": true
})
});

const task = await response.json();

任务受理响应

生成任务为异步处理。请保存响应中的 id,并轮询 GET /v1/generations/{id},直到任务进入终态。

202 Accepted
{
  "id": "img_01JXYZ...",
  "model": "veo-3.1",
  "status": "processing"
}

API 定价

配置价格
720p 或 1080p$0.360 / second
4K$0.520 / second

API 使用 apiPlatform 角色独立计费,与 PixMind Studio 积分分开;任务受理响应中的价格快照是最终计费依据。