Google: Veo 3.1

Veo 3.1 je videomodel Googlu pro scény vedené textem a obrázky s generovaným zvukem, řízenými krajními snímky a referenčními podklady. Jeho produkční profil nabízí klipy dlouhé čtyři, šest či osm sekund při 24 fps s výstupními možnostmi včetně 720p, 1080p a 4K.

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

O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

Veo 3.1 je model Googlu pro generování videa, který vytváří krátkou audiovizuální scénu z textu nebo zadání vedeného obrázkem. Jeho produkční profil podporuje tvorbu z textu, z obrázku a řízenou tvorbu z prvního a posledního snímku s generovaným zvukem, referenčními podklady a samostatným postupem pokračování. Použijte jej k rozvíjení filmového konceptu, krátkého produktového příběhu či vizuálního úseku s určenou scénou, dějem a poslechovým zážitkem.

Nejprve popište objekt a viditelnou událost. Určete okolí, denní dobu a světlo a poté úhel pohledu či pohyb kamery a zamýšlený vizuální styl. Vlastní zadání scény může ukazovat skleněnou nádobu na tmavém studiovém povrchu s pomalým bočním pohybem odhalujícím odraz, zatímco odhalení doprovází jemný zvuk prostředí. Každý pokyn dává viditelnou či slyšitelnou vlastnost, kterou lze v hotovém výsledku posoudit.

Rámec promptování Googlu chápe objekt, děj, scénu, kameru a estetiku jako samostatné části zadání. Použijte části sloužící záběru místo přidávání všech možných popisů. Pokyny pro dokumentovaný profil promptů pište anglicky. Pokud scéna obsahuje několik akcí, uveďte jejich vztah a přizpůsobte je krátkému klipu, aby odhalení nebo reakce zůstaly čitelné.

Úvodní obrázek určuje počáteční vzhled a kompozici. Použijte jej, pokud postava, produkt nebo prostředí již existují jako vizuální podklad, a popište pohyb, který se z něj má rozvinout. Poslední snímek přidává cílovou kompozici konce. Připravte krajní snímky sdělující uvěřitelný přechod a zachovávající detaily určující hlavní objekt a po generování prohlédněte pohyb mezi nimi.

Referenční podklady slouží jinému účelu: vedou vzhled postavy nebo předmětu v nově generované scéně, zatímco krajní snímky určují konkrétní okamžiky této scény. Vyberte reference ukazující důležité vizuální rysy a v promptu objasněte roli každého podkladu. Specifikace produkčního modelu pro tvorbu videa z referenčních obrázků používá v tomto referenčním postupu osm sekund výstupu, odděleně od běžné volby délky při tvorbě z textu.

Běžný produkční profil výrobce generuje klipy dlouhé čtyři, šest či osm sekund při 24 snímcích za sekundu. Uvádí rámování na šířku 16:9 a na výšku 9:16, až čtyři výstupní videa na prompt a výstupní rozlišení 720p, 1080p a 4K. Formátem videovýstupu je MP4. Specifikace vedená obrázkem přijímá JPEG nebo PNG, uvádí maximum vstupního obrázku 20 MB a podporuje vstupní konfigurace 720p/1080p. Výstupní profil zvolte pro zamýšlené umístění a kompozici snímku udržte čitelnou v této velikosti.

Nativní zvuk může doprovázet viditelnou scénu. Mluvené repliky, atmosféru a zvukové efekty určete jako části stejného zadání a u každého zvuku pojmenujte jeho původce, tedy postavu, předmět či událost. Dialogový pokyn a kamerový pokyn odpovídají na různé otázky: jeden určuje výkon, druhý, jak jej divák uvidí. Slova udržte v rámci využitelného času klipu pro řeč a zvuk zkontrolujte z hlediska srozumitelnosti a vztahu k ději.

Pro pokračování nabízí výrobce samostatný postup prodlužování videa. Začněte vhodným generovaným zdrojovým klipem a popište další viditelnou událost či změnu ve scéně. Původní i pokračující segment uchovejte, aby se jejich napojení dalo zkontrolovat z hlediska vzhledu, pohybu a zvuku. Běžné volby délky a rozlišení nového generování nemají být považovány za univerzální smlouvu pro každou operaci prodloužení.

Negativní popis může soustředit vyloučení na vizuální požadavky úlohy. U série produktových variant udržujte objekt a kompozici stabilní a měňte jediný tvůrčí směr, například osvětlení či vzdálenost kamery. S výsledkem zaznamenejte prompt, reference a zvolená nastavení. Díky tomu lze porovnat užitečný tvůrčí rozdíl místo souboru nesouvisejících generování.

Běžný produkční profil Veo 3.1 a Veo 3.1 Fast mají různé profily výstupního rozlišení. Fast uvádí 720p a 1080p; běžný 3.1 také 4K. Zvolenou edici ponechte připojenou k výsledku bez tichého nahrazení identifikátoru produkčního modelu starším profilem Preview nebo jinou generací Veo. Vzhled objektu i podporovaná operace závisejí na vybraném postupu.

