Google: Veo 3.1

Veo 3.1 je videomodel Google pre scény vedené textom a obrázkami s generovaným zvukom, vedenými hraničnými snímkami a referenčnými podkladmi. Jeho produkčný profil poskytuje štvor-, šesť- alebo osemsekundové klipy pri 24 snímkach za sekundu s možnosťami výstupu vrátane 720p, 1080p a 4K.

Ailoot Ultra · Video POST /v1/videos google/veo-3.1

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

Veo 3.1 je model Google na generovanie videa pre tvorbu krátkej audiovizuálnej scény z textu alebo zadania vedeného obrázkom. Jeho produkčný profil podporuje text-to-video, image-to-video a vedenú tvorbu z prvej/poslednej snímky s generovaným zvukom, referenčnými podkladmi a samostatným postupom pokračovania. Použite ho na rozvíjanie filmového konceptu, krátkeho produktového príbehu alebo vizuálneho segmentu s definovanou scénou, akciou a posluchovým zážitkom.

Najprv opíšte subjekt a viditeľnú udalosť. Určte okolie, denný čas a svetlo a potom definujte uhol či pohyb kamery a zamýšľaný vizuálny štýl. Pôvodné zadanie scény môže zobrazovať sklenenú nádobu na tmavom štúdiovom povrchu s pomalým bočným pohybom odhaľujúcim odraz, zatiaľ čo odhalenie sprevádza jemný zvuk prostredia. Každý pokyn dáva viditeľnú alebo počuteľnú vlastnosť, ktorú možno posúdiť v dokončenom výsledku.

Rámec zadávania Google chápe subjekt, akciu, scénu, kameru a estetiku ako samostatné časti zadania. Použite časti slúžiace záberu namiesto pridávania všetkých možných opisných prvkov. Pre dokumentovaný profil zadania píšte pokyny v angličtine. Ak scéna obsahuje viacero akcií, určte ich vzťah a udržte ich primerané krátkemu klipu, aby odhalenie alebo reakcia zostali čitateľné.

Úvodný obrázok určuje počiatočný vzhľad a kompozíciu. Použite ho, keď postava, produkt či prostredie už existuje ako vizuálny podklad, a opíšte pohyb, ktorý sa má z neho rozvinúť. Posledná snímka pridáva cieľovú kompozíciu pre koniec. Pripravte hraničné snímky komunikujúce vierohodný prechod a zachovávajúce detaily identifikujúce hlavný subjekt a po generovaní skontrolujte pohyb medzi nimi.

Referenčné podklady slúžia inému účelu: usmerňujú vzhľad postavy či predmetu v novo generovanej scéne, zatiaľ čo hraničné snímky definujú konkrétne okamihy tejto scény. Vyberajte referencie ukazujúce dôležité vizuálne črty a úlohu každého podkladu jasne určte v zadaní. Špecifikácia reference-image-to-video produkčného modelu používa pre tento referenčný postup osemsekundový výstup, oddelený od bežného výberu dĺžky pri textovom zadaní.

Bežný produkčný profil výrobcu generuje klipy s dĺžkou štyri, šesť alebo osem sekúnd pri 24 snímkach za sekundu. Uvádza rámovanie 16:9 na šírku a 9:16 na výšku, až štyri videovýstupy na zadanie a výstupné rozlíšenia 720p, 1080p a 4K. Formát výstupného videa je MP4. Jeho špecifikácia vedená obrázkom prijíma JPEG alebo PNG, uvádza maximum vstupného obrázka 20 MB a podporuje vstupné konfigurácie 720p/1080p. Výstupný profil vyberte pre zamýšľané umiestnenie a kompozíciu snímok udržte pri tejto veľkosti čitateľnú.

Natívny zvuk môže sprevádzať viditeľnú scénu. Hovorené repliky, atmosféru a zvukové efekty určte ako časti rovnakého zadania a pomenujte subjekt alebo udalosť, ktorá každý z nich vytvára. Pokyn na dialóg a pokyn na kameru odpovedajú na rôzne otázky: jeden určuje výkon, druhý spôsob, akým ho divák vidí. Slová udržte v rámci využiteľného času reči v klipe a zvuk kontrolujte z hľadiska zrozumiteľnosti aj vzťahu k akcii.

