Veo 3.1 è il modello di generazione video di Google per creare una breve scena audiovisiva da testo o da un brief guidato da immagini. Il profilo di produzione supporta text-to-video, image-to-video e creazione guidata dal primo e ultimo fotogramma, con suono generato, riferimenti di risorse e un flusso separato di continuazione. Usalo per sviluppare un concept cinematografico, una breve narrazione di prodotto o un segmento visivo con scena, azione ed esperienza d’ascolto definite.
Descrivi prima soggetto ed evento visibile. Stabilisci ambiente, momento della giornata e luce, poi definisci punto di vista o movimento della camera e stile visivo desiderato. Un brief originale di scena potrebbe mostrare un recipiente di vetro su una superficie scura da studio, con un lento movimento laterale che rivela un riflesso mentre un suono ambientale morbido accompagna la rivelazione. Ogni istruzione fornisce una caratteristica visibile o udibile valutabile nel risultato completato.
Il quadro di prompting di Google tratta soggetto, azione, scena, camera ed estetica come parti separate del brief. Usa le parti utili alla ripresa invece di aggiungere ogni possibile descrittore. Scrivi la direzione in inglese per il profilo di prompting documentato. Se la scena contiene varie azioni, indicane la relazione e mantienile proporzionate a una breve clip, affinché una rivelazione o una reazione restino leggibili.
Un’immagine iniziale stabilisce aspetto e composizione d’apertura. Usala quando personaggio, prodotto o ambientazione esistono già come risorsa visiva e descrivi il movimento che deve svilupparsi da essa. Un ultimo fotogramma aggiunge una composizione obiettivo per la conclusione. Prepara fotogrammi estremi che comunichino una transizione plausibile e conservino i dettagli identificativi del soggetto principale, poi ispeziona il movimento fra quei fotogrammi dopo la generazione.
I riferimenti di risorse hanno un altro scopo: guidano l’aspetto di un personaggio o oggetto in una scena appena generata, mentre i fotogrammi estremi definiscono momenti specifici di quella scena. Scegli riferimenti che mostrino i tratti visivi importanti e chiarisci il ruolo di ogni risorsa nel prompt. La specifica reference-image-to-video del modello di produzione usa output di otto secondi per quel flusso di riferimento, distinto dalla normale selezione di durata guidata da testo.
Il profilo ordinario di produzione del produttore genera clip di quattro, sei o otto secondi a 24 fotogrammi al secondo. Elenca inquadratura orizzontale 16:9 e verticale 9:16, fino a quattro video in uscita per prompt e risoluzioni d’output 720p, 1080p e 4K. Il formato video di output è MP4. La specifica guidata da immagini accetta JPEG o PNG, elenca un massimo dell’immagine in ingresso di 20 MB e supporta configurazioni d’ingresso 720p/1080p. Scegli il profilo d’output per la collocazione prevista e mantieni leggibile la composizione del fotogramma a quelle dimensioni.
Il suono nativo può accompagnare la scena visibile. Specifica battute pronunciate, atmosfera ed effetti sonori come parti dello stesso brief, nominando il soggetto o evento che produce ciascuno. Un’istruzione di dialogo e una di camera rispondono a domande diverse: una stabilisce l’interpretazione, l’altra come lo spettatore la vede. Mantieni le parole entro il tempo utile di parlato della clip e controlla intelligibilità del suono e relazione con l’azione.
Per una continuazione, il produttore offre un flusso separato di estensione video. Parti da una clip sorgente generata adatta e descrivi il successivo evento visibile o cambiamento della scena. Conserva segmento originale e continuato, così il loro punto di raccordo può essere controllato per aspetto, movimento e suono. Le normali scelte di durata e risoluzione della nuova generazione non vanno considerate un contratto universale per ogni operazione di estensione.
Una descrizione negativa può concentrare le esclusioni sui requisiti visivi dell’attività. Per una serie di variazioni di prodotto, mantieni stabili soggetto e composizione cambiando una sola direzione creativa, come illuminazione o distanza della camera. Registra prompt, riferimenti e impostazioni selezionate con il risultato. Questo consente di confrontare una differenza creativa utile anziché una raccolta di generazioni scollegate.
Il profilo di produzione Veo 3.1 regolare e Veo 3.1 Fast hanno profili di risoluzione d’output diversi. Fast elenca 720p e 1080p; il 3.1 regolare elenca anche 4K. Mantieni l’edizione scelta associata al risultato, senza sostituire implicitamente un identificatore di modello di produzione con un vecchio profilo Preview o un’altra generazione Veo. Sia l’aspetto di un soggetto sia l’operazione supportata dipendono dal flusso selezionato.
La generazione è un’operazione il cui risultato completato fornisce risorse video per riproduzione e montaggio successivo. Conserva i file restituiti con fotogrammi sorgente, risorse di riferimento e brief e preserva le informazioni di provenienza del contenuto fornite. Ispeziona ogni output effettivo per aspetto del soggetto, azione, inquadratura, suono e composizione finale. Usa la clip scelta come elemento di produzione, con titoli, transizioni o altre finiture aggiunti nel montaggio circostante.
", "aboutText": "Veo 3.1 è il modello di generazione video di Google per creare una breve scena audiovisiva da testo o da un brief guidato da immagini. Il profilo di produzione supporta text-to-video, image-to-video e creazione guidata dal primo e ultimo fotogramma, con suono generato, riferimenti di risorse e un flusso separato di continuazione. Usalo per sviluppare un concept cinematografico, una breve narrazione di prodotto o un segmento visivo con scena, azione ed esperienza d’ascolto definite.\n\nDescrivi prima soggetto ed evento visibile. Stabilisci ambiente, momento della giornata e luce, poi definisci punto di vista o movimento della camera e stile visivo desiderato. Un brief originale di scena potrebbe mostrare un recipiente di vetro su una superficie scura da studio, con un lento movimento laterale che rivela un riflesso mentre un suono ambientale morbido accompagna la rivelazione. Ogni istruzione fornisce una caratteristica visibile o udibile valutabile nel risultato completato.\n\nIl quadro di prompting di Google tratta soggetto, azione, scena, camera ed estetica come parti separate del brief. Usa le parti utili alla ripresa invece di aggiungere ogni possibile descrittore. Scrivi la direzione in inglese per il profilo di prompting documentato. Se la scena contiene varie azioni, indicane la relazione e mantienile proporzionate a una breve clip, affinché una rivelazione o una reazione restino leggibili.\n\nUn’immagine iniziale stabilisce aspetto e composizione d’apertura. Usala quando personaggio, prodotto o ambientazione esistono già come risorsa visiva e descrivi il movimento che deve svilupparsi da essa. Un ultimo fotogramma aggiunge una composizione obiettivo per la conclusione. Prepara fotogrammi estremi che comunichino una transizione plausibile e conservino i dettagli identificativi del soggetto principale, poi ispeziona il movimento fra quei fotogrammi dopo la generazione.\n\nI riferimenti di risorse hanno un altro scopo: guidano l’aspetto di un personaggio o oggetto in una scena appena generata, mentre i fotogrammi estremi definiscono momenti specifici di quella scena. Scegli riferimenti che mostrino i tratti visivi importanti e chiarisci il ruolo di ogni risorsa nel prompt. La specifica reference-image-to-video del modello di produzione usa output di otto secondi per quel flusso di riferimento, distinto dalla normale selezione di durata guidata da testo.\n\nIl profilo ordinario di produzione del produttore genera clip di quattro, sei o otto secondi a 24 fotogrammi al secondo. Elenca inquadratura orizzontale 16:9 e verticale 9:16, fino a quattro video in uscita per prompt e risoluzioni d’output 720p, 1080p e 4K. Il formato video di output è MP4. La specifica guidata da immagini accetta JPEG o PNG, elenca un massimo dell’immagine in ingresso di 20 MB e supporta configurazioni d’ingresso 720p/1080p. Scegli il profilo d’output per la collocazione prevista e mantieni leggibile la composizione del fotogramma a quelle dimensioni.\n\nIl suono nativo può accompagnare la scena visibile. Specifica battute pronunciate, atmosfera ed effetti sonori come parti dello stesso brief, nominando il soggetto o evento che produce ciascuno. Un’istruzione di dialogo e una di camera rispondono a domande diverse: una stabilisce l’interpretazione, l’altra come lo spettatore la vede. Mantieni le parole entro il tempo utile di parlato della clip e controlla intelligibilità del suono e relazione con l’azione.\n\nPer una continuazione, il produttore offre un flusso separato di estensione video. Parti da una clip sorgente generata adatta e descrivi il successivo evento visibile o cambiamento della scena. Conserva segmento originale e continuato, così il loro punto di raccordo può essere controllato per aspetto, movimento e suono. Le normali scelte di durata e risoluzione della nuova generazione non vanno considerate un contratto universale per ogni operazione di estensione.\n\nUna descrizione negativa può concentrare le esclusioni sui requisiti visivi dell’attività. Per una serie di variazioni di prodotto, mantieni stabili soggetto e composizione cambiando una sola direzione creativa, come illuminazione o distanza della camera. Registra prompt, riferimenti e impostazioni selezionate con il risultato. Questo consente di confrontare una differenza creativa utile anziché una raccolta di generazioni scollegate.\n\nIl profilo di produzione Veo 3.1 regolare e Veo 3.1 Fast hanno profili di risoluzione d’output diversi. Fast elenca 720p e 1080p; il 3.1 regolare elenca anche 4K. Mantieni l’edizione scelta associata al risultato, senza sostituire implicitamente un identificatore di modello di produzione con un vecchio profilo Preview o un’altra generazione Veo. Sia l’aspetto di un soggetto sia l’operazione supportata dipendono dal flusso selezionato.\n\nLa generazione è un’operazione il cui risultato completato fornisce risorse video per riproduzione e montaggio successivo. Conserva i file restituiti con fotogrammi sorgente, risorse di riferimento e brief e preserva le informazioni di provenienza del contenuto fornite. Ispeziona ogni output effettivo per aspetto del soggetto, azione, inquadratura, suono e composizione finale. Usa la clip scelta come elemento di produzione, con titoli, transizioni o altre finiture aggiunti nel montaggio circostante.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "66c9c26dfff266a6ee7aba8ec0380f9468ff4f8be871d6a7225ee8a729b29961", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "it", "methods": [ { "html": "google/veo-3.1Veo 3.1 è il modello video di Google per scene guidate da testo e immagini con suono generato, fotogrammi estremi guidati e risorse di riferimento. Il profilo di produzione offre clip di quattro, sei o otto secondi a 24 fps, con opzioni d’output fra cui 720p, 1080p e 4K.
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 è il modello di generazione video di Google per creare una breve scena audiovisiva da testo o da un brief guidato da immagini. Il profilo di produzione supporta text-to-video, image-to-video e creazione guidata dal primo e ultimo fotogramma, con suono generato, riferimenti di risorse e un flusso separato di continuazione. Usalo per sviluppare un concept cinematografico, una breve narrazione di prodotto o un segmento visivo con scena, azione ed esperienza d’ascolto definite.
Descrivi prima soggetto ed evento visibile. Stabilisci ambiente, momento della giornata e luce, poi definisci punto di vista o movimento della camera e stile visivo desiderato. Un brief originale di scena potrebbe mostrare un recipiente di vetro su una superficie scura da studio, con un lento movimento laterale che rivela un riflesso mentre un suono ambientale morbido accompagna la rivelazione. Ogni istruzione fornisce una caratteristica visibile o udibile valutabile nel risultato completato.
Il quadro di prompting di Google tratta soggetto, azione, scena, camera ed estetica come parti separate del brief. Usa le parti utili alla ripresa invece di aggiungere ogni possibile descrittore. Scrivi la direzione in inglese per il profilo di prompting documentato. Se la scena contiene varie azioni, indicane la relazione e mantienile proporzionate a una breve clip, affinché una rivelazione o una reazione restino leggibili.
Un’immagine iniziale stabilisce aspetto e composizione d’apertura. Usala quando personaggio, prodotto o ambientazione esistono già come risorsa visiva e descrivi il movimento che deve svilupparsi da essa. Un ultimo fotogramma aggiunge una composizione obiettivo per la conclusione. Prepara fotogrammi estremi che comunichino una transizione plausibile e conservino i dettagli identificativi del soggetto principale, poi ispeziona il movimento fra quei fotogrammi dopo la generazione.
I riferimenti di risorse hanno un altro scopo: guidano l’aspetto di un personaggio o oggetto in una scena appena generata, mentre i fotogrammi estremi definiscono momenti specifici di quella scena. Scegli riferimenti che mostrino i tratti visivi importanti e chiarisci il ruolo di ogni risorsa nel prompt. La specifica reference-image-to-video del modello di produzione usa output di otto secondi per quel flusso di riferimento, distinto dalla normale selezione di durata guidata da testo.
Il profilo ordinario di produzione del produttore genera clip di quattro, sei o otto secondi a 24 fotogrammi al secondo. Elenca inquadratura orizzontale 16:9 e verticale 9:16, fino a quattro video in uscita per prompt e risoluzioni d’output 720p, 1080p e 4K. Il formato video di output è MP4. La specifica guidata da immagini accetta JPEG o PNG, elenca un massimo dell’immagine in ingresso di 20 MB e supporta configurazioni d’ingresso 720p/1080p. Scegli il profilo d’output per la collocazione prevista e mantieni leggibile la composizione del fotogramma a quelle dimensioni.
Il suono nativo può accompagnare la scena visibile. Specifica battute pronunciate, atmosfera ed effetti sonori come parti dello stesso brief, nominando il soggetto o evento che produce ciascuno. Un’istruzione di dialogo e una di camera rispondono a domande diverse: una stabilisce l’interpretazione, l’altra come lo spettatore la vede. Mantieni le parole entro il tempo utile di parlato della clip e controlla intelligibilità del suono e relazione con l’azione.
Per una continuazione, il produttore offre un flusso separato di estensione video. Parti da una clip sorgente generata adatta e descrivi il successivo evento visibile o cambiamento della scena. Conserva segmento originale e continuato, così il loro punto di raccordo può essere controllato per aspetto, movimento e suono. Le normali scelte di durata e risoluzione della nuova generazione non vanno considerate un contratto universale per ogni operazione di estensione.
Una descrizione negativa può concentrare le esclusioni sui requisiti visivi dell’attività. Per una serie di variazioni di prodotto, mantieni stabili soggetto e composizione cambiando una sola direzione creativa, come illuminazione o distanza della camera. Registra prompt, riferimenti e impostazioni selezionate con il risultato. Questo consente di confrontare una differenza creativa utile anziché una raccolta di generazioni scollegate.
Il profilo di produzione Veo 3.1 regolare e Veo 3.1 Fast hanno profili di risoluzione d’output diversi. Fast elenca 720p e 1080p; il 3.1 regolare elenca anche 4K. Mantieni l’edizione scelta associata al risultato, senza sostituire implicitamente un identificatore di modello di produzione con un vecchio profilo Preview o un’altra generazione Veo. Sia l’aspetto di un soggetto sia l’operazione supportata dipendono dal flusso selezionato.
La generazione è un’operazione il cui risultato completato fornisce risorse video per riproduzione e montaggio successivo. Conserva i file restituiti con fotogrammi sorgente, risorse di riferimento e brief e preserva le informazioni di provenienza del contenuto fornite. Ispeziona ogni output effettivo per aspetto del soggetto, azione, inquadratura, suono e composizione finale. Usa la clip scelta come elemento di produzione, con titoli, transizioni o altre finiture aggiunti nel montaggio circostante.
POST /v1/videostextvideo| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti google/veo-3.1 | 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— |
Da testo a video · Obbligatorio: prompt
| 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"]}, {"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.
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.
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 |
| 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.8 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. |
| 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 $1.2 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.4 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. |
| 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.8 per secondo di video |
| 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 $1.6 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 →
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.
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.8 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 $1.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 fatturazioneopzione audio: without_audio | Costo Output · Prezzo del video $0.4 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.8 per secondo di video Riferimento di prezzo pubblicato per la configurazione mostrata. Gli addebiti finali seguono la configurazione effettivamente fatturata. |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "google/veo-3.1", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')\nPath('request.json').write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\nSalva 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.
Consulta l'attività originale esistente; non ripetere mai un invio dall'esito sconosciuto.
Numero massimo di output: 4.
| 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. |
| 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. |
Ailoot Ultra google/veo-3.1
/v1/videos/generations, /videos, /videos/generations