Come si usa l'API di Veo 3.1? Il primo video in 5 minuti

TL;DR

• Veo 3.1 è il modello di generazione video di Google, su HiAPI è disponibile in tre versioni: Standard, Fast e Lite, sia per la generazione video da testo che da immagine, apri la pagina del modello per generare online; i nuovi utenti ricevono 200 crediti alla registrazione.
• Fatturazione al secondo: Lite 720p senza audio $0.06 al secondo, Fast 720p/1080p con audio $0.25 al secondo, Standard $0.57 al secondo; una bozza Lite da 4 secondi costa solo $0.24.
• API in due passaggi: POST /v1/tasks per inviare, poi usa taskId per recuperare il risultato. I comandi curl e Python qui sotto si possono copiare ed eseguire subito.

Cosa può fare Veo 3.1?

• Audio nativo: immagine e suono vengono generati insieme, rumori ambientali, effetti sonori e suoni delle azioni seguono le immagini; generate_audio è attivo per impostazione predefinita, disattivarlo costa meno.
• Tre durate: 4, 6 e 8 secondi, orizzontale 16:9 o verticale 9:16.
• Fino a 4K: Standard e Fast supportano 720p, 1080p e 4K; Lite supporta 720p e 1080p.
• Video da immagine: carica un'immagine come primo fotogramma e il modello la anima; il formato può seguire l'immagine originale.

Il video verticale 1080p da 6 secondi qui sotto è stato generato con una singola richiesta a partire da una foto prodotto di una scarpa da ginnastica; il tonfo sordo dell'appoggio e i colpi di basso della batteria sono stati aggiunti dal modello:

The sneaker slowly rotates about 90 degrees as the camera pushes in from a low angle. Dust particles drift through the rim light. The shoe settles onto the wet stone pedestal with a deep, satisfying thud, sending a soft ring of mist rolling off the edges. A warm light sweep travels across the suede texture. Subtle bass-heavy electronic pulse builds in the background with a low whoosh on the landing. Cinematic product commercial, smooth stabilized motion, no text overlays.

Genera con questo prompt → (carica prima un'immagine prodotto in 9:16)

veo-3.1/image-to-video, 1080p, 6 secondi, con audio, $3.42, circa 115 secondi dall'invio al completamento.

Come scegliere tra le tre versioni?

Versione	720p/1080p con audio	720p/1080p senza audio	4K con audio	Ideale per
Lite veo-3.1-lite	$0.1 (720p) / $0.14 (1080p)	$0.06 (720p) / $0.1 (1080p)	—	Mettere a punto i prompt, bozze in batch
Fast veo-3.1-fast	$0.25	$0.17	$0.6	Video brevi per i social
Standard veo-3.1	$0.57	$0.29	$0.86	Pubblicità, film di brand

Tutte le tariffe sono al secondo. 8 secondi con audio: Lite 1080p $1.12, Fast $2, Standard $4.56. Per un conteggio più dettagliato vedi Prezzi dell'API Veo 3.1.

Due percorsi per iniziare

Prova online (senza scrivere codice)

1. Apri la pagina del modello Veo 3.1 Lite text-to-video, registrati o accedi.
2. Incolla il prompt, scegli durata, risoluzione e formato, decidi se vuoi l'audio.
3. Clicca su genera e scarica il video quando è pronto.

Chiamata API

1. Crea una API Key nella console.
2. POST https://api.hiapi.ai/v1/tasks per inviare il task, restituisce taskId.
3. GET /v1/tasks/{taskId} per controllare lo stato; quando status è success, scarica il video da output[0].url.

curl: il primo video

Inizia con il Lite, il più economico: 4 secondi 720p senza audio $0.24:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-lite/text-to-video",
    "input": {
      "prompt": "A matte-black wireless earbud case slowly rotates on a reflective black surface under a single overhead spotlight.",
      "duration": 4,
      "resolution": "720p",
      "aspect_ratio": "9:16",
      "generate_audio": false
    }
  }'

Risposta:

{"code": 200, "data": {"taskId": "tk-hiapi-..."}, "message": "success"}

Recupera il risultato:

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

Python: invio, polling, download

# pip install requests；prima esegui export HIAPI_KEY=la_tua_Key
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(prompt, model="veo-3.1-lite/text-to-video", timeout_s=900, **params):
    body = {"model": model, "input": {"prompt": prompt, **params}}
    # 重试提交同一个任务时带同一个 Idempotency-Key，避免重复扣费
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

url = generate(
    "A barista pours hot water in a slow spiral over ground coffee, steam rising in morning light",
    duration=4, resolution="720p", aspect_ratio="16:9", generate_audio=True,
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Una volta definito il prompt, sostituisci model con veo-3.1-fast/text-to-video o veo-3.1/text-to-video per ottenere il video finale, senza cambiare gli altri parametri.

Video da immagine

Sostituisci il nome del modello con …/image-to-video e aggiungi un'immagine in input (image_url è una stringa, accetta una sola immagine):

{
  "model": "veo-3.1/image-to-video",
  "input": {
    "prompt": "The sneaker slowly rotates and settles onto the wet stone pedestal with a deep thud",
    "image_url": "https://your-cdn.example.com/sneaker-916.jpg",
    "aspect_ratio": "auto",
    "resolution": "1080p",
    "duration": 6
  }
}

• aspect_ratio impostato su auto segue l'immagine originale; puoi anche specificare 16:9 o 9:16, le immagini con altri formati vengono ritagliate.
• Si consiglia un'immagine originale da almeno 720p, in 16:9 o 9:16; SVG non è supportato.
• Nel prompt descrivi "come si muove nei prossimi secondi", non serve ridescrizione l'intera immagine.

Da sapere prima di andare in produzione

• Usa i callback invece del polling: aggiungi al livello superiore della richiesta "callback": {"url": "https://tuo-dominio/hiapi/callback"}, HiAPI notifica attivamente al termine del task; deduplica per taskId.
• Salva subito: output[0].url è un link temporaneo, salvalo nel tuo storage appena lo ricevi.
• Specifica tutti i parametri: duration predefinito è 8 secondi, per Standard e Fast resolution è obbligatorio; indica esplicitamente durata, risoluzione e generate_audio per far coincidere i costi con il budget.
• Se non vuoi l'audio, disattivalo: con generate_audio: false, Lite 720p scende da $0.1 a $0.06 al secondo, Standard da $0.57 a $0.29.
• Rimborso automatico in caso di errore: paghi solo per i video generati con successo.

Domande frequenti

Posso scrivere il prompt in cinese?

Sì, sia in cinese che in inglese. Per risultati più stabili, scrivi in frasi separate inquadratura, azione e suono.

Posso generare un video da 10 secondi?

Una singola generazione supporta solo 4, 6 o 8 secondi. Per video più lunghi puoi generare più segmenti e montarli.

L'audio può essere controllato separatamente?

Nel prompt puoi specificare ogni livello sonoro (suoni d'azione in primo piano, voci ambientali, vento) e il modello li genera separatamente; se non vuoi l'audio, imposta generate_audio su false.

Se ho messo a punto il prompt con Lite, cosa devo cambiare per passare a Standard?

Solo il nome del modello. prompt, duration, aspect_ratio e generate_audio sono tutti compatibili; se vuoi il 4K, cambia resolution in 4k (Lite non ha il 4K).

Se cerchi prompt già pronti, vedi Esempi di prompt per Veo 3.1; puoi anche copiare il prompt della scarpa da ginnastica qui sopra e generare dalla pagina del modello.