models

Google: Veo 3.1

Markdown · JSON

Google: Veo 3.1

A Veo 3.1 a Google videómodellje szövegből és képből induló jelenetekhez, generált hanggal, irányított határoló képkockákkal és referenciaanyagokkal. Éles profilja négy-, hat- vagy nyolcmásodperces klipeket biztosít 24 fps mellett, többek között 720p, 1080p és 4K kimeneti lehetőséggel.

A modellről

Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.

A Veo 3.1 a Google videógeneráló modellje rövid audiovizuális jelenet készítéséhez szövegből vagy képből induló leírásból. Éles profilja szöveg-videó, kép-videó és irányított első/utolsó képkockás alkotást támogat, generált hanggal, elemreferenciákkal és külön folytatási munkafolyamattal. Filmszerű koncepció, rövid terméktörténet vagy meghatározott jelenetű, cselekvésű és hallgatási élményű vizuális részlet fejlesztésére használd.

Először a témát és látható eseményt írd le. Határozd meg a környezetet, napszakot és fényt, majd a kamera nézőpontját vagy mozgását és a kívánt vizuális stílust. Egy eredeti jelenetleírás sötét stúdiófelületen álló üvegedényt mutathat, lassú oldalirányú mozgással felfedve egy tükröződést, miközben halk környezeti hang kíséri a felfedést. Minden utasítás látható vagy hallható, a kész eredményen értékelhető jellemzőt ad.

A Google promptkerete a témát, cselekvést, jelenetet, kamerát és esztétikát külön leírásrészként kezeli. A felvételt szolgáló részeket használd minden lehetséges jelző hozzáadása helyett. A dokumentált promptprofilhoz angolul írj utasítást. Ha több cselekvés szerepel, add meg kapcsolatukat, és legyenek arányosak egy rövid klippel, hogy a felfedés vagy reakció jól értelmezhető maradjon.

A kezdőkép rögzíti a nyitó megjelenést és kompozíciót. Akkor használd, ha a karakter, termék vagy környezet már vizuális anyagként létezik, és írd le az abból kibontakozó mozgást. Az utolsó képkocka célkompozíciót ad a befejezéshez. Készíts elő hihető átmenetet közvetítő határoló képkockákat, őrizd meg a fő témát azonosító részleteket, majd generálás után vizsgáld meg a köztük lévő mozgást.

Az elemreferenciák más célt szolgálnak: újonnan generált jelenetben irányítják karakter vagy tárgy megjelenését, míg a határoló képkockák a jelenet konkrét pillanatait határozzák meg. A fontos vizuális jegyeket mutató referenciákat válassz, és minden anyag szerepét tedd világossá a promptban. Az éles modell referenciakép-videó specifikációja nyolcmásodperces kimenetet használ ehhez a referenciás munkafolyamathoz, a szokásos szöveges időtartam-választástól elkülönítve.

A gyártó szokásos éles profilja négy-, hat- vagy nyolcmásodperces klipeket generál 24 képkocka/másodperc sebességgel. Fekvő 16:9 és álló 9:16 képkivágást, promptonként legfeljebb négy videókimenetet és 720p, 1080p, illetve 4K kimeneti felbontást sorol fel. A kimeneti videóformátum MP4. Képből induló specifikációja JPEG vagy PNG bemenetet fogad, legfeljebb 20 MB-os bemeneti képméretet ír le, és 720p/1080p bemeneti konfigurációt támogat. A célhelyhez válassz kimeneti profilt, és a képkocka kompozíciója abban a méretben is maradjon jól értelmezhető.

Natív hang kísérheti a látható jelenetet. A kimondott mondatokat, hangulatot és hangeffektusokat ugyanazon leírás részeként add meg, megnevezve mindegyik forrásaként a témát vagy eseményt. A párbeszédutasítás és kamerautasítás más kérdésre válaszol: az egyik az előadást határozza meg, a másik pedig azt, hogyan látja ezt a néző. A szavak férjenek bele a klip hasznos beszédidejébe, és ellenőrizd a hang érthetőségét és cselekvéshez való kapcsolatát.

Folytatáshoz a gyártó külön videóhosszabbítási munkafolyamatot biztosít. Indulj megfelelő generált forrásklipből, és írd le a következő látható eseményt vagy jelenetváltozást. Őrizd meg az eredeti és folytatott szakaszt, hogy illesztésüknél ellenőrizhető legyen a megjelenés, mozgás és hang. Az új generálás szokásos időtartam- és felbontásválasztásai nem tekinthetők minden hosszabbítási művelet univerzális szerződésének.