Generování je operace, jejíž dokončený výsledek poskytne videosoubory pro přehrávání a následný střih. Vrácené soubory uchovejte se zdrojovými snímky, referenčními podklady a zadáním a zachovejte dodané informace o původu obsahu. Každý skutečný výstup zkontrolujte z hlediska vzhledu objektu, děje, rámování, zvuku a konečné kompozice. Vybraný klip použijte jako produkční stavební prvek a titulky, přechody či jiné dokončovací úpravy doplňte v navazujícím střihu.

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

google/veo-3.1

Google /google/veo-3.1

Úvod

Přijímané vstupy: Text
Výsledky: Video

Dostupné v Ailoot · vstupy a metody

Ailoot Ultra · Video POST /v1/videos

Vstup: text
Výstup: video
Výstupní formát: mp4
Počet výstupů: Až 4 výstups

Pole	Typ	Požadavek	Hodnoty a limity	Výchozí
Pole`model`	Typ`string`	PožadavekPovinné	Hodnoty a limity google/veo-3.1	Výchozí—
Pole`prompt`	Typ`string`	PožadavekPovinné	Hodnoty a limity Maximální počet bajtů UTF-8: 10 000 Vyžadován obsah kromě bílých znaků: Ano	Výchozí—
Pole`duration`	Typ`integer`	PožadavekPovinné	Hodnoty a limity 4, 6, 8	Výchozí—
Pole`resolution`	Typ`string`	PožadavekPovinné	Hodnoty a limity 720p	Výchozí—
Pole`aspect_ratio`	Typ`string`	PožadavekPovinné	Hodnoty a limity 16:9, 9:16	Výchozí—
Pole`generate_audio`	Typ`boolean`	PožadavekPovinné	Hodnoty a limity false, true	Výchozí—

Kombinace vstupních materiálů

Text na video · Povinné: prompt

Parametry a životní cyklus metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, prompt, duration, resolution, aspect_ratio, generate_audio
Parametr`additional_properties`	Kontraktfalse
Parametr`parameters`	Kontrakt{"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]}
Parametr`material_types`	Kontrakttext

Aliasy metody: /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

Uchovejte celou odpověď a původní vrácená ID.

Vytvoření s neznámým výsledkem nikdy znovu neodesílejte.

Tarify

Jak se vypočítá konečný poplatek

Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.

Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.

Rychlý režim: Neuvedeno Při výběru rychlého režimu
Režim flex: Neuvedeno Při výběru režimu flex
Maximální intenzita uvažování: Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)

Odhadované sazby pro srovnání

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

Konfigurace	Tabulka sazeb	Předpokládané množství	Generovat zvuk	Rozlišení	Účtovací jednotka	Podmínky účtování	Poplatek
KonfiguraceZákladní sazby za tokeny	Tabulka sazebZákladní sazba	Předpokládané množství—	Generovat zvuk—	Rozlišení—	Účtovací jednotka—	Podmínky účtování—	Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů
KonfiguraceUltra	Tabulka sazeb—	Předpokládané množstvíPožadované nastavení; pouze odhad.	Generovat zvukSe zvukem	Rozlišení720p	Účtovací jednotkaza sekundu výstupního videa	Podmínky účtování—	Poplatek Výstup · Odhadovaná sekunda výstupního videa · Odhad pouze pro srovnání $0.8 za sekundu výstupního videa Zobrazená sazba slouží k odhadu ceny před generováním. Konečná částka se vypočítá z nákladů zaznamenaných pro původní generování. Skutečná délka videa není účtovaným množstvím.
KonfiguraceCena videa	Tabulka sazeb—	Předpokládané množství—	Generovat zvuk—	Rozlišení—	Účtovací jednotkaza sekundu videa	Podmínky účtovánízvuk: with_audio; rozlišení: 4k	Poplatek Výstup · Cena videa · Odhad pouze pro srovnání $1.2 za sekundu videa
KonfiguraceUltra	Tabulka sazeb—	Předpokládané množstvíPožadované nastavení; pouze odhad.	Generovat zvukBez zvuku	Rozlišení720p	Účtovací jednotkaza sekundu výstupního videa	Podmínky účtování—	Poplatek Výstup · Odhadovaná sekunda výstupního videa · Odhad pouze pro srovnání $0.4 za sekundu výstupního videa Zobrazená sazba slouží k odhadu ceny před generováním. Konečná částka se vypočítá z nákladů zaznamenaných pro původní generování. Skutečná délka videa není účtovaným množstvím.
KonfiguraceCena videa	Tabulka sazeb—	Předpokládané množství—	Generovat zvuk—	Rozlišení—	Účtovací jednotkaza sekundu videa	Podmínky účtovánízvuk: without_audio; rozlišení: 4k	Poplatek Výstup · Cena videa · Odhad pouze pro srovnání $0.8 za sekundu videa
KonfiguraceOdhadovaná cena generování	Tabulka sazeb—	Předpokládané množstvíodhad pro jedno generování	Generovat zvuk—	Rozlišení—	Účtovací jednotka—	Podmínky účtování—	Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $1.6 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování.

Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →

