Source: https://ailoot.ai/models/hu/viduq2/ Canonical: https://ailoot.ai/models/hu/viduq2/ Language: hu # Vidu: Q2 Text-to-Video [Markdown](https://ailoot.ai/models/hu/viduq2/index.md) · [JSON](https://ailoot.ai/models/hu/viduq2/facts.json) ## [Vidu: Q2 Text-to-Video](https://ailoot.ai/models/hu/viduq2/) A Vidu Q2 szöveges jelenetleírásból készít videót, 1–10 másodperces időtartammal, 540p, 720p vagy 1080p kimenettel és öt képaránnyal. Ez a konkrét viduq2 profil az utasításból veszi a stílust és a mozgást, az eredményt pedig aszinkron feladaton keresztül adja vissza. - [**Ailoot Ultra · Videó** `POST /v1/videos` `viduq2`](https://ailoot.ai/models/hu/viduq2/#method-0) 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 Vidu Q2 írott jelenetből készít videót a viduq2 azonosítóval kiválasztott, szövegből videót létrehozó profilon keresztül. Kötelező bemenete a pontos modellazonosító és a jelenetet leíró utasítás. Rövid termékkoncepcióhoz, helyszínt bemutató nagytotálhoz vagy olyan szereplői cselekvéshez használható, amelynek megjelenése és mozgása szavakkal meghatározható. Ez a beállított metódus szövegből készít videót; leírása nem rendel külön képreferencia- vagy videószerkesztési módot ehhez az azonosítóhoz. A leírást látható eseménysorra építse. Határozza meg a témát, a helyszínt, a cselekvést, a plánméretet, a kameramozgást és a végső kompozíciót. Termékkoncepcióhoz írjon le egy asztalon álló tárgyat, az anyagán végighaladó fényt és egy lassú kameraközelítést, amely egy felismerhető részletnél ér véget. Helyszínt bemutató jelenetnél előbb mutassa be a környezetet, majd közelítsen a központi elem felé. A cselekvés illeszkedjen a kiválasztott kliphosszhoz, hogy maradjon idő a jelenet tervezett lezárására. Az utasítás korlátja 2 000 karakter. Először a lényeges témát és cselekvést írja le, majd adja meg a kívánt eredményt módosító világítási, anyag-, környezeti és kamerarészleteket. A vizuális stílust az utasításban határozza meg. A Q2-re vonatkozó útmutató szerint a külön style és movement\_amplitude paraméterek ennél a modellnél nem fejtik ki hatásukat, ezért a general vagy anime előbeállítás és a mozgás amplitúdójának beállításai nem helyettesítik a világos jelenetleírást. A modellspecifikus időtartam-beállítás egytől tízig terjedő egész másodperceket fogad el. A Q2-specifikus felbontási lehetőségek az 540p, a 720p és az 1080p; a dokumentált alapérték a 720p. Az időtartamot és a felbontást együtt válassza ki a cselekvés és a felhasználás helye szerint. Egy rövid bemutatás és egy hosszabb mozgás eltérő időzítést igényel; a kért időtartam növelése a látható eseménysort szolgálja, ne pusztán egy változatlan leírást nyújtson el. A végső elhelyezés előkészítésekor ellenőrizze a visszaadott klip tényleges méreteit és hosszát. Az aspect\_ratio dokumentált lehetőségei a 16:9, 9:16, 3:4, 4:3 és 1:1, az alapérték pedig a 16:9. Az útmutató kifejezetten tartalmazza a 3:4 és 4:3 arányt a Q2 családhoz. A generálás előtt válassza ki a képkivágást, és ehhez illő kompozíciót írjon le: álló képnél a fő téma maradjon jól kivehető, fekvő képnél pedig használja ki a szélességet a környezet bemutatására. A zárókép legyen elég áttekinthető a tervezett oldalhoz, prezentációhoz vagy a későbbi feliratozáshoz. A seed mező a változatosságot szabályozza. Elhagyása vagy a 0 érték megadása véletlen értéket választ; a nem nulla érték a megismételhető generáláshoz dokumentált, rögzített seed lehetőséget választja ki. A változatok összehasonlításakor őrizze meg a visszaadott seed értéket az utasítással és a beállításokkal együtt. A közös művelet az audio és off\_peak vezérlőket is dokumentálja, kifejezetten a Q3 modellekhez. Ezek a Q3 opciók nem ehhez a Q2 profilhoz rendelt képességek; a kérést a dokumentált szöveges bemenet és videókimenet köré tervezze. A generálás aszinkron. A beküldés task\_id azonosítót és kezdeti állapotot ad vissza; újonnan létrehozott feladatnál a created állapotot használja. A feldolgozás követése közben őrizze meg ezt a feladatazonosítót. A dokumentált eredménylekérdezés sikeres eredménynél state=success értéket használ, és creations tömböt ad vissza. Minden elem videó-URL-je a creations\[\].url helyen található; minden visszaadott videót mentsen el, ne feltételezze, hogy a feladat mindig pontosan egy alkotást tartalmaz. Az eredmény dokumentációja a tényleges videó időtartamát, fps értékét, valamint felbontásának szélességét és magasságát is közli. Ezeket a jelentett értékeket őrizze meg az elkészült klippel együtt, és ne tekintse egy példa képkockasebességét vagy méreteit rögzített Q2-specifikációnak. A feladat létrehozására adott válasz a kérés konfigurációja mellett credits értéket is tartalmaz. Az eredménnyel együtt őrizze meg ezeket a jelentett feladatmetaadatokat és az elkészült feladat azonosítóját, hogy minden videó összekapcsolva maradjon a generálási beállításaival. A teljes eseménysort ellenőrizze az eredeti leírás alapján: a téma megjelenését, a tárgyak alakját, a mozgás irányát, a kameramozgás folytonosságát és a tervezett záróképet. Módosításkor nevezze meg azt a konkrét részletet, amely eltért az utasítástól, és őrizze meg a jelenet sikeres részeit. Az utasítást, a pontos kiválasztási azonosítót, a beállításokat, a feladatazonosítót és az elkészült videókat tartsa együtt, hogy a későbbi összehasonlítás a tényleges fájlokon alapuljon. **Ailoot Ultra · Videó** `POST /v1/videos` `viduq2` [`viduq2`](https://ailoot.ai/models/hu/#m=viduq2&route=Ultra&caller=viduq2&fmt=videos) Vidu /`viduq2` ### Kezdő lépések A Vidu Q2 szöveges jelenetleírásból készít videót, 1–10 másodperces időtartammal, 540p, 720p vagy 1080p kimenettel és öt képaránnyal. Ez a konkrét viduq2 profil az utasításból veszi a stílust és a mozgást, az eredményt pedig aszinkron feladaton keresztül adja vissza. 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` | Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett | | --- | --- | --- | --- | --- | | Mező`model` | Típus`string` | KövetelményKötelező | Értékek és korlátok viduq2 | Alapértelmezett— | | Mező`prompt` | Típus`string` | KövetelményKötelező | Értékek és korlátok Feltételek: Írja le a létrehozandó jelenetet. A dokumentált korlát 2000 karakter; az Ailoot nem üres karakterláncot ellenőriz, és megőrzi a szöveget. | Alapértelmezett— | | Mező`duration` | Típus`integer` | KövetelményOpcionális | Értékek és korlátok Minimum: 1 Maximum: 10 Feltételek: A viduq2 modellspecifikus leírása 1–10 egész másodpercet ad meg. Modellspecifikus alapértelmezett időtartam nincs dokumentálva. Egység: másodperc | Alapértelmezett— | | Mező`seed` | Típus`string` | KövetelményOpcionális | Értékek és korlátok Feltételek: Véletlenszerű működéshez hagyja el, vagy küldje a "0" karakterláncot. A megadott nem nulla seed a dokumentált rögzített seed szerinti működést választja; számtartomány nincs megadva. | Alapértelmezett— | | Mező`aspect_ratio` | Típus`string` | KövetelményOpcionális | Értékek és korlátok 16:9, 9:16, 3:4, 4:3, 1:1 | Alapértelmezett16:9 | | Mező`resolution` | Típus`string` | KövetelményOpcionális | Értékek és korlátok 540p, 720p, 1080p Feltételek: A viduq2 modellspecifikus listája ezeket a díjsávokat 1–10 másodperchez dokumentálja. Egy közös felsorolás és táblázat 360p értéket is említ; alkalmazhatósága ellentmond a listának, ezért itt nem állítjuk a támogatását. | Alapértelmezett720p | | Mező`style` | Típus`string` | KövetelményOpcionális | Értékek és korlátok general, anime Feltételek: A közös kérésformátum elfogadja ezt a mezőt, de a dokumentáció kifejezetten jelzi, hogy a viduq2 esetén nincs hatása. | Alapértelmezettgeneral | | Mező`movement_amplitude` | Típus`string` | KövetelményOpcionális | Értékek és korlátok auto, small, medium, large Feltételek: A közös kérésformátum elfogadja ezt a mezőt, de a dokumentáció kifejezetten jelzi, hogy a q2 modellek esetén nincs hatása. | Alapértelmezettauto | Bemeneti anyagok kombinációi Metódus paraméterei és életciklusa | Paraméter | Szerződés | | --- | --- | | Paraméter`content_type` | Szerződésapplication/json | | Paraméter`required` | Szerződésmodel, prompt | | Paraméter`optional` | Szerződésduration, seed, aspect\_ratio, resolution, style, movement\_amplitude | | Paraméter`material_types` | Szerződéstext | | Paraméter`additional_properties` | Szerződéstrue | | Paraméter`validation_scope` | SzerződésAz Ailoot ellenőrzi a nem üres model/prompt karakterláncokat. Az alábbi opcionális típusok és korlátok alkotják a dokumentált kérési szerződést; a többi kérésmezőt megőrzi a kiválasztott modell számára. | Metódus álnevei: `/v1/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` Hozza létre egyszer, és őrizze meg a visszaadott nyilvános id és polling\_url értékeket. Kérdezze le az eredeti műveletet, és olvassa ki a state mezőt; a befejezést a success állapot és egy Önhöz tartozó creations\[\].url eredmény jelenti. Töltse le az összes visszaadott, Önhöz tartozó videó URL-címét; a példából ne következtessen rögzített darabszámra, időtartamra vagy képkockasebességre. ### 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 | Díj | | --- | --- | --- | --- | | BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | 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ásA generálás becsült költsége | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra **$5.12** 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 →](https://ailoot.ai/docs/hu/billing/reserve/) ### Példakérések #### Ailoot Ultra · Videó curl · hozz létre videótcurl · olvasd be az eredeti feladatotcurl · tölts le minden, a tulajdonodban lévő videót ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" cat > request.json <<'JSON_REQUEST' {"model":"viduq2","prompt":"In an ultra-realistic fashion photography style featuring light blue and pale amber tones, an astronaut in a spacesuit walks through the fog. The background consists of enchanting white and golden lights, creating a minimalist still life and an impressive panoramic scene."} JSON_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 ``` ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_POLL' import json from pathlib import Path from urllib.parse import quote,urljoin,urlsplit r=json.loads(Path("result.json").read_text()) i=r.get("id") if not isinstance(i,str) or not i:raise SystemExit("Keep original response/headers/id; do not resubmit creation.") u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe="")) p=urlsplit(u) if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use the actual Ailoot lookup path.") Path("poll-url.txt").write_text(u) PY_POLL curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json ``` ```bash set -eu python3 - <<'PY_ASSETS' import json from pathlib import Path from urllib.parse import urlsplit r=json.loads(Path("status.json").read_text()) if r.get("state")!="success":raise SystemExit("Poll the same original job until its owned result is returned.") creations=r.get("creations") if not isinstance(creations,list) or not creations:raise SystemExit("No completed video creations.") urls=[] for item in creations: value=item.get("url") if isinstance(item,dict) else None values=[value] if isinstance(value,str) else value if not isinstance(values,list) or not values:raise SystemExit("No completed video URL.") for u in values: if not isinstance(u,str):raise SystemExit("Invalid returned URL.") p=urlsplit(u) if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/media/assets/") or not p.path.endswith("/content") or not p.query:raise SystemExit("Wait for the actual Ailoot-owned signed result.") urls.append(u) Path("asset-urls.txt").write_text("\n".join(urls)+"\n") PY_ASSETS index=0 while IFS= read -r asset_url; do curl --fail-with-body --silent --show-error "$asset_url" -o "video-${index}.bin" index=$((index + 1)) done < asset-urls.txt ``` ### Eredmények fogadása és mentése #### Ailoot Ultra · Videó A JSON megőrzi a natív state mezőt és creations tömböt, kiegészítve a nyilvános id/provider\_task\_id/polling\_url értékekkel. A kiválasztott videó-URL-címek közzététel előtt üresek, és a befejezés után az Ailoot tulajdonában lévő aláírt URL-címekké válnak. - `GET /v1/videos/{request_id}` - `GET /v1/videos/generations/{request_id}` - `GET /v1/videos/{request_id}/content` - `GET /v1/videos/generations/{request_id}/content` ##### Ő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. Töltse le a creations\[\].url összes ténylegesen visszaadott URL-címét; a tartalomindex egy valós visszaadott kimenetet azonosít. ##### Ha az eredeti választ ellenőrizni kell A rögzített deklaráció nem sorol fel végleges hibaállapotot. Őrizze meg az eredeti választ, fejléceket és id értéket, és ugyanazt a műveletet ellenőrizze minden ismeretlen állapot vagy result\_pending\_check hiba esetén; ismeretlen kimenetelű létrehozást soha ne küldjön be újra. Válaszmezők | Mező | Típus | Jelentés | | --- | --- | --- | | Mező`id` | Típusstring | JelentésA visszaadott nyilvános Ailoot feladat- vagy műveletazonosító. | | Mező`provider_task_id` | Típusstring | JelentésAz eredeti feladat azonosítója, a nyilvános id értéktől külön. | | Mező`polling_url` | Típusstring | JelentésA visszaadott Ailoot lekérdezési elérési út az eredeti feladathoz. | | Mező`task_id` | Típusstring when supplied | JelentésA létrehozási válaszban szereplő eredeti azonosító. | | Mező`state` | Típusstring when supplied | JelentésNatív feladatállapot: a rögzített függő állapothoz created, a befejezéshez success tartozik. | | Mező`err_code` | Típusstring when supplied | JelentésFeladatdiagnosztika; a mentett specifikáció nem tartalmaz tételes hibakódlistát. | | Mező`creations[].url` | Típusstring\|string\[\] | JelentésMinden kiválasztott, elkészült videó URL-címét az Ailoot tulajdonában lévő aláírt URL-cím váltja fel. | | Mező`creations[].video.duration` | Típusnumber when supplied | JelentésA visszaadott videó időtartama; ellenőrizze a tényleges elkészült eredményt. | | Mező`creations[].video.fps` | Típusinteger when supplied | JelentésA visszaadott képkockasebesség; rögzített képkockasebességet nem ígérünk. | | Mező`creations[].video.resolution.width` | Típusinteger when supplied | JelentésA visszaadott kimenet szélessége pixelben. | | Mező`creations[].video.resolution.height` | Típusinteger when supplied | JelentésA visszaadott kimenet magassága pixelben. | Hibák és következő lépések | Válasz | Feltétel | Következő lépés | | --- | --- | --- | | Válasz400 · `invalid_request_error` | FeltételÉrvénytelen JSON/modell, hiányzó vagy üres kötelező karakterláncok, illetve érvénytelen tartalomindex. | Következő lépés | | Válasz401 · `authentication_error` | FeltételÉrvénytelen Ailoot API-kulcs. | Következő lépés | | Válasz403 · `permission_error` | FeltételAz API-kulcs csoportja nem használhatja ezt a médiaútvonalat. | Következő lépés | | Válasz404 · `not_found_error` | FeltételAz eredeti feladat vagy a kért kimenet hiányzik, illetve nem ugyanahhoz a felhasználóhoz/API-kulcshoz/csoporthoz tartozik. | Következő lépés | | Válasz502 · `result_pending_check` | FeltételAz eredeti beküldés vagy állapot hiányos, illetve nem egyeztethető össze a nyilvántartással; őrizze meg az eredeti azonosítót, és ne küldje be újra. | Következő lépés | | Válasz503 · `result_pending_check` | FeltételAz eredeti hozzárendelés, útvonal vagy a saját média ellenőrzése még folyamatban van; folytassa az eredeti művelet ellenőrzését. | Következő lépés | | Válasz503 · `server_error` | FeltételA médiaszolgáltatás vagy az eredeti feladat tárolója nem érhető el. | Következő lépés | ### Álnevek #### Modell álnevei **Ailoot Ultra** [`viduq2`](https://ailoot.ai/models/hu/#m=viduq2&route=Ultra&caller=viduq2&fmt=videos) #### Metódusútvonalak álnevei `/v1/videos/generations` #### Kapcsolódó modellazonosítók [`viduq2`](https://ailoot.ai/models/hu/#m=viduq2&route=Ultra&caller=viduq2&fmt=videos) FAQ · Vidu: Q2 Text-to-Video Milyen bemenetek és eredmények érhetők el? `POST /v1/videos` · `viduq2`: `text` → `video` Mely mezőket használja a kérés? `POST /v1/videos` · `viduq2`: `model`, `prompt`, `duration`, `seed`, `aspect_ratio`, `resolution`, `style`, `movement_amplitude` Milyen korlátok érvényesek? `POST /v1/videos` · `viduq2`: `duration.minimum`: `1`; `duration.maximum`: `10` 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](https://ailoot.ai/docs/hu/billing/subscriptions/) · [Modellárak megtekintése](https://ailoot.ai/models/hu/) ## 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](mailto:support@ailoot.ai) · [Ajánlati feltételek és licencszerződés](https://ailoot.ai/legal/offer?lang=hu) ## Ailoot · A vállalat és projektportfóliója Az Ailoot felhalmozott működési tapasztalatra, széles ügyfélkörre, stabil szolgáltatásra és folyamatos KPI-ellenőrzésre épít. A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben. Az Ailoot ezt a működési tapasztalatot használja az ügyfelek termékeiben, ágenseiben, alkalmazásaiban és automatizálásaiban elérhető AI-funkciók API-hozzáféréséhez.