Vidu: Q2 Text-to-Video
Vidu Q2 ustvari video iz besedilnega navodila za prizor s trajanjem 1–10 sekund, izhodom 540p, 720p ali 1080p in petimi razmerji stranic. Ta konkretni profil viduq2 za slog in gibanje uporablja poziv ter rezultat vrne prek asinhrone naloge.
O modelu
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
Vidu Q2 ustvari video iz pisnega opisa prizora prek profila za ustvarjanje videa iz besedila, izbranega z viduq2. Njegova obvezna vhoda sta natančni identifikator modela in poziv z opisom prizora. Uporabite ga za kratko produktno zamisel, uvodni splošni posnetek ali dejanje lika, katerega videz in gibanje lahko določite z besedami. Ta nastavljena metoda ustvarja video iz besedila; njen opis identifikatorju ne pripisuje ločenega načina slikovne reference ali urejanja videa.
Navodilo zasnujte okoli vidnega zaporedja. Določite glavni motiv, lokacijo, dejanje, velikost plana, gibanje kamere in končno kompozicijo. Pri produktni zamisli opišite predmet na mizi, svetlobo, ki potuje po njegovem materialu, in počasno približevanje kamere, ki se konča pri prepoznavni podrobnosti. Pri lokacijskem prizoru najprej predstavite okolje, nato se pomaknite proti osrednji točki. Dejanje prilagodite izbrani dolžini posnetka, da bo prizor imel prostor za predvideni zaključek.
Omejitev poziva je 2,000 znakov. Najprej navedite bistveni glavni motiv in dejanje, nato dodajte podrobnosti osvetlitve, materiala, okolja in kamere, ki spremenijo želeni rezultat. Vizualni slog določite v pozivu. Vodnik za Q2 navaja, da ločena parametra style in movement_amplitude pri tem modelu nimata učinka, zato prednastavitev general ali anime in možnosti amplitude gibanja ne nadomestijo jasnega opisa prizora.
Nastavitev trajanja za ta model sprejema cele sekunde od ene do deset. Izbire ločljivosti za Q2 so 540p, 720p in 1080p, pri čemer je dokumentirana privzeta vrednost 720p. Trajanje in ločljivost izberite skupaj glede na dejanje in končno uporabo. Kratko razkritje in daljše gibanje potrebujeta različen časovni potek; povečanje zahtevanega trajanja naj služi vidnemu zaporedju, namesto da zgolj raztegne nespremenjeno navodilo. Pri pripravi končne umestitve preverite dejanske mere in dolžino vrnjenega posnetka.
Dokumentirane izbire aspect_ratio so 16:9, 9:16, 3:4, 4:3 in 1:1, s privzeto vrednostjo 16:9. Vodnik izrecno vključuje 3:4 in 4:3 za družino Q2. Format izberite pred ustvarjanjem in opišite primerno kompozicijo: glavni motiv naj bo v pokončnem pogledu jasno razpoznaven ali pa širino ležečega kadra uporabite za okoliško okolje. Končni pogled naj ostane dovolj jasen za predvideno stran, predstavitev ali poznejše dodajanje napisa.
Polje seed upravlja variacije. Če ga izpustite ali podate 0, se izbere naključna vrednost; neničelna vrednost izbere dokumentirano možnost fiksnega začetnega stanja za ponovljivo ustvarjanje. Pri primerjavi različic vrnjeni seed shranite skupaj s pozivom in nastavitvami. Skupna operacija dokumentira tudi nastavitvi audio in off_peak posebej za modele Q3. Te možnosti Q3 niso zmogljivosti, pripisane temu profilu Q2; zahtevo načrtujte na podlagi njegovega dokumentiranega besedilnega vhoda in videoizhoda.
Ustvarjanje poteka asinhrono. Oddaja vrne task_id in začetno stanje, pri čemer se za novo ustvarjeno nalogo uporablja created. To identiteto naloge ohranite med spremljanjem obdelave. Dokumentirana poizvedba o rezultatu za uspešen rezultat uporablja state=success in vrne polje creations. Vsaka postavka ima URL svojega videa v creations[].url; shranite vsak vrnjeni video, namesto da predpostavljate, da naloga vedno vsebuje natanko en ustvarjeni rezultat.
Dokumentacija rezultata sporoča tudi dejansko trajanje videa, fps ter širino in višino ločljivosti. Te sporočene vrednosti shranite skupaj s končanim posnetkom, namesto da hitrost sličic ali mere iz primera obravnavate kot nespremenljivo specifikacijo Q2. Odgovor ob nastanku naloge vključuje vrednost credits skupaj s konfiguracijo zahteve. Sporočene metapodatke naloge in identiteto dokončanega rezultata hranite ob rezultatu, da bo vsak video ostal povezan z nastavitvami svojega ustvarjanja.
Celotno zaporedje preverite glede na izvorno navodilo: videz glavnega motiva, obliko predmeta, smer gibanja, kontinuiteto gibanja kamere in predvideni končni pogled. Pri predelavi določite konkretno podrobnost, ki ni ustrezala navodilu, ter ohranite uspešne dele prizora. Poziv, natančni identifikator, nastavitve, identiteto naloge in dokončane videe hranite skupaj, da bo poznejša primerjava temeljila na dejanskih rezultatih.
Ailoot Ultra · Videoposnetki POST /v1/videos viduq2
viduq2Začetek
Vidu Q2 ustvari video iz besedilnega navodila za prizor s trajanjem 1–10 sekund, izhodom 540p, 720p ali 1080p in petimi razmerji stranic. Ta konkretni profil viduq2 za slog in gibanje uporablja poziv ter rezultat vrne prek asinhrone naloge.
- Dovoljeni vhodi
- Besedilo
- Rezultati
- Video
Na voljo v Ailoot · vhodi in metode
Ailoot Ultra · Videoposnetki POST /v1/videos
- Vhod
text- Izhod
video
| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve viduq2 | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Pogoji: Opišite ustvarjeni prizor. Dokumentirana omejitev je 2000 znakov; Ailoot preveri neprazen niz in ohrani besedilo. | Privzeto— |
Poljeduration | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Največ: 10 Pogoji: Opis modela viduq2 določa 1–10 celih sekund. Privzeto trajanje za ta model ni dokumentirano. Enota: sekunde | Privzeto— |
Poljeseed | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Za naključnost izpustite ali pošljite niz "0". Podana neničelna vrednost seed izbere dokumentirano vedenje s fiksno vrednostjo seed; številčni razpon ni določen. | Privzeto— |
Poljeaspect_ratio | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 16:9, 9:16, 3:4, 4:3, 1:1 | Privzeto16:9 |
Poljeresolution | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 540p, 720p, 1080p Pogoji: Seznam za model viduq2 dokumentira te razrede za 1–10 sekund. Skupni enum in tabela omenjata tudi 360p; njegova veljavnost je v nasprotju s tem seznamom in tu ni zagotovljena. | Privzeto720p |
Poljestyle | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve general, anime Pogoji: Skupna zahteva sprejme to polje, vendar dokumentacija izrecno navaja, da pri viduq2 nima učinka. | Privzetogeneral |
Poljemovement_amplitude | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve auto, small, medium, large Pogoji: Skupna zahteva sprejme to polje, vendar dokumentacija izrecno navaja, da pri modelih q2 nima učinka. | Privzetoauto |
Kombinacije vhodnih gradiv
Parametri in življenjski cikel metode
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, prompt |
Parameteroptional | Specifikacijaduration, seed, aspect_ratio, resolution, style, movement_amplitude |
Parametermaterial_types | Specifikacijatext |
Parameteradditional_properties | Specifikacijatrue |
Parametervalidation_scope | SpecifikacijaAiloot preveri neprazna niza model/prompt. Spodnje neobvezne vrste in omejitve so dokumentirana pogodba zahteve; druga polja zahteve se ohranijo za izbrani model. |
Druga imena metode: /v1/videos/generations
Življenjski cikel: 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
Ustvarite enkrat in ohranite vrnjena javna id in polling_url.
Preverjajte prvotno operacijo in berite state; success skupaj z rezultatom creations[].url v vaši lasti predstavlja mejo dokončanja.
Prenesite vsak vrnjeni URL videa v vaši lasti; iz primera ne sklepajte o stalnem številu izhodov, trajanju ali hitrosti sličic.
Cenik
Kako se izračuna končni strošek
Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
- Hitri način
- Ni navedeno Ko je izbran hitri način
- Način flex
- Ni navedeno Ko je izbran način flex
- Najvišja raven razmišljanja
- Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)
Ocenjene cene za primerjavo
Cene po nastavitvah
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Cenovna lestvica | Predvidena količina | Strošek |
|---|---|---|---|
| NastavitevOsnovne cene žetonov | Cenovna lestvicaOsnovna cena | Predvidena količina— | Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov |
| NastavitevOcenjeni strošek ustvarjanja | Cenovna lestvica— | Predvidena količinaocena za eno generiranje | Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $5.12 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje. |
Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →
Primeri zahtev
Ailoot Ultra · Videoposnetki
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
Prejmi in shrani rezultate
Ailoot Ultra · Videoposnetki
JSON ohrani izvorni state in polje creations, z dodanimi javnimi id/provider_task_id/polling_url. Izbrani video URL-ji so pred objavo prazni, po dokončanju pa postanejo podpisani URL-ji v lasti Ailoot.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Ohrani vse dokončane rezultate
Shranite vsak dokončan video ali vrnjeno datoteko; pridobite vsebino z vsake dejansko vrnjene URL gradiva.
Prenesite vsak dejansko vrnjeni URL v creations[].url; indeks vsebine označuje en dejanski vrnjeni izhod.
Če je treba preveriti izvirni odgovor
Pripeta deklaracija ne navaja nobenega končnega neuspešnega stanja. Ohranite prvotni odgovor/glave/id in pri vsakem neprepoznanem stanju ali napaki result_pending_check preverjajte isto operacijo; neznanega ustvarjanja nikoli ne oddajte znova.
Polja odgovora
| Polje | Vrsta | Pomen |
|---|---|---|
Poljeid | Vrstastring | PomenVrnjeni javni identifikator opravila ali operacije Ailoot. |
Poljeprovider_task_id | Vrstastring | PomenPrvotni identifikator opravila, ločen od javnega id. |
Poljepolling_url | Vrstastring | PomenVrnjena pot Ailoot za poizvedbo o prvotnem opravilu. |
Poljetask_id | Vrstastring when supplied | PomenPrvotni identifikator, prisoten v odgovoru ustvarjanja. |
Poljestate | Vrstastring when supplied | PomenIzvorno stanje opravila: created za pripeto čakajoče stanje in success za dokončanje. |
Poljeerr_code | Vrstastring when supplied | PomenDiagnostika opravila; shranjena specifikacija ne določa seznama možnih kod napak. |
Poljecreations[].url | Vrstastring|string[] | PomenVsak izbrani URL dokončanega videa se nadomesti s podpisanim URL-jem v lasti Ailoot. |
Poljecreations[].video.duration | Vrstanumber when supplied | PomenVrnjeno trajanje videa; preverite dejanski dokončani rezultat. |
Poljecreations[].video.fps | Vrstainteger when supplied | PomenVrnjena hitrost sličic; stalna hitrost sličic ni zagotovljena. |
Poljecreations[].video.resolution.width | Vrstainteger when supplied | PomenVrnjena širina izhoda v slikovnih pikah. |
Poljecreations[].video.resolution.height | Vrstainteger when supplied | PomenVrnjena višina izhoda v slikovnih pikah. |
Napake in naslednji koraki
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor400 · invalid_request_error | PogojNeveljaven JSON/model, manjkajoči ali prazni obvezni nizi ali neveljaven indeks vsebine. | Naslednji korak |
Odgovor401 · authentication_error | PogojNeveljaven ključ Ailoot API. | Naslednji korak |
Odgovor403 · permission_error | PogojSkupina ključa API nima dovoljenja za to medijsko pot. | Naslednji korak |
Odgovor404 · not_found_error | PogojPrvotno opravilo ali zahtevani izhod manjka ali ni v lasti istega uporabnika/ključa API/skupine. | Naslednji korak |
Odgovor502 · result_pending_check | PogojPrvotna oddaja ali stanje sta nepopolna ali ju ni mogoče uskladiti; ohranite prvotni ID in zahteve ne oddajte znova. | Naslednji korak |
Odgovor503 · result_pending_check | PogojPrvotna povezava, pot ali medij v vaši lasti se še preverja; nadaljujte preverjanje te prvotne operacije. | Naslednji korak |
Odgovor503 · server_error | PogojMedijska storitev ali shramba prvotnega opravila ni na voljo. | Naslednji korak |
Druga imena
Druga imena modelov
Ailoot Ultra viduq2
Druga imena poti metod
/v1/videos/generations
Povezani ID-ji za klic
FAQ · Vidu: Q2 Text-to-Video
- Kateri vhodi in rezultati so na voljo?
POST /v1/videos·viduq2:text→video- Katera polja uporablja zahteva?
POST /v1/videos·viduq2:model,prompt,duration,seed,aspect_ratio,resolution,style,movement_amplitude- Katere omejitve veljajo?
POST /v1/videos·viduq2:duration.minimum:1;duration.maximum:10