Veo 3.1 Fast

ID:google/veo-3

Veo 3.1 Fast — modello video Veo 3.1 di Google DeepMind, veloce e conveniente, con audio nativo (dialoghi ed effetti sonori), image-to-video e risoluzione fino a 1080p.

Text to videoImage to videoGenerazione audio1080p

Panoramica

Veo 3.1 Fast — modello video Veo 3.1 di Google DeepMind, veloce e conveniente, con audio nativo (dialoghi ed effetti sonori), image-to-video e risoluzione fino a 1080p.

Autenticazione

Tutte le richieste API richiedono una chiave API valida passata tramite l'header Authorization con lo schema Bearer.

Avvio rapido

Credenziali

Imposta la variabile d'ambiente RUNBASE_API_KEY.

Shell

export RUNBASE_API_KEY=your-api-key

Crea un'esecuzione

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo-3",
    "input": {
      "prompt": "A cinematic product photo of a ceramic lamp"
    }
  }'

Esecuzioni

Le esecuzioni vengono elaborate in modo asincrono. Invia una richiesta, poi interroga per il risultato.

Crea un'esecuzione

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo-3",
    "input": { "prompt": "A cinematic product photo of a ceramic lamp" }
  }'

Stato dell'esecuzione

Shell

curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

Ottieni risultato

Interroga l'endpoint di stato finche status non e "succeeded", poi leggi output.urls dalla risposta.

Schema input

Parametro	Tipo	Obbligatorio	Descrizione
prompt	string	Obbligatorio	Prompt
aspect_ratio	string	Facoltativo	Aspect ratioOpzioni: `16:99:16`
resolution	string	Facoltativo	ResolutionOpzioni: `720p1080p`
image_urls	string[]	Facoltativo	Frame images

Schema output

Campo	Tipo	Descrizione
urls	string[]	URL degli output generati

Errori

L'API utilizza codici di stato HTTP standard per indicare successo o errore.

Codice di stato	Descrizione
400	Request không hợp lệ - thiếu hoặc sai định dạng tham số
401	Xác thực thất bại - thiếu hoặc sai khóa API
402	Không đủ tín dụng
403	Bị từ chối - IP không được phép hoặc khóa API vượt giới hạn chi tiêu
404	Không tìm thấy lượt chạy
429	Vượt giới hạn tốc độ
500	Lỗi máy chủ nội bộ