models

Vidu: Q2 Text-to-Video

Markdown · JSON

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

viduq2

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ípusKövetelményÉrtékek és korlátokAlapértelmezett
MezőmodelTípusstringKövetelményKötelezőÉrtékek és korlátok
viduq2
Alapértelmezett—
MezőpromptTípusstringKö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ődurationTípusintegerKö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őseedTípusstringKö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_ratioTípusstringKövetelményOpcionálisÉrtékek és korlátok
16:9, 9:16, 3:4, 4:3, 1:1
Alapértelmezett16:9
MezőresolutionTípusstringKö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őstyleTípusstringKö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_amplitudeTípusstringKö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éterSzerződés
Paramétercontent_typeSzerződésapplication/json
ParaméterrequiredSzerződésmodel, prompt
ParaméteroptionalSzerződésduration, seed, aspect_ratio, resolution, style, movement_amplitude
Paramétermaterial_typesSzerződéstext
Paraméteradditional_propertiesSzerződéstrue
Paramétervalidation_scopeSzerző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ásDíjtáblázatElőre jelzett mennyiségDíj
BeállításTokenek alapdíjaiDíjtáblázatAlapdíjElő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égeDíjtáblázat—Előre jelzett mennyiségbecslés egy generálásraDí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ó

curl · hozz létre videótcurl · olvasd be az eredeti feladatotcurl · tölts le minden, a tulajdonodban lévő videót
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}/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ípusJelentés
MezőidTípusstringJelentésA visszaadott nyilvános Ailoot feladat- vagy műveletazonosító.
Mezőprovider_task_idTípusstringJelentésAz eredeti feladat azonosítója, a nyilvános id értéktől külön.
Mezőpolling_urlTípusstringJelentésA visszaadott Ailoot lekérdezési elérési út az eredeti feladathoz.
Mezőtask_idTípusstring when suppliedJelentésA létrehozási válaszban szereplő eredeti azonosító.
MezőstateTípusstring when suppliedJelentésNatív feladatállapot: a rögzített függő állapothoz created, a befejezéshez success tartozik.
Mezőerr_codeTípusstring when suppliedJelentésFeladatdiagnosztika; a mentett specifikáció nem tartalmaz tételes hibakódlistát.
Mezőcreations[].urlTí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.durationTípusnumber when suppliedJelentésA visszaadott videó időtartama; ellenőrizze a tényleges elkészült eredményt.
Mezőcreations[].video.fpsTípusinteger when suppliedJelentésA visszaadott képkockasebesség; rögzített képkockasebességet nem ígérünk.
Mezőcreations[].video.resolution.widthTípusinteger when suppliedJelentésA visszaadott kimenet szélessége pixelben.
Mezőcreations[].video.resolution.heightTípusinteger when suppliedJelentésA visszaadott kimenet magassága pixelben.
Hibák és következő lépések
VálaszFeltételKövetkező lépés
Válasz400 · invalid_request_errorFelté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_errorFeltételÉrvénytelen Ailoot API-kulcs.Következő lépés
Válasz403 · permission_errorFeltételAz API-kulcs csoportja nem használhatja ezt a médiaútvonalat.Következő lépés
Válasz404 · not_found_errorFelté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_checkFelté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_checkFelté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_errorFelté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

viduq2

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

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