Negatív leírással a kizárások a feladat vizuális követelményeire célozhatók. Termékváltozat-sorozatnál a téma és kompozíció maradjon stabil, miközben egyetlen alkotói irányt, például világítást vagy kameratávolságot módosítasz. Az eredménnyel együtt rögzítsd a promptot, referenciákat és kiválasztott beállításokat. Így hasznos alkotói különbség hasonlítható össze egymástól független generálások gyűjteménye helyett.

A normál Veo 3.1 éles profil és a Veo 3.1 Fast kimeneti felbontásprofilja eltér. A Fast 720p-t és 1080p-t sorol fel; a normál 3.1 4K-t is. A kiválasztott kiadást tartsd az eredményhez kapcsolva, éles modellazonosító régebbi Preview profillal vagy más Veo-generációval való észrevétlen cseréje nélkül. A téma megjelenése és a támogatott művelet egyaránt a választott munkafolyamattól függ.

A generálás olyan művelet, amelynek kész eredménye lejátszható és később szerkeszthető videóalkotásokat biztosít. A visszaadott fájlokat őrizd meg forrásképkockáikkal, referenciaanyagaikkal és leírásukkal, a kapott tartalmi eredetinformációval együtt. Minden tényleges kimenetet vizsgálj meg a téma megjelenése, cselekvés, képkivágás, hang és végső kompozíció szerint. A kiválasztott klipet gyártási építőelemként használd, címekkel, átmenetekkel és más befejező munkával a környező szerkesztésben.

Ailoot Ultra · Videó POST /v1/videos google/veo-3.1

google/veo-3.1

Google /google/veo-3.1

Kezdő lépések

A Veo 3.1 a Google videómodellje szövegből és képből induló jelenetekhez, generált hanggal, irányított határoló képkockákkal és referenciaanyagokkal. Éles profilja négy-, hat- vagy nyolcmásodperces klipeket biztosít 24 fps mellett, többek között 720p, 1080p és 4K kimeneti lehetőséggel.

Elfogadott bemenetek
Szöveg
Eredmények
Videó

Elérhető az Ailootban · bemenetek és metódusok

Ailoot Ultra · Videó POST /v1/videos
Bemenet
text
Kimenet
video
Kimeneti formátum
mp4
Kimenetek száma
Legfeljebb 4 kimenets
MezőTípusKövetelményÉrtékek és korlátokAlapértelmezett
MezőmodelTípusstringKövetelményKötelezőÉrtékek és korlátok
google/veo-3.1
Alapértelmezett—
MezőpromptTípusstringKövetelményKötelezőÉrtékek és korlátok
Maximális UTF-8 bájtszám: 10 000
Nem csak szóközből álló tartalom szükséges: Igen
Alapértelmezett—
MeződurationTípusintegerKövetelményKötelezőÉrtékek és korlátok
4, 6, 8
Alapértelmezett—
MezőresolutionTípusstringKövetelményKötelezőÉrtékek és korlátok
720p
Alapértelmezett—
Mezőaspect_ratioTípusstringKövetelményKötelezőÉrtékek és korlátok
16:9, 9:16
Alapértelmezett—
Mezőgenerate_audioTípusbooleanKövetelményKötelezőÉrtékek és korlátok
false, true
Alapértelmezett—
Bemeneti anyagok kombinációi

Szövegből videó · Kötelező: prompt

