API Veo 3: Prompts e roteiros por um único endpoint

Pré-requisitos e Autenticação

Antes de fazer sua primeira requisição, verifique se tem uma chave de API válida. Entre na página Obter chave de API com apenas e-mail e senha. Você recebe acesso imediato a $0,50 em crédito de teste, válido por 7 dias, sem precisar de cartão de crédito. Para cargas de trabalho em produção, recarregue com pelo menos $10 para garantir acesso contínuo.

Nossa URL base é https://api.veo3apis.com/v1.. Inclua sua chave de API no cabeçalho Authorization como token Bearer. Este endpoint é totalmente compatível com OpenAI, o que significa que você pode usar SDKs padrão apontando-os para nossa URL base.

Chat Básico

Envie uma requisição POST padrão para /v1/chat/completions para gerar texto. O ID do modelo é "uncensored". Isso retorna a resposta completa em um único objeto JSON, ideal para geração simples de prompts ou tarefas de escrita de roteiros onde você não precisa de atualizações em tempo real.

Integração SDK Python

Use o SDK Python oficial da OpenAI para uma integração limpa. Configure o cliente com nossa URL base e sua chave de API. Esta abordagem simplifica o tratamento de erros e a contagem de tokens para seus pipelines multimodais.

Integração SDK Node.js

Para projetos JavaScript/TypeScript, o SDK Node da OpenAI funciona imediatamente. Aponte o cliente para nossa URL base. Isso é útil para geração de scripts no lado do servidor ou etapas de pós-processamento no seu fluxo de trabalho Veo 3.

Respostas em Streaming (SSE)

Para latência percebida mais rápida, ative o streaming definindo stream: true. A API retorna um stream de Eventos Enviados pelo Servidor (SSE) de respostas parciais. Isso permite que seu aplicativo exiba tokens conforme são gerados, o que é crítico para geração de roteiros longos ou tarefas de raciocínio complexas.

Limites, Erros e Contexto

Suas requisições estão sujeitas a um limite de requisições de 300 requisições por minuto por chave. Se você exceder isso, receberá um erro 429. Falhas de autenticação retornam 401, e crédito insuficiente retorna 402. A janela de contexto é de 100.000 tokens no total (prompt + conclusão). Mantenha seus payloads abaixo de 8 MB. O único limite rígido de conteúdo é conteúdo sexual envolvendo menores, que é sempre bloqueado.

cURL

Copycurl https://api.veo3apis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.veo3apis.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.veo3apis.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Streaming

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)