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.1Kezdő 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ípus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok google/veo-3.1 | Alapértelmezett— |
Mezőprompt | Típusstring | Kö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őduration | Típusinteger | KövetelményKötelező | Értékek és korlátok 4, 6, 8 | Alapértelmezett— |
Mezőresolution | Típusstring | KövetelményKötelező | Értékek és korlátok 720p | Alapértelmezett— |
Mezőaspect_ratio | Típusstring | KövetelményKötelező | Értékek és korlátok 16:9, 9:16 | Alapértelmezett— |
Mezőgenerate_audio | Típusboolean | Kö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éter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt, duration, resolution, aspect_ratio, generate_audio |
Paraméteradditional_properties | Szerződésfalse |
Paraméterparameters | Szerző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_types | Szerző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ás | Díjtáblázat | Előre jelzett mennyiség | Hang generálása | Felbontás | Elszámolási egység | Elszámolási feltételek | Díj |
|---|---|---|---|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Elő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ásUltra | Díjtáblázat— | Előre jelzett mennyiségKért beállítások; csak becslés. | Hang generálásaHanggal | Felbontás720p | Elszámolási egységkimeneti videómásodpercenként | Elszá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ó ára | Díjtáblázat— | Előre jelzett mennyiség— | Hang generálása— | Felbontás— | Elszámolási egységvideómásodpercenként | Elszámolási feltételekhang: hanggal (with_audio); felbontás: 4k | Díj Kimenet · Videó ára · Becslés, csak összehasonlításra $1.2 videómásodpercenként |
| BeállításUltra | Díjtáblázat— | Előre jelzett mennyiségKért beállítások; csak becslés. | Hang generálásaHang nélkül | Felbontás720p | Elszámolási egységkimeneti videómásodpercenként | Elszá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ó ára | Díjtáblázat— | Előre jelzett mennyiség— | Hang generálása— | Felbontás— | Elszámolási egységvideómásodpercenként | Elszámolási feltételekhang: hang nélkül; felbontás: 4k | Dí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ége | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Hang 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ás | Elszámolási feltételek | Díj |
|---|---|---|
| BeállításVideó ára | Elszá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ó ára | Elszámolási feltételekhang: hanggal (with_audio); felbontás: 4k | Dí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ó ára | Elszámolási feltételekhang: hang nélkül | Dí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ó ára | Elszámolási feltételekhang: hang nélkül; felbontás: 4k | 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. |
Példakérések
Ailoot Ultra · Videó
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}/contentGET /v1/videos/generations/{request_id}/content
Feladatállapot ellenőrzése
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
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ípus | Jelentés |
|---|---|---|
Mezőid | Típusstring | Jelentés— |
Mezőobject | Típusstring | Jelentés— |
Mezőmodel | Típusstring | Jelentés— |
Mezőstatus | Típusstring | Jelentés— |
Meződata[] | Típussigned content URL | Jelentés— |
Mezőcharge_pending_check | Típusboolean | Jelentés— |
Mezőerror.code | Típusstring | Jelentés— |
Mezőerror.message | Típusstring | Jelentés— |
Mezőoperation_id | Típusstring | Jelenté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.type | Típusstring | Jelentésserver_error a HTTP503 result_pending_check válasznál. |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételA nyers kéréstörzs beolvasása a videóprofil feldolgozása előtt sikertelen | Következő lépésŐrizze meg a visszaadott választ, és javítsa az olvashatatlan kéréstörzset. |
Válasz422 · price_unavailable | FeltételA pontos videóprofil feldolgozása sikertelen, vagy a teljes feldolgozott profilhoz nincs kész, pontos árkártya | Kö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_ready | FeltételAz eredeti eredmény tartalma még nem érhető el | Következő lépésKérdezze le az eredetileg visszaadott azonosítót, és tartsa be a Retry-After előírását. |
Válaszserver_error | FeltételA visszaadott válasz szerint a művelet vagy az eredmény ellenőrzést igényel | Kö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_check | Felté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
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