Vidu: Q2 Text-to-Video
Vidu Q2 vytvára video z textového zadania scény s trvaním 1–10 sekúnd, výstupom 540p, 720p alebo 1080p a piatimi pomermi strán. Tento konkrétny profil viduq2 určuje štýl a pohyb podľa promptu a vracia výsledok prostredníctvom asynchrónnej úlohy.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Vidu Q2 vytvára video z písomného opisu scény prostredníctvom profilu na tvorbu videa z textu vybraného identifikátorom viduq2. Povinnými vstupmi sú presný identifikátor modelu a prompt opisujúci scénu. Použite ho pre krátky produktový koncept, úvodný celkový záber alebo činnosť postavy, ktorej vzhľad a pohyb možno určiť slovami. Táto nakonfigurovaná metóda vytvára video z textu; jej opis nepriraďuje identifikátoru samostatný režim obrazovej referencie ani úprav videa.
Zadanie zostavte okolo viditeľnej postupnosti. Určte hlavný objekt, miesto, činnosť, veľkosť záberu, pohyb kamery a konečnú kompozíciu. Pri produktovom koncepte opíšte predmet na stole, svetlo prechádzajúce po jeho materiáli a pomalé približovanie kamery, ktoré sa skončí na rozpoznateľnom detaile. Pri scéne lokality najskôr predstavte prostredie a až potom sa presúvajte k ústrednému bodu. Činnosť prispôsobte zvolenej dĺžke klipu, aby mala scéna priestor na zamýšľaný záver.
Limit promptu je 2,000 znakov. Najskôr uveďte podstatný hlavný objekt a činnosť, potom pridajte detaily osvetlenia, materiálu, prostredia a kamery, ktoré menia požadovaný výsledok. Vizuálny štýl určte v prompte. Príručka pre Q2 uvádza, že samostatné parametre style a movement_amplitude nemajú pri tomto modeli účinok, preto predvoľba general či anime a možnosti amplitúdy pohybu nenahrádzajú jasný opis scény.
Nastavenie trvania pre tento model prijíma celé sekundy od jednej do desiatich. Voľby rozlíšenia pre Q2 sú 540p, 720p a 1080p, pričom zdokumentovanou predvolenou hodnotou je 720p. Trvanie a rozlíšenie vyberajte spolu podľa činnosti a cieľového použitia. Krátke odhalenie a dlhší pohyb potrebujú odlišné načasovanie; predĺženie požadovaného trvania má slúžiť viditeľnej postupnosti, nie iba natiahnuť nezmenené zadanie. Pri príprave konečného umiestnenia skontrolujte skutočné rozmery a dĺžku vráteného klipu.
Zdokumentované voľby aspect_ratio sú 16:9, 9:16, 3:4, 4:3 a 1:1, s predvolenou hodnotou 16:9. Príručka výslovne zahŕňa 3:4 a 4:3 pre rodinu Q2. Formát vyberte pred generovaním a opíšte vhodnú kompozíciu: pri obraze na výšku zachovajte hlavnému objektu dobrú čitateľnosť alebo využite šírku vodorovného obrazu pre okolité prostredie. Záverečný pohľad nechajte dostatočne prehľadný pre zamýšľanú stránku, prezentáciu alebo neskoršie doplnenie titulku.
Pole seed riadi variácie. Jeho vynechanie alebo hodnota 0 vyberie náhodnú hodnotu; nenulová hodnota vyberie zdokumentovanú voľbu pevného počiatočného nastavenia pre opakovateľné generovanie. Pri porovnávaní verzií uchovajte vrátený seed spolu s promptom a nastaveniami. Spoločná operácia dokumentuje aj nastavenia audio a off_peak určené konkrétne pre modely Q3. Tieto voľby Q3 nie sú schopnosťami priradenými tomuto profilu Q2; požiadavku plánujte podľa jeho zdokumentovaného textového vstupu a výstupu v podobe videa.
Generovanie je asynchrónne. Odoslanie vráti task_id a počiatočný stav, pričom pri novo vytvorenej úlohe sa používa created. Túto identitu úlohy uchovajte počas sledovania spracovania. Zdokumentovaný dotaz na výsledok používa state=success pre úspešný výsledok a vracia pole creations. Každá položka má URL videa v creations[].url; uložte každé vrátené video namiesto predpokladu, že úloha vždy obsahuje presne jeden vytvorený výsledok.
Dokumentácia výsledku uvádza aj skutočné trvanie videa, fps a šírku a výšku rozlíšenia. Tieto vykázané hodnoty uchovajte spolu s dokončeným klipom namiesto považovania snímkovej frekvencie či rozmerov príkladu za pevnú špecifikáciu Q2. Odpoveď na vytvorenie úlohy obsahuje hodnotu credits spolu s konfiguráciou požiadavky. Tieto vykázané metadáta úlohy a identitu dokončeného výsledku uchovajte pri výsledku, aby každé video zostalo prepojené s nastaveniami jeho generovania.
Celú sekvenciu porovnajte s pôvodným zadaním: vzhľad hlavného objektu, tvar predmetu, smer pohybu, nadväznosť pohybu kamery a zamýšľaný konečný pohľad. Pri úprave určte konkrétny detail, ktorý nezodpovedal zadaniu, a zachovajte vydarené časti scény. Prompt, presný identifikátor, nastavenia, identitu úlohy a dokončené videá uchovajte spolu, aby neskoršie porovnanie vychádzalo zo skutočných výsledkov.
Ailoot Ultra · Generovanie videa POST /v1/videos viduq2
viduq2Úvod
Vidu Q2 vytvára video z textového zadania scény s trvaním 1–10 sekúnd, výstupom 540p, 720p alebo 1080p a piatimi pomermi strán. Tento konkrétny profil viduq2 určuje štýl a pohyb podľa promptu a vracia výsledok prostredníctvom asynchrónnej úlohy.
- Povolené vstupy
- Text
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Generovanie videa POST /v1/videos
- Vstup
text- Výstup
video
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity viduq2 | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Podmienky: Opíšte generovanú scénu. Zdokumentovaný limit je 2000 znakov; Ailoot kontroluje neprázdny reťazec a zachováva text. | Predvolené— |
Poleduration | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 1 Maximum: 10 Podmienky: Opis špecifický pre model viduq2 určuje 1–10 celých sekúnd. Nie je zdokumentovaná žiadna predvolená dĺžka špecifická pre model. Jednotka: sekundy | Predvolené— |
Poleseed | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Pre náhodnosť vynechajte alebo odošlite reťazec "0". Zadaná nenulová hodnota seed vyberie zdokumentované správanie s pevnou hodnotou seed; nie je určený žiadny číselný rozsah. | Predvolené— |
Poleaspect_ratio | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 16:9, 9:16, 3:4, 4:3, 1:1 | Predvolené16:9 |
Poleresolution | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 540p, 720p, 1080p Podmienky: Zoznam špecifický pre model viduq2 dokumentuje tieto pásma pre 1–10 sekúnd. Spoločný enum a tabuľka uvádzajú aj 360p; jeho použiteľnosť je v rozpore s týmto zoznamom a tu sa nepotvrdzuje. | Predvolené720p |
Polestyle | Typstring | PožiadavkaVoliteľné | Hodnoty a limity general, anime Podmienky: Spoločná požiadavka prijíma toto pole, dokumentácia však výslovne uvádza, že pri viduq2 nemá žiadny účinok. | Predvolenégeneral |
Polemovement_amplitude | Typstring | PožiadavkaVoliteľné | Hodnoty a limity auto, small, medium, large Podmienky: Spoločná požiadavka prijíma toto pole, dokumentácia však výslovne uvádza, že pri modeloch q2 nemá žiadny účinok. | Predvolenéauto |
Kombinácie vstupných podkladov
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt |
Parameteroptional | Špecifikáciaduration, seed, aspect_ratio, resolution, style, movement_amplitude |
Parametermaterial_types | Špecifikáciatext |
Parameteradditional_properties | Špecifikáciatrue |
Parametervalidation_scope | ŠpecifikáciaAiloot overuje neprázdne reťazce model/prompt. Voliteľné typy a limity nižšie predstavujú zdokumentovaný kontrakt požiadavky; ostatné polia požiadavky sa zachovávajú pre vybraný model. |
Aliasy metódy: /v1/videos/generations
Životný cyklus: 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
Vytvorte iba raz a zachovajte vrátené verejné id a polling_url.
Priebežne zisťujte stav pôvodnej operácie; hranicou dokončenia je success a výsledok creations[].url vo vašom vlastníctve.
Stiahnite každú vrátenú URL videa vo vašom vlastníctve; z príkladu nevyvodzujte pevný počet výstupov, dĺžku ani snímkovú frekvenciu.
Cenník
Ako sa vypočíta konečný poplatok
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Odhadované sadzby na porovnanie
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Odhadované množstvo | Poplatok |
|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $5.12 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie. |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
Ailoot Ultra · Generovanie videa
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
Prijať a uložiť výsledky
Ailoot Ultra · Generovanie videa
JSON zachováva natívny stav a pole creations, pričom pridáva verejné id/provider_task_id/polling_url. Vybrané URL videa sú pred zverejnením prázdne a po dokončení sa zmenia na podpísané URL vo vlastníctve Ailoot.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Uchovať všetky dokončené výsledky
Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.
Stiahnite každú skutočne vrátenú URL v creations[].url; index obsahu označuje jeden skutočne vrátený výstup.
Ak treba overiť pôvodnú odpoveď
Pevne stanovená deklarácia neuvádza žiadny konečný stav zlyhania. Zachovajte pôvodnú odpoveď, hlavičky a id a pri akomkoľvek nerozpoznanom stave alebo chybe result_pending_check skontrolujte tú istú operáciu; vytvorenie s neznámym výsledkom nikdy znova neodosielajte.
Polia odpovede
| Pole | Typ | Význam |
|---|---|---|
Poleid | Typstring | VýznamVrátený verejný identifikátor úlohy alebo operácie Ailoot. |
Poleprovider_task_id | Typstring | VýznamPôvodný identifikátor úlohy, oddelený od verejného id. |
Polepolling_url | Typstring | VýznamVrátená cesta Ailoot na vyhľadanie pôvodnej úlohy. |
Poletask_id | Typstring when supplied | VýznamPôvodný identifikátor prítomný v odpovedi na vytvorenie. |
Polestate | Typstring when supplied | VýznamNatívny stav úlohy: created pre pevne stanovený čakajúci stav a success pre dokončenie. |
Poleerr_code | Typstring when supplied | VýznamDiagnostika úlohy; uložená špecifikácia nedeklaruje žiadny vymenovaný zoznam chybových kódov. |
Polecreations[].url | Typstring|string[] | VýznamKaždá vybraná URL dokončeného videa sa nahradí podpísanou URL vo vlastníctve Ailoot. |
Polecreations[].video.duration | Typnumber when supplied | VýznamVrátená dĺžka videa; overte skutočný dokončený výsledok. |
Polecreations[].video.fps | Typinteger when supplied | VýznamVrátená snímková frekvencia; nesľubuje sa žiadna pevná snímková frekvencia. |
Polecreations[].video.resolution.width | Typinteger when supplied | VýznamVrátená šírka výstupu v pixeloch. |
Polecreations[].video.resolution.height | Typinteger when supplied | VýznamVrátená výška výstupu v pixeloch. |
Chyby a ďalšie kroky
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNeplatný JSON/model, chýbajúce alebo prázdne povinné reťazce alebo neplatný index obsahu. | Ďalší krok |
Odpoveď401 · authentication_error | PodmienkaNeplatný kľúč API služby Ailoot. | Ďalší krok |
Odpoveď403 · permission_error | PodmienkaSkupina kľúča API nemá povolený prístup k tejto mediálnej trase. | Ďalší krok |
Odpoveď404 · not_found_error | PodmienkaPôvodná úloha alebo požadovaný výstup chýbajú alebo nepatria rovnakému používateľovi, kľúču API či skupine. | Ďalší krok |
Odpoveď502 · result_pending_check | PodmienkaPôvodné odoslanie alebo stav sú neúplné alebo ich nemožno zosúladiť; zachovajte pôvodné ID a požiadavku znova neodosielajte. | Ďalší krok |
Odpoveď503 · result_pending_check | PodmienkaPôvodné priradenie, trasa alebo médium vo vašom vlastníctve sa stále kontrolujú; pokračujte v kontrole pôvodnej operácie. | Ďalší krok |
Odpoveď503 · server_error | PodmienkaMediálna služba alebo úložisko pôvodnej úlohy nie sú dostupné. | Ďalší krok |
Aliasy
Aliasy modelov
Ailoot Ultra viduq2
Aliasy ciest metód
/v1/videos/generations
Súvisiace ID na volanie
FAQ · Vidu: Q2 Text-to-Video
- Aké vstupy a výsledky sú dostupné?
POST /v1/videos·viduq2:text→video- Aké polia používa požiadavka?
POST /v1/videos·viduq2:model,prompt,duration,seed,aspect_ratio,resolution,style,movement_amplitude- Aké limity platia?
POST /v1/videos·viduq2:duration.minimum:1;duration.maximum:10