API Veo 3: prompt e script su un unico endpoint

Prerequisiti e autenticazione

Prima di effettuare la tua prima richiesta, assicurati di avere una chiave API valida. Accedi alla pagina Ottieni chiave API con solo email e password. Ricevi accesso immediato a $0,50 di credito di prova, valido per 7 giorni, senza bisogno di carta di credito. Per carichi di lavoro di produzione, ricarica con almeno $10 per garantire l'accesso continuato.

Il nostro URL di base è https://api.veo3apis.com/v1.. Inserisci la tua chiave API nell'intestazione Authorization come token Bearer. Questo endpoint è completamente compatibile con OpenAI, il che significa che puoi utilizzare SDK standard puntandoli al nostro URL di base.

Chat completion di base

Invia una richiesta POST standard a /v1/chat/completions per generare testo. L'ID del modello è "uncensored". Questo restituisce l'intera risposta in un singolo oggetto JSON, ideale per la generazione semplice di prompt o la scrittura di script dove non sono necessari aggiornamenti in tempo reale.

Integrazione SDK Python

Utilizza l'SDK Python ufficiale di OpenAI per un'integrazione pulita. Configura il client con il nostro URL di base e la tua chiave API. Questo approccio semplifica la gestione degli errori e il conteggio dei token per le tue pipeline multimodali.

Integrazione SDK Node.js

Per i progetti JavaScript/TypeScript, l'SDK Node.js di OpenAI funziona out of the box. Punta il client al nostro URL di base. Questo è utile per la generazione di script lato server o per le fasi di post-processing nel tuo flusso di lavoro Veo 3.

Risposte in streaming (SSE)

Per una latenza percepita più rapida, abilita lo streaming impostando stream: true. L'API restituisce uno stream di Server-Sent Events (SSE) con risposte parziali. Questo permette alla tua applicazione di visualizzare i token man mano che vengono generati, il che è cruciale per la generazione di script lunghi o per attività di ragionamento complesso.

Limiti, errori e contesto

Le tue richieste sono soggette a un limite di richieste di 300 richieste al minuto per chiave. Se lo superi, ricevi un errore 429. I fallimenti di autenticazione restituiscono 401, e il credito insufficiente restituisce 402. La finestra di contesto è di 100.000 token in totale (prompt + completamento). Assicurati che i payload rimangano sotto 8 MB. L'unico limite rigido sui contenuti è il contenuto sessuale che coinvolge minori, che viene sempre bloccato.

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)