Google: Veo 3.1 Fast
Veo 3.1 Fast è il modello video di Google per brevi scene guidate da testo o immagini con suono generato. Il profilo di produzione restituisce clip MP4 di quattro, sei o otto secondi a 24 fps, con output in 720p o 1080p e fotogrammi iniziali o finali guidati.
Informazioni sul modello
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
Veo 3.1 Fast è il profilo di generazione video veloce di Google per una breve scena descritta nel testo o definita da un’immagine. Combina la ripresa visiva con suono generato e supporta fotogrammi iniziali e finali guidati. Usalo per sviluppare il concept di una scena, preparare brevi variazioni creative o realizzare un segmento audiovisivo compatto con azione e direzione visiva chiare.
Costruisci il brief attorno a soggetto, azione e ambientazione. Poi aggiungi inquadratura, movimento di camera, illuminazione e trattamento visivo che rendono utile la ripresa. Un brief originale di prodotto potrebbe mostrare una piccola lampada di ceramica su una scrivania di legno, con la camera che si avvicina lentamente mentre la luce si accende e un leggero suono d’interruttore accompagna l’azione. Soggetto ed evento visibile descrivono l’immagine; la direzione sonora descrive l’esperienza d’ascolto.
Scrivi la direzione della scena in inglese, come specificato dal profilo di prompting del produttore. Mantieni l’azione principale proporzionata alla durata della clip e distingui il movimento di camera da quello del soggetto. Una vista larga introduttiva, un primo piano di una texture e una ripresa che segue un oggetto in movimento rispondono a domande creative diverse. Scegli la vista che comunica il dettaglio desiderato invece di combinare direzioni di camera scollegate in una breve ripresa.
Per una scena guidata da immagini, prepara un’immagine iniziale chiara che stabilisca già aspetto e composizione. Il brief di movimento può quindi concentrarsi sull’evento successivo. Un fotogramma finale può fornire una destinazione visiva alla transizione. Mantieni coerenti dettagli importanti del soggetto e stile fra i fotogrammi oppure descrivi esplicitamente la trasformazione desiderata. Controlla la transizione stessa oltre all’immagine iniziale e finale.
Il profilo di produzione del produttore supporta clip di quattro, sei o otto secondi, inquadratura orizzontale 16:9 o verticale 9:16 e fino a quattro video in uscita per prompt. L’output Fast è in 720p o 1080p, a 24 fotogrammi al secondo, in formato MP4. Il profilo guidato da immagini accetta JPEG o PNG, elenca dimensioni massime dell’immagine in ingresso di 20 MB e supporta configurazioni d’ingresso 720p/1080p. Prepara la composizione per l’orientamento previsto e mantieni l’input entro quel limite delle immagini.
Il suono può fare parte della scena generata. Descrivi ogni battuta pronunciata, suono ambientale o effetto pertinente insieme all’azione visibile, identificando il soggetto che deve parlare e l’evento che deve produrre il suono. Mantieni il dialogo abbastanza breve per l’interpretazione desiderata e distinguilo da atmosfera o musica. La generazione audio segue il brief scritto della scena; una registrazione audio non rientra fra gli input normali documentati per questo profilo.
L’attuale profilo di produzione elenca anche generazione con riferimenti di risorse ed estensione video. I riferimenti guidano l’aspetto di un soggetto o oggetto, mentre i fotogrammi estremi guidano la composizione iniziale e finale. Scegli materiale di riferimento dal ruolo chiaro nella scena anziché trattare ogni immagine come controllo intercambiabile. Per continuare una clip, scegli il flusso separato di estensione e descrivi cosa deve accadere dopo l’azione esistente; la sua gestione degli input è distinta da una nuova ripresa guidata da testo.
Una descrizione negativa può identificare contenuti o trattamenti visivi da evitare. Mantieni il prompt principale concentrato sulla scena desiderata e rendi le esclusioni specifiche all’attività. Per una variazione di prodotto, conserva soggetto e inquadratura cambiando un dettaglio, come direzione della luce o trattamento del materiale. Conserva impostazioni e insieme dei riferimenti quando confronti i risultati, affinché la differenza creativa resti chiara.
Veo 3.1 Fast e il profilo Veo 3.1 regolare restano scelte distinte. L’output di produzione Fast documentato è 720p/1080p; il profilo regolare elenca anche 4K. Conserva l’edizione selezionata e le impostazioni d’output con il risultato invece di trattare un identificatore Preview o un’altra versione Veo come sinonimo automatico di questo profilo di produzione.
Il flusso crea un’operazione di generazione ed espone i file video restituiti dopo il completamento. Conserva ogni output effettivo selezionato per la revisione insieme a brief, fotogrammi sorgente e impostazioni pertinenti. Un identificatore di operazione è un registro della generazione; il file MP4 completato è ciò che si può riprodurre e usare nel montaggio. Conserva con il video tutti i metadati di provenienza del contenuto forniti.
Controlla aspetto del soggetto, azione richiesta, trattamento di camera e suono lungo l’intera clip. Verifica intelligibilità dei dialoghi e relazione fra suono ed eventi visibili prima di usarla in una composizione più lunga. Il risultato utile può essere una ripresa di concept, una presentazione di prodotto o un breve segmento narrativo, con titoli, transizioni e altre finiture aggiunti nel flusso di produzione circostante.
Ailoot Ultra · Video POST /v1/videos google/veo-3.1-fast
google/veo-3.1-fastIntroduzione
Veo 3.1 Fast è il modello video di Google per brevi scene guidate da testo o immagini con suono generato. Il profilo di produzione restituisce clip MP4 di quattro, sei o otto secondi a 24 fps, con output in 720p o 1080p e fotogrammi iniziali o finali guidati.
- Input accettati
- Testo
- Risultati
- Video
Disponibile in Ailoot · input e metodi
Ailoot Ultra · Video POST /v1/videos
- Tipi di input
text- Tipi di output
video- Formato di output
- mp4
- Numero di output
- Fino a 4 outputs
| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti google/veo-3.1-fast | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti Numero massimo di byte UTF-8: 10.000 Sono richiesti caratteri diversi dagli spazi: Sì | Predefinito— |
Campoduration | Tipointeger | RequisitoObbligatorio | Valori e limiti 4, 6, 8 | Predefinito— |
Camporesolution | Tipostring | RequisitoObbligatorio | Valori e limiti 720p | Predefinito— |
Campoaspect_ratio | Tipostring | RequisitoObbligatorio | Valori e limiti 16:9, 9:16 | Predefinito— |
Campogenerate_audio | Tipoboolean | RequisitoObbligatorio | Valori e limiti false, true | Predefinito— |
Combinazioni di materiali in input
Da testo a video · Obbligatorio: prompt
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, prompt, duration, resolution, aspect_ratio, generate_audio |
Parametroadditional_properties | Contrattofalse |
Parametroparameters | Contratto{"name":"model","type":"string","required":true,"enum":["google/veo-3.1-fast"]}, {"name":"prompt","type":"string","required":true,"non_whitespace":true,"max_utf8_bytes":10000}, {"name":"duration","type":"integer","required":true,"enum":[4,6,8]}, {"name":"resolution","type":"string","required":true,"enum":["720p"]}, {"name":"aspect_ratio","type":"string","required":true,"enum":["16:9","9:16"]}, {"name":"generate_audio","type":"boolean","required":true,"enum":[false,true]} |
Parametromaterial_types | Contrattotext |
Alias del metodo: /v1/videos/generations, /videos, /videos/generations
Ciclo di vita: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Conserva la risposta completa e gli ID originali restituiti.
Non inviare mai nuovamente una creazione dall'esito sconosciuto.
Tariffe
Calcolo del costo finale
Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
- Modalità rapida
- Non specificato Quando è selezionata la modalità rapida
- Modalità flex
- Non specificato Quando è selezionata la modalità flex
- Sforzo massimo di ragionamento
- Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)
Tariffe stimate per il confronto
Prezzi per configurazione
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Quantità prevista | Genera audio | Risoluzione | Unità di fatturazione | Condizioni di fatturazione | Costo |
|---|---|---|---|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Genera audio— | Risoluzione— | Unità di fatturazione— | Condizioni di fatturazione— | Costo Input · Token in input · Stima solo a fini di confronto — / 1K token Output · Token in output · Stima solo a fini di confronto — / 1K token Input · Lettura dalla cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto — / 1K token |
| ConfigurazionePrezzo del video | Listino delle tariffe— | Quantità prevista— | Genera audio— | Risoluzione— | Unità di fatturazioneper secondo di video | Condizioni di fatturazioneopzione audio: with_audio | Costo Output · Prezzo del video · Stima solo a fini di confronto $0.24 per secondo di video |
| ConfigurazionePrezzo del video | Listino delle tariffe— | Quantità prevista— | Genera audio— | Risoluzione— | Unità di fatturazioneper secondo di video | Condizioni di fatturazioneaudio: with_audio; risoluzione: 4k | Costo Output · Prezzo del video · Stima solo a fini di confronto $0.6 per secondo di video |
| ConfigurazioneUltra | Listino delle tariffe— | Quantità previstaConfigurazione richiesta; solo una stima. | Genera audioCon audio | Risoluzione720p | Unità di fatturazioneper secondo di video in output | Condizioni di fatturazione— | Costo Output · Secondo stimato di video in uscita · Stima solo a fini di confronto $0.2 per secondo di video in output La tariffa visualizzata stima il costo prima della generazione. L’addebito finale viene calcolato dal costo registrato per la generazione originale. La durata fisica del video non è la quantità fatturabile. |
| ConfigurazionePrezzo del video | Listino delle tariffe— | Quantità prevista— | Genera audio— | Risoluzione— | Unità di fatturazioneper secondo di video | Condizioni di fatturazioneopzione audio: without_audio | Costo Output · Prezzo del video · Stima solo a fini di confronto $0.2 per secondo di video |
| ConfigurazionePrezzo del video | Listino delle tariffe— | Quantità prevista— | Genera audio— | Risoluzione— | Unità di fatturazioneper secondo di video | Condizioni di fatturazioneaudio: without_audio; risoluzione: 4k | Costo Output · Prezzo del video · Stima solo a fini di confronto $0.5 per secondo di video |
| ConfigurazioneUltra | Listino delle tariffe— | Quantità previstaConfigurazione richiesta; solo una stima. | Genera audioSenza audio | Risoluzione720p | Unità di fatturazioneper secondo di video in output | Condizioni di fatturazione— | Costo Output · Secondo stimato di video in uscita · Stima solo a fini di confronto $0.16 per secondo di video in output La tariffa visualizzata stima il costo prima della generazione. L'addebito definitivo viene calcolato sul costo registrato per la generazione originale. La durata fisica del video non è la quantità fatturabile. |
| ConfigurazioneCosto stimato della generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Genera audio— | Risoluzione— | Unità di fatturazione— | Condizioni di fatturazione— | Costo Output · Costo di generazione stimato · Stima solo a fini di confronto $0.64 stima prima della generazione Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata. |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
Dettagli della tariffa di riferimento
I listini di riferimento del modello non modificano la selezione del metodo, i preventivi o gli addebiti. Gli addebiti attivi usano le tariffe del metodo Ailoot selezionato.
Riferimenti tariffari delle configurazioni video
Prezzi per configurazione
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Condizioni di fatturazione | Costo |
|---|---|---|
| ConfigurazionePrezzo del video | Condizioni di fatturazioneopzione audio: with_audio | Costo Output · Prezzo del video $0.24 per secondo di video Riferimento di prezzo pubblicato per la configurazione mostrata. Gli addebiti finali seguono la configurazione effettivamente fatturata. |
| ConfigurazionePrezzo del video | Condizioni di fatturazioneaudio: with_audio; risoluzione: 4k | Costo Output · Prezzo del video $0.6 per secondo di video Riferimento di prezzo pubblicato per la configurazione mostrata. Gli addebiti finali seguono la configurazione effettivamente fatturata. |
| ConfigurazionePrezzo del video | Condizioni di fatturazioneopzione audio: without_audio | Costo Output · Prezzo del video $0.2 per secondo di video Riferimento di prezzo pubblicato per la configurazione mostrata. Gli addebiti finali seguono la configurazione effettivamente fatturata. |
| ConfigurazionePrezzo del video | Condizioni di fatturazioneaudio: with_audio; risoluzione: 720p | Costo Output · Prezzo del video $0.2 per secondo di video Riferimento di prezzo pubblicato per la configurazione mostrata. Gli addebiti finali seguono la configurazione effettivamente fatturata. |
| ConfigurazionePrezzo del video | Condizioni di fatturazioneaudio: without_audio; risoluzione: 4k | Costo Output · Prezzo del video $0.5 per secondo di video Riferimento di prezzo pubblicato per la configurazione mostrata. Gli addebiti finali seguono la configurazione effettivamente fatturata. |
| ConfigurazionePrezzo del video | Condizioni di fatturazioneaudio: without_audio; risoluzione: 720p | Costo Output · Prezzo del video $0.16 per secondo di video Riferimento di prezzo pubblicato per la configurazione mostrata. Gli addebiti finali seguono la configurazione effettivamente fatturata. |
Esempi di richieste
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/veo-3.1-fast", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')
Path('request.json').write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Ricevi e salva i risultati
Ailoot Ultra · Video
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Verifica lo stato dell’attività
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Altre letture di contenuto
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Conserva tutti i risultati completati
Salva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito.
Conserva ogni URL firmato di tua proprietà in data[] completato e tutti i metadati dello stato. Salva ogni risultato, compreso l'audio generato. Può essere presente una traccia audio AAC valida anche con generate_audio=false; conserva l'intero MP4 originale, compreso l'audio.
Se occorre verificare la risposta originale
Consulta l'attività originale esistente; non ripetere mai un invio dall'esito sconosciuto.
Numero massimo di output: 4.
Campi della risposta
| Campo | Tipo | Significato |
|---|---|---|
Campoid | Tipostring | Significato— |
Campoobject | Tipostring | Significato— |
Campomodel | Tipostring | Significato— |
Campostatus | Tipostring | Significato— |
Campodata[] | Tiposigned content URL | Significato— |
Campocharge_pending_check | Tipoboolean | Significato— |
Campoerror.code | Tipostring | Significato— |
Campoerror.message | Tipostring | Significato— |
Campooperation_id | Tipostring | SignificatoRisposta HTTP503 result_pending_check dello stato o del contenuto originale: lo stesso ID video pubblico originale come id. |
Campoerror.type | Tipostring | Significatoserver_error su HTTP503 result_pending_check. |
Errori e passaggi successivi
| Risposta | Condizione | Passaggio successivo |
|---|---|---|
Risposta400 · invalid_request_error | CondizioneLa lettura del corpo grezzo della richiesta non riesce prima dell'analisi del profilo video | Passaggio successivoConserva la risposta restituita e correggi il corpo della richiesta illeggibile. |
Risposta422 · price_unavailable | CondizioneL'analisi del profilo video esatto non riesce oppure il profilo analizzato completo non dispone di una scheda tariffaria esatta pronta all'uso | Passaggio successivoConserva la risposta; usa il profilo completo esatto autorizzato e la relativa scheda pubblicata. Questo ramo viene eseguito prima dell'invio al fornitore. |
Risposta409 · video_not_ready | CondizioneContenuto del risultato originale non ancora disponibile | Passaggio successivoInterroga periodicamente l'ID originale restituito e rispetta Retry-After. |
Rispostaserver_error | CondizioneLa risposta restituita indica che l'operazione o il risultato richiede una verifica | Passaggio successivoConserva l'ID originale di operazione/task restituito, gli header della richiesta e la risposta; continua a leggere l'operazione originale tramite le modalità supportate. Non reinviare la richiesta di creazione. |
Risposta503 · result_pending_check | CondizioneGET dello stato o del contenuto originale: l'attività non è pubblicata, l'attività originale non è in stato failed/cancelled/expired e lo stato locale è unknown oppure lo stato dell'attività originale è completed. | Passaggio successivoConserva id e operation_id originali (lo stesso ID video pubblico), la risposta e le intestazioni; consulta solo lo stato o il contenuto originale. Non inviare mai una nuova richiesta di generazione. |
Alias
Alias del modello
Ailoot Ultra google/veo-3.1-fast
Alias dei percorsi dei metodi
/v1/videos/generations, /videos, /videos/generations
ID di chiamata correlati
FAQ · Google: Veo 3.1 Fast
- Quali input e risultati sono disponibili?
POST /v1/videos·google/veo-3.1-fast:text→video- Quali campi usa la richiesta?
POST /v1/videos·google/veo-3.1-fast:model,prompt,duration,resolution,aspect_ratio,generate_audio