Metódus paraméterei és életciklusa
ParaméterSzerződés
Paramétercontent_typeSzerződésapplication/json
ParaméterrequiredSzerződésmodel, prompt, duration, resolution, aspect_ratio, generate_audio
Paraméteradditional_propertiesSzerződésfalse
ParaméterparametersSzerződés{"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]}
Paramétermaterial_typesSzerződéstext

Metódus álnevei: /v1/videos/generations, /videos, /videos/generations

Életciklus: 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

Őrizze meg a teljes választ és az eredetileg visszaadott azonosítókat.

Ismeretlen kimenetelű létrehozást soha ne küldjön be újra.

Díjcsomagok

A végső díj számítása

A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.

A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.

Gyors mód
Nincs megadva Ha a gyors mód van kiválasztva
Flex mód
Nincs megadva Ha a flex mód van kiválasztva
Maximális gondolkodási ráfordítás
Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik

Becsült díjak összehasonlításhoz

Árak beállításonként

Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.

BeállításDíjtáblázatElőre jelzett mennyiségHang generálásaFelbontásElszámolási egységElszámolási feltételekDíj
BeállításTokenek alapdíjaiDíjtáblázatAlapdíjElőre jelzett mennyiség—Hang generálása—Felbontás—Elszámolási egység—Elszámolási feltételek—Díj
Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token
Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token
Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token
Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token
Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token
BeállításUltraDíjtáblázat—Előre jelzett mennyiségKért beállítások; csak becslés.Hang generálásaHanggalFelbontás720pElszámolási egységkimeneti videómásodpercenkéntElszámolási feltételek—Díj
Kimenet · Becsült kimeneti videómásodperc · Becslés, csak összehasonlításra $0.8 kimeneti videómásodpercenként

A megjelenített díj a generálás előtti költséget becsüli. A végleges díjat az eredeti generálásnál rögzített költségből számítják. A videó tényleges lejátszási időtartama nem a számlázott mennyiség.

BeállításVideó áraDíjtáblázat—Előre jelzett mennyiség—Hang generálása—Felbontás—Elszámolási egységvideómásodpercenkéntElszámolási feltételekhang: hanggal (with_audio); felbontás: 4kDíj
Kimenet · Videó ára · Becslés, csak összehasonlításra $1.2 videómásodpercenként
BeállításUltraDíjtáblázat—Előre jelzett mennyiségKért beállítások; csak becslés.Hang generálásaHang nélkülFelbontás720pElszámolási egységkimeneti videómásodpercenkéntElszámolási feltételek—Díj
Kimenet · Becsült kimeneti videómásodperc · Becslés, csak összehasonlításra $0.4 kimeneti videómásodpercenként

A megjelenített díj a generálás előtti költséget becsüli. A végleges díjat az eredeti generálásnál rögzített költségből számítják. A videó tényleges lejátszási időtartama nem a számlázott mennyiség.

BeállításVideó áraDíjtáblázat—Előre jelzett mennyiség—Hang generálása—Felbontás—Elszámolási egységvideómásodpercenkéntElszámolási feltételekhang: hang nélkül; felbontás: 4kDíj
Kimenet · Videó ára · Becslés, csak összehasonlításra $0.8 videómásodpercenként
BeállításA generálás becsült költségeDíjtáblázat—Előre jelzett mennyiségbecslés egy generálásraHang generálása—Felbontás—Elszámolási egység—Elszámolási feltételek—Díj
Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $1.6 becslés a generálás előtt

Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra.

Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →

A referencia-díjszabás részletei

A modellszintű referenciatáblázatok nem módosítják a metódusválasztást, az árajánlatokat vagy a díjakat. A tényleges díjak a kiválasztott Ailoot-metódus díjtételeit használják.

Videóbeállítások árhivatkozásai

Árak beállításonként

Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.

BeállításElszámolási feltételekDíj
BeállításVideó áraElszámolási feltételekhang: hanggal (with_audio)Díj
Kimenet · Videó ára $0.8 videómásodpercenként

A megjelenített konfiguráció közzétett árreferenciája. A végleges díjak a ténylegesen elszámolt konfigurációt követik.

BeállításVideó áraElszámolási feltételekhang: hanggal (with_audio); felbontás: 4kDíj
Kimenet · Videó ára $1.2 videómásodpercenként

A megjelenített konfiguráció közzétett árreferenciája. A végleges díjak a ténylegesen elszámolt konfigurációt követik.

BeállításVideó áraElszámolási feltételekhang: hang nélkülDíj
Kimenet · Videó ára $0.4 videómásodpercenként

A megjelenített konfiguráció közzétett árreferenciája. A végleges díjak a ténylegesen elszámolt konfigurációt követik.

BeállításVideó áraElszámolási feltételekhang: hang nélkül; felbontás: 4kDíj
Kimenet · Videó ára $0.8 videómásodpercenként

A megjelenített konfiguráció közzétett árreferenciája. A végleges díjak a ténylegesen elszámolt konfigurációt követik.

Példakérések

Ailoot Ultra · Videó

curl · pontosan a beállított 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

Eredmények fogadása és mentése

Ailoot Ultra · Videó

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
Feladatállapot ellenőrzése
Az eredeti művelet állapotának lekérése GET-tel
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
További tartalomlekérések
Mentsen minden elkészült, Önhöz tartozó kimenetet
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
Őrizzen meg minden elkészült eredményt

Mentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.

Őrizze meg a befejezett data[] összes aláírt saját URL-címét és a teljes állapot-metaadatokat. Mentse el az összes kimenetet a generált hangjával együtt. Érvényes AAC-hangsáv generate_audio=false mellett is jelen lehet; őrizze meg a teljes eredeti MP4 fájlt ezzel a hanggal együtt.

Ha az eredeti választ ellenőrizni kell

A meglévő eredeti feladatot kérdezze le; ismeretlen kimenetelű küldést soha ne küldjön be újra.

Maximális kimenetszám: 4.

Válaszmezők
MezőTípusJelentés
MezőidTípusstringJelentés—
MezőobjectTípusstringJelentés—
MezőmodelTípusstringJelentés—
MezőstatusTípusstringJelentés—
Meződata[]Típussigned content URLJelentés—
Mezőcharge_pending_checkTípusbooleanJelentés—
Mezőerror.codeTípusstringJelentés—
Mezőerror.messageTípusstringJelentés—
Mezőoperation_idTípusstringJelentésHTTP503 result_pending_check válasz az eredeti status/content lekérdezésre: az id ugyanaz az eredeti nyilvános videóazonosító.
Mezőerror.typeTípusstringJelentésserver_error a HTTP503 result_pending_check válasznál.
Hibák és következő lépések
VálaszFeltételKövetkező lépés
Válasz400 · invalid_request_errorFeltételA nyers kéréstörzs beolvasása a videóprofil feldolgozása előtt sikertelenKövetkező lépésŐrizze meg a visszaadott választ, és javítsa az olvashatatlan kéréstörzset.
Válasz422 · price_unavailableFeltételA pontos videóprofil feldolgozása sikertelen, vagy a teljes feldolgozott profilhoz nincs kész, pontos árkártyaKövetkező lépésŐrizze meg a választ; használja a teljes, pontosan engedélyezett profilt és annak közzétett árkártyáját. Ez az ág a szolgáltatónak történő küldés előtt fut le.
Válasz409 · video_not_readyFeltételAz eredeti eredmény tartalma még nem érhető elKövetkező lépésKérdezze le az eredetileg visszaadott azonosítót, és tartsa be a Retry-After előírását.
Válaszserver_errorFeltételA visszaadott válasz szerint a művelet vagy az eredmény ellenőrzést igényelKövetkező lépésŐrizze meg az eredetileg visszaadott művelet- vagy feladatazonosítót, a kérés fejléceit és a választ; folytassa az eredeti művelet támogatott lekérdezéseit. Ne küldje be újra a létrehozási kérést.
Válasz503 · result_pending_checkFeltételAz eredeti status/content GET lekérdezésekor: a feladat nincs közzétéve, az eredeti feladat állapota nem failed/cancelled/expired, és a helyi állapot unknown, vagy az eredeti feladat állapota completed.Következő lépésŐrizze meg az eredeti id és operation_id értéket (ugyanaz a nyilvános videóazonosító), a választ és a fejléceket; csak az eredeti status/content értéket kérdezze le. Soha ne küldjön be új generálási kérést.

Álnevek

Modell álnevei

Ailoot Ultra google/veo-3.1

Metódusútvonalak álnevei

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

Kapcsolódó modellazonosítók

google/veo-3.1

FAQ · Google: Veo 3.1
Milyen bemenetek és eredmények érhetők el?

POST /v1/videos · google/veo-3.1: text → video

Mely mezőket használja a kérés?

POST /v1/videos · google/veo-3.1: model, prompt, duration, resolution, aspect_ratio, generate_audio

További részletek

Csatlakoztassa az Ailootot a Claude Code-hoz, OpenCode-hoz, Hermeshez vagy saját alkalmazásához.

A vállalat és projektportfóliója

A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben.

Vásároljon tokeneket kedvezménnyel.

Előfizetési kedvezmény rendszeres munkához. Promókódok — akár 50% tokenvásárlási kedvezmény.

Előfizetés
Válasszon kedvezményes tarifát a rendszeres kéréseihez.
Promókód akár 50%-ig
Vásárláskor adja meg a kódot. Az ár az érvényes akció szerint újraszámolódik.
Költségek az előzményekben
Minden kéréshez megmarad a modell, a tokenek és az összeg.

Előfizetés kiválasztása · Modellárak megtekintése

Csatlakoztassa az API-t az értékesített termékéhez.

SaaS, alkalmazások és botok — az Ailoot ajánlati feltételei és licencszerződése alapján. Viszonteladáshoz kérjen viszonteladói licencet.

Kereskedelmi alkalmazás
Építsen szöveg-, kép-, videó- és hanggenerálást szolgáltatása fizetős funkcióiba.
Viszonteladói licenc
Küldje el a projekt leírását és a hozzáférés módját. Kérjen írásos használati és viszonteladási feltételeket.
Dokumentumok a weboldalon
Az ajánlati feltételek, licencszerződés és adatkezelési szabályzat már a csatlakoztatás előtt elérhető.

Viszonteladói licenc kérése · Ajánlati feltételek és licencszerződés