Veo

Veo é uma família de modelos de geração de vídeo para movimento realista, movimento de câmera cinematográfico e narrativa curta de produtos.

Durações suportadas: seconds deve ser 4, 6 ou 8.

Superfície da API

Operação	Endpoint	Modo
Tarefa de geração de vídeo	POST /v1/async/videos/generations	Apenas assíncrono

A geração de vídeo é apenas assíncrona. A Pixapi retorna uma tarefa enviada imediatamente.

Modelos

ID do modelo	Nível	Observações
veo3.1-lite	Lite	Menor custo. O Google não oferece suporte a 4K.
veo3.1-fast	Fast	Equilíbrio entre velocidade e qualidade.
veo3.1-quality	Standard / Quality	Máxima qualidade.

Preços

Cobrado como n × seconds × taxa(resolution) créditos. A resolução padrão é 720p.

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

* Lite não oferece saída 4K; se solicitado, aplica-se a taxa 1080p.

Exemplo: veo3.1-fast + 720p + seconds=8 + n=1 → 8 × 8 × 1 = 64 créditos.

Campos da solicitação

Campo	Tipo	Obrigatório	Descrição
model	string	Sim	Um de veo3.1-lite, veo3.1-fast ou veo3.1-quality.
prompt	string	Sim	Descreva a cena, o sujeito, o movimento e a câmera. 1–2000 caracteres.
seconds	integer	Sim	Duração em segundos. Apenas 4, 6 ou 8.
resolution	string	Não	720p (padrão), 1080p ou 4k.
n	integer	Não	Número de saídas. Padrão 1, intervalo 1–9.
image	string | string[]	Não	URL pública http(s) para imagem para vídeo (jpg/jpeg/png/webp/gif).
providerOptions	object	Não	Extensões opcionais do modelo. Veja providerOptions abaixo.

providerOptions

Campo	Tipo	Descrição
aspect_ratio	string	Proporção da saída: 16:9 ou 9:16.

Exemplo

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": "A slow dolly shot around a premium coffee bag on a cafe table",
  "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": "A slow dolly shot around a premium coffee bag on a cafe table",
    "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": "A slow dolly shot around a premium coffee bag on a cafe table",
  "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": "A slow dolly shot around a premium coffee bag on a cafe table",
  "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))
}

Resposta

A Pixapi retorna uma tarefa enviada. Consulte GET /v1/tasks/{id} para o resultado final.

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