Vidu: Q2 Text-to-Video
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.
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
viduq2Kezdő 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ípusstring | KövetelményKötelező | Értékek és korlátok viduq2 | Alapértelmezett— |
Mezőprompt | Típusstring | 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ípusinteger | 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ípusstring | 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ípusstring | 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ípusstring | 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ípusstring | 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ípusstring | 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étercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt |
Paraméteroptional | Szerződésduration, seed, aspect_ratio, resolution, style, movement_amplitude |
Paramétermaterial_types | Szerződéstext |
Paraméteradditional_properties | Szerződéstrue |
Paramétervalidation_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 →
Példakérések
Ailoot Ultra · Videó
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
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
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}/contentGET /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
Metódusútvonalak álnevei
/v1/videos/generations
Kapcsolódó modellazonosítók
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