Podrobnosti referenčního tarifu

Referenční tabulky modelu nemění výběr metody, cenové nabídky ani poplatky. Skutečné poplatky používají sazby vybrané metody Ailoot.

Cenové reference konfigurací videa

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

Konfigurace	Podmínky účtování	Poplatek
KonfiguraceCena videa	Podmínky účtovánízvuk: with_audio	Poplatek Výstup · Cena videa $0.8 za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci.
KonfiguraceCena videa	Podmínky účtovánízvuk: with_audio; rozlišení: 4k	Poplatek Výstup · Cena videa $1.2 za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci.
KonfiguraceCena videa	Podmínky účtovánízvuk: without_audio	Poplatek Výstup · Cena videa $0.4 za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci.
KonfiguraceCena videa	Podmínky účtovánízvuk: without_audio; rozlišení: 4k	Poplatek Výstup · Cena videa $0.8 za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci.

Příklady požadavků

Ailoot Ultra · Video

curl · přesný nastavený profil

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

Přijímání a ukládání výsledků

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

Ověřit stav úlohy

Získat stav původní operace pomocí GET

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

Další načtení obsahu

Uložte každý dokončený výstup, který vám patří

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

Uchovejte všechny dokončené výsledky

Uložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.

Uchovejte každou podepsanou URL spravovanou službou z pole data[] dokončeného výsledku a úplná stavová metadata. Uložte každý výstup včetně jeho generovaného zvuku. Platná zvuková stopa AAC může být přítomna i při generate_audio=false; uchovejte celý původní MP4 včetně tohoto zvuku.

Pokud je nutné ověřit původní odpověď

Načítejte existující původní úlohu; odeslání s neznámým výsledkem nikdy neopakujte.

Maximální počet výstupů: 4.

Pole odpovědi

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ýznamOdpověď původního stavu či obsahu HTTP503 result_pending_check: stejné původní veřejné ID videa v poli id.
Pole`error.type`	Typstring	Významserver_error při HTTP503 result_pending_check.

Chyby a další kroky

Odpověď	Podmínka	Další krok
Odpověď400 · `invalid_request_error`	PodmínkaNačtení nezpracovaného těla požadavku selže před zpracováním profilu videa	Další krokZachovejte vrácenou odpověď a opravte nečitelné tělo požadavku.
Odpověď422 · `price_unavailable`	PodmínkaPřesný profil videa nelze zpracovat nebo pro celý zpracovaný profil není připravena přesná cenová karta	Další krokZachovejte odpověď; použijte celý přesný profil s povoleným přístupem a jeho zveřejněnou kartu. Tato větev se provádí před odesláním poskytovateli.
Odpověď409 · `video_not_ready`	PodmínkaObsah původního výsledku zatím není dostupný	Další krokDotazujte se na původní vrácené ID a dodržujte Retry-After.
Odpověď`server_error`	PodmínkaVrácená odpověď uvádí, že operaci nebo výsledek je třeba zkontrolovat	Další krokUchovejte původní vrácené ID operace nebo úlohy, hlavičky požadavku a odpověď; pokračujte v podporovaném načítání údajů o této původní operaci. Požadavek na vytvoření znovu neodesílejte.
Odpověď503 · `result_pending_check`	PodmínkaGET původního stavu či obsahu: úloha není zveřejněna, původní úloha nemá stav failed/cancelled/expired a místní stav je unknown nebo stav původní úlohy je completed.	Další krokUchovejte původní id a operation_id (stejné veřejné ID videa), odpověď a hlavičky; načítejte pouze původní stav či obsah. Nikdy neodesílejte nový požadavek na generování.

Aliasy

Aliasy modelu

Ailoot Ultra google/veo-3.1

Aliasy cest metod

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

Související ID modelů

google/veo-3.1

FAQ · Google: Veo 3.1

Jaké vstupy a výsledky jsou dostupné?: POST /v1/videos · google/veo-3.1: text → video
Jaká pole požadavek používá?: 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 metody

Tarify

Jak se vypočítá konečný poplatek

Odhadované sazby pro srovnání

Ceny podle konfigurace

Podrobnosti referenčního tarifu

Ceny podle konfigurace

Příklady požadavků

Ailoot Ultra · Video

Přijímání a ukládání výsledků

Ailoot Ultra · Video

Ověřit stav úlohy

Uchovejte všechny dokončené výsledky

Pokud je nutné ověřit původní odpověď

Aliasy

Aliasy modelu

Aliasy cest metod

Související ID modelů

Společnost a její portfolio projektů

Nakupujte tokeny se slevou.

Připojte API k produktu, který prodáváte.