Veo

Veo 是面向真实运动、电影感镜头和短视频产品叙事的视频生成模型族。

支持时长：seconds 仅允许 4、6 或 8。

API 形式

操作	Endpoint	模式
视频生成任务	POST /v1/async/videos/generations	仅异步

视频生成只支持异步创建。Pixapi 会立即返回已提交的任务。

模型

模型 id	档位	说明
veo3.1-lite	Lite	成本最低。Google 官方不支持 4K。
veo3.1-fast	Fast	速度与质量平衡。
veo3.1-quality	Standard / Quality	最高质量。

价格

按 n × seconds × 单价(resolution) 计费。未传 resolution 时默认 720p。

模型	720p	1080p	4K
veo3.1-lite	4/秒	7/秒	7/秒*
veo3.1-fast	8/秒	10/秒	24/秒
veo3.1-quality	32/秒	32/秒	48/秒

* Lite 不支持 4K 输出；若请求 4K，按 1080p 单价计费。

示例：veo3.1-fast + 720p + seconds=8 + n=1 → 8 × 8 × 1 = 64 积分。

请求字段

字段	类型	必填	说明
model	string	是	veo3.1-lite、veo3.1-fast 或 veo3.1-quality。
prompt	string	是	描述场景、主体、运动和镜头。1–2000 字符。
seconds	integer	是	时长（秒），仅允许 4 / 6 / 8。
resolution	string	否	720p（默认）/ 1080p / 4k。
n	integer	否	输出条数，默认 1，范围 1–9。
image	string | string[]	否	图生视频时的公网 http(s) 图片 URL（jpg/jpeg/png/webp/gif）。
providerOptions	object	否	可选模型扩展参数。详见下方 providerOptions。

providerOptions

字段	类型	说明
aspect_ratio	string	画幅比例：16:9 或 9:16。

示例

cURL

curl https://api.pixapi.ai/v1/async/videos/generations \
  -H "Authorization: Bearer $PIXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "veo3.1-fast",
  "prompt": "咖啡馆桌上精品咖啡袋的缓慢环绕镜头",
  "n": 1,
  "seconds": 8,
  "resolution": "720p"
}'

Python

import os
import requests

response = requests.post(
    "https://api.pixapi.ai/v1/async/videos/generations",
    headers={
        "Authorization": f"Bearer {os.environ['PIXAPI_KEY']}",
        "Content-Type": "application/json",
    },
    json={
    "model": "veo3.1-fast",
    "prompt": "咖啡馆桌上精品咖啡袋的缓慢环绕镜头",
    "n": 1,
    "seconds": 8,
    "resolution": "720p"
},
)
response.raise_for_status()
task = response.json()
print(task["id"])

JavaScript

const response = await fetch('https://api.pixapi.ai/v1/async/videos/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PIXAPI_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "model": "veo3.1-fast",
  "prompt": "咖啡馆桌上精品咖啡袋的缓慢环绕镜头",
  "n": 1,
  "seconds": 8,
  "resolution": "720p"
}),
});

if (!response.ok) {
  throw new Error(await response.text());
}

const task = await response.json();
console.log(task.id);

Go

package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  body := []byte(`{
  "model": "veo3.1-fast",
  "prompt": "咖啡馆桌上精品咖啡袋的缓慢环绕镜头",
  "n": 1,
  "seconds": 8,
  "resolution": "720p"
}`)

  req, err := http.NewRequest(
    "POST",
    "https://api.pixapi.ai/v1/async/videos/generations",
    bytes.NewBuffer(body),
  )
  if err != nil {
    panic(err)
  }
  req.Header.Set("Authorization", "Bearer "+os.Getenv("PIXAPI_KEY"))
  req.Header.Set("Content-Type", "application/json")

  resp, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer resp.Body.Close()

  result, _ := io.ReadAll(resp.Body)
  fmt.Println(string(result))
}

响应

Pixapi 会返回已提交的任务。使用 GET /v1/tasks/{id} 轮询最终结果。

{
  "status": "submitted",
  "id": "task_01KPQ7J7DWB7QZ3WCEK3YVPBRA",
  "progress": 0,
  "created_at": 1703884800,
  "model": "veo3.1-fast"
}