Pre pokračovanie výrobca poskytuje samostatný postup predĺženia videa. Začnite vhodným generovaným zdrojovým klipom a opíšte ďalšiu viditeľnú udalosť alebo zmenu scény. Uchovajte pôvodný aj pokračujúci segment, aby sa ich spoj dal skontrolovať z hľadiska vzhľadu, pohybu a zvuku. Bežné voľby dĺžky a rozlíšenia nového generovania nemožno chápať ako univerzálny kontrakt pre každú operáciu predĺženia.

Negatívny opis môže sústrediť vylúčenia na vizuálne požiadavky úlohy. Pri sérii produktových variácií zachovajte stabilný subjekt a kompozíciu a meňte jediný tvorivý smer, napríklad osvetlenie alebo vzdialenosť kamery. Zadanie, referencie a vybrané nastavenia zaznamenajte spolu s výsledkom. Vďaka tomu možno porovnávať užitočný tvorivý rozdiel namiesto zbierky nesúvisiacich generovaní.

Bežný produkčný profil Veo 3.1 a Veo 3.1 Fast majú odlišné profily výstupného rozlíšenia. Fast uvádza 720p a 1080p; bežný 3.1 aj 4K. Zvolenú edíciu uchovajte pri výsledku bez tichého nahradenia identifikátora produkčného modelu starším profilom Preview alebo inou generáciou Veo. Vzhľad subjektu aj podporovaná operácia závisia od vybraného postupu.

Generovanie je operácia, ktorej dokončený výsledok poskytuje videovýstupy na prehrávanie a neskorší strih. Vrátené súbory uchovajte so zdrojovými snímkami, referenčnými podkladmi a zadaním a zachovajte dodané informácie o pôvode obsahu. Každý skutočný výstup skontrolujte z hľadiska vzhľadu subjektu, akcie, rámovania, zvuku a konečnej kompozície. Vybraný klip použite ako produkčný stavebný prvok s titulkami, prechodmi či ďalšími dokončovacími úpravami pridanými v okolnom strihu.

Ailoot Ultra · Video POST /v1/videos google/veo-3.1

google/veo-3.1

Google /google/veo-3.1

Úvod

Povolené vstupy: Text
Výsledky: Video

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · Video POST /v1/videos

Vstup: text
Výstup: video
Výstupný formát: mp4
Počet výstupov: Do 4 výstups

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity google/veo-3.1	Predvolené—
Pole`prompt`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity Maximálny počet bajtov UTF-8: 10 000 Vyžaduje sa aspoň jeden znak, ktorý nie je bielym znakom: Áno	Predvolené—
Pole`duration`	Typ`integer`	PožiadavkaPovinné	Hodnoty a limity 4, 6, 8	Predvolené—
Pole`resolution`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity 720p	Predvolené—
Pole`aspect_ratio`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity 16:9, 9:16	Predvolené—
Pole`generate_audio`	Typ`boolean`	PožiadavkaPovinné	Hodnoty a limity false, true	Predvolené—

Kombinácie vstupných podkladov

Z textu na video · Povinné: prompt

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`content_type`	Špecifikáciaapplication/json
Parameter`required`	Špecifikáciamodel, prompt, duration, resolution, aspect_ratio, generate_audio
Parameter`additional_properties`	Špecifikáciafalse
Parameter`parameters`	Špecifikácia{"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]}
Parameter`material_types`	Špecifikáciatext

Aliasy metódy: /v1/videos/generations, /videos, /videos/generations

Životný cyklus: 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

Zachovajte celú odpoveď a pôvodné vrátené ID.

Vytvorenie s neznámym výsledkom nikdy znova neodosielajte.

Cenník

Ako sa vypočíta konečný poplatok

Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim: Neuvedené Keď je zvolený rýchly režim
Režim Flex: Neuvedené Keď je zvolený režim flex
Maximálna úroveň uvažovania: Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)

Odhadované sadzby na porovnanie

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

Konfigurácia	Sadzobník	Odhadované množstvo	Generovať audio	Rozlíšenie	Účtovacia jednotka	Podmienky účtovania	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Odhadované množstvo—	Generovať audio—	Rozlíšenie—	Účtovacia jednotka—	Podmienky účtovania—	Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov
KonfiguráciaUltra	Sadzobník—	Odhadované množstvoPožadované nastavenie; iba odhad.	Generovať audioS audiom	Rozlíšenie720p	Účtovacia jednotkaza sekundu výstupného videa	Podmienky účtovania—	Poplatok Výstup · Odhadovaná sekunda výstupného videa · Odhad iba na porovnanie $0.8 za sekundu výstupného videa Zobrazená sadzba odhaduje náklady pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Fyzická dĺžka videa nie je účtovaným množstvom.
KonfiguráciaCena videa	Sadzobník—	Odhadované množstvo—	Generovať audio—	Rozlíšenie—	Účtovacia jednotkaza sekundu videa	Podmienky účtovaniazvuk: with_audio; rozlíšenie: 4k	Poplatok Výstup · Cena videa · Odhad iba na porovnanie $1.2 za sekundu videa
KonfiguráciaUltra	Sadzobník—	Odhadované množstvoPožadované nastavenie; iba odhad.	Generovať audioBez audia	Rozlíšenie720p	Účtovacia jednotkaza sekundu výstupného videa	Podmienky účtovania—	Poplatok Výstup · Odhadovaná sekunda výstupného videa · Odhad iba na porovnanie $0.4 za sekundu výstupného videa Zobrazená sadzba odhaduje náklady pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Fyzická dĺžka videa nie je účtovaným množstvom.
KonfiguráciaCena videa	Sadzobník—	Odhadované množstvo—	Generovať audio—	Rozlíšenie—	Účtovacia jednotkaza sekundu videa	Podmienky účtovaniazvuk: without_audio; rozlíšenie: 4k	Poplatok Výstup · Cena videa · Odhad iba na porovnanie $0.8 za sekundu videa
KonfiguráciaOdhadované náklady na generovanie	Sadzobník—	Odhadované množstvoodhad pre jedno generovanie	Generovať audio—	Rozlíšenie—	Účtovacia jednotka—	Podmienky účtovania—	Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $1.6 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie.

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Podrobnosti referenčnej tarify

Referenčné sadzobníky modelu nemenia výber metódy, cenové odhady ani poplatky. Aktívne poplatky používajú sadzby vybranej metódy Ailoot.

Cenové referencie konfigurácií videa

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

Konfigurácia	Podmienky účtovania	Poplatok
KonfiguráciaCena videa	Podmienky účtovaniazvuk: with_audio	Poplatok Výstup · Cena videa $0.8 za sekundu videa Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou.
KonfiguráciaCena videa	Podmienky účtovaniazvuk: with_audio; rozlíšenie: 4k	Poplatok Výstup · Cena videa $1.2 za sekundu videa Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou.
KonfiguráciaCena videa	Podmienky účtovaniazvuk: without_audio	Poplatok Výstup · Cena videa $0.4 za sekundu videa Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou.
KonfiguráciaCena videa	Podmienky účtovaniazvuk: without_audio; rozlíšenie: 4k	Poplatok Výstup · Cena videa $0.8 za sekundu videa Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou.

Príklady požiadaviek

Ailoot Ultra · Video

curl · presne podľa nastaveného profilu

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", "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

Prijať a uložiť výsledky

Ailoot Ultra · Video

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Skontrolovať stav úlohy

GET stav pôvodnej operácie

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

Čítanie ďalšieho obsahu

Uložiť každý dokončený výstup, ktorý vám patrí

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

Uchovať všetky dokončené výsledky

Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.

Zachovajte každú podpísanú URL vo vašom vlastníctve v dokončenom data[] a všetky metadáta stavu. Uložte každý výstup vrátane jeho vygenerovaného zvuku. Platná zvuková stopa AAC môže byť prítomná aj pri generate_audio=false; zachovajte celý pôvodný MP4 vrátane tohto zvuku.

Ak treba overiť pôvodnú odpoveď

Načítajte existujúcu pôvodnú úlohu; odoslanie s neznámym výsledkom nikdy neopakujte.

Maximálny počet výstupov: 4.

Polia odpovede

Pole	Typ	Význam
Pole`id`	Typstring	Význam—
Pole`object`	Typstring	Význam—
Pole`model`	Typstring	Význam—
Pole`status`	Typstring	Význam—
Pole`data[]`	Typsigned content URL	Význam—
Pole`charge_pending_check`	Typboolean	Význam—
Pole`error.code`	Typstring	Význam—
Pole`error.message`	Typstring	Význam—
Pole`operation_id`	Typstring	VýznamPôvodná odpoveď stavu alebo obsahu HTTP503 result_pending_check: rovnaké pôvodné verejné ID videa ako id.
Pole`error.type`	Typstring	Významserver_error pri HTTP503 result_pending_check.

Chyby a ďalšie kroky

Odpoveď	Podmienka	Ďalší krok
Odpoveď400 · `invalid_request_error`	PodmienkaNačítanie nespracovaného tela požiadavky zlyhá pred parsovaním profilu videa	Ďalší krokZachovajte vrátenú odpoveď a opravte nečitateľné telo požiadavky.
Odpoveď422 · `price_unavailable`	PodmienkaParsovanie presného profilu videa zlyhá alebo úplný parsovaný profil nemá pripravenú presnú cenovú kartu	Ďalší krokZachovajte odpoveď; použite úplný presný povolený profil a jeho zverejnenú kartu. Táto vetva sa vykonáva pred odoslaním poskytovateľovi.
Odpoveď409 · `video_not_ready`	PodmienkaPôvodný obsah výsledku zatiaľ nie je dostupný	Ďalší krokPriebežne zisťujte stav pomocou pôvodne vráteného ID a rešpektujte Retry-After.
Odpoveď`server_error`	PodmienkaVrátená odpoveď uvádza, že operáciu alebo výsledok je potrebné skontrolovať	Ďalší krokUchovajte pôvodné vrátené ID operácie/úlohy, hlavičky požiadavky a odpoveď; naďalej čítajte údaje o tejto pôvodnej operácii podporovaným spôsobom. Požiadavku na vytvorenie znova neodosielajte.
Odpoveď503 · `result_pending_check`	PodmienkaGET pôvodného stavu alebo obsahu: úloha nie je zverejnená, pôvodná úloha nemá stav failed/cancelled/expired a miestny stav je unknown alebo je stav pôvodnej úlohy completed.	Ďalší krokZachovajte pôvodné id a operation_id (rovnaké verejné ID videa), odpoveď a hlavičky; načítavajte iba pôvodný stav alebo obsah. Nikdy neodosielajte novú požiadavku na generovanie.

Aliasy

Aliasy modelov

Ailoot Ultra google/veo-3.1

Aliasy ciest metód

/v1/videos/generations, /videos, /videos/generations

Súvisiace ID na volanie

google/veo-3.1

FAQ · Google: Veo 3.1

Aké vstupy a výsledky sú dostupné?: POST /v1/videos · google/veo-3.1: text → video
Aké polia používa požiadavka?: POST /v1/videos · google/veo-3.1: model, prompt, duration, resolution, aspect_ratio, generate_audio

Google: Veo 3.1

Google: Veo 3.1

Úvod

Dostupné v Ailoot · vstupy a metódy

Cenník

Ako sa vypočíta konečný poplatok

Odhadované sadzby na porovnanie

Ceny podľa konfigurácie

Podrobnosti referenčnej tarify

Ceny podľa konfigurácie

Príklady požiadaviek

Ailoot Ultra · Video

Prijať a uložiť výsledky

Ailoot Ultra · Video

Skontrolovať stav úlohy

Uchovať všetky dokončené výsledky

Ak treba overiť pôvodnú odpoveď

Aliasy

Aliasy modelov

Aliasy ciest metód

Súvisiace ID na volanie

Spoločnosť a jej portfólio projektov

Nakupujte tokeny so zľavou.

Pripojte API k produktu, ktorý predávate.