Vidu: Q2 Text-to-Video
Vidu Q2 luo videoita tekstimuotoisesta kohtauskuvauksesta. Kesto on 1–10 sekuntia, tuloksen resoluutio 540p, 720p tai 1080p ja kuvasuhteita on viisi. Tämä täsmällinen viduq2-profiili käyttää kehotetta tyylin ja liikkeen määrittämiseen ja palauttaa tuloksen asynkronisen tehtävän kautta.
Tietoa mallista
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Vidu Q2 luo videoita kirjoitetusta kohtauksesta tekstistä videoksi -profiililla, joka valitaan tunnuksella viduq2. Pakolliset syötteet ovat täsmällinen mallitunnus ja kohtausta kuvaava kehote. Käytä sitä lyhyeen tuoteideaan, paikan esittelevään yleiskuvaan tai hahmon toimintaan, jonka ulkonäön ja liikkeen voi määrittää sanoin. Tämä määritetty menetelmä luo videoita tekstistä; sen kuvaus ei liitä valitsimeen erillistä kuvaviite- tai videonmuokkaustilaa.
Rakenna kuvaus näkyvän tapahtumaketjun ympärille. Nimeä kohde, paikka, toiminta, kuvakoko, kameran liike ja lopullinen sommitelma. Kuvaa tuoteideassa pöydällä oleva esine, sen materiaalin yli liikkuva valo ja hidas kameran lähestyminen, joka päättyy tunnistettavaan yksityiskohtaan. Paikkaa esittelevässä kohtauksessa näytä ympäristö ennen siirtymistä huomion kohteeseen. Sovita toiminta valittuun leikkeen pituuteen, jotta kohtauksessa on tilaa suunnitellulle lopetukselle.
Kehotteen enimmäispituus on 2,000 merkkiä. Kerro tärkein kohde ja toiminta ensin ja lisää sitten valaistus, materiaali, ympäristö ja kameran yksityiskohdat, jotka muuttavat haluttua tulosta. Määritä visuaalinen tyyli kehotteessa. Q2-kohtainen ohje kertoo, että erilliset style- ja movement_amplitude-parametrit eivät vaikuta tässä mallissa, joten general- tai anime-esiasetus ja liikkeen voimakkuuden valinnat eivät korvaa selkeää kohtauskuvausta.
Mallikohtainen kestoasetus hyväksyy kokonaisia sekunteja yhdestä kymmeneen. Q2-kohtaiset resoluutiovaihtoehdot ovat 540p, 720p ja 1080p, ja dokumentoitu oletus on 720p. Valitse kesto ja resoluutio yhdessä toiminnan ja kohdekäytön mukaan. Lyhyt paljastus ja pidempi liike tarvitsevat erilaisen ajoituksen; pyydetyn keston kasvattamisen tulee palvella näkyvää tapahtumaketjua eikä vain venyttää muuttumatonta kuvausta. Tarkista palautetun leikkeen todelliset mitat ja pituus, kun valmistelet lopullista sijoittelua.
Dokumentoidut aspect_ratio-vaihtoehdot ovat 16:9, 9:16, 3:4, 4:3 ja 1:1, ja oletus on 16:9. Ohje sisältää nimenomaisesti kuvasuhteet 3:4 ja 4:3 Q2-perheelle. Valitse kuvasuhde ennen luomista ja kuvaa siihen sopiva sommitelma: pidä pääkohde selkeästi hahmotettavana pystykuvassa tai käytä vaakakuvan leveyttä ympäristön esittämiseen. Jätä loppunäkymä riittävän selkeäksi aiottua sivua, esitystä tai myöhempää tekstitystä varten.
seed-kenttä ohjaa vaihtelua. Kentän jättäminen pois tai arvon 0 antaminen valitsee satunnaisen arvon; nollasta poikkeava arvo valitsee dokumentoidun kiinteän seed-arvon toistettavaa luomista varten. Säilytä palautettu seed kehotteen ja asetusten kanssa, kun vertaat versioita. Yhteinen toiminto dokumentoi myös audio- ja off_peak-asetukset nimenomaan Q3-malleille. Nämä Q3-valinnat eivät ole tämän Q2-profiilin ominaisuuksia; suunnittele pyyntö sen dokumentoidun tekstisyötteen ja videotuloksen ympärille.
Luominen on asynkronista. Lähetys palauttaa kentän task_id ja alkutilan; uudelle tehtävälle käytetään arvoa created. Säilytä tehtävän tunniste, kun seuraat käsittelyä. Dokumentoitu tuloskysely käyttää onnistuneelle tulokselle arvoa state=success ja palauttaa creations-taulukon. Kunkin alkion videon URL on kentässä creations[].url; tallenna jokainen palautettu video sen sijaan, että olettaisit tehtävän sisältävän aina täsmälleen yhden luomuksen.
Tulosdokumentaatio ilmoittaa myös todellisen videon keston, fps-arvon sekä resoluution leveyden ja korkeuden. Säilytä nämä ilmoitetut arvot valmiin leikkeen mukana sen sijaan, että pitäisit esimerkin kuvataajuutta tai mittoja kiinteänä Q2-määrityksenä. Tehtävän luontivastaus sisältää credits-arvon pyynnön kokoonpanon rinnalla. Säilytä nämä ilmoitetut tehtävän metatiedot ja valmiin tehtävän tunniste tuloksen mukana, jotta jokainen video pysyy yhdistettynä luomisasetuksiinsa.
Vertaa koko tapahtumaketjua alkuperäiseen kuvaukseen: kohteen ulkonäköä, esineen muotoa, liikkeen suuntaa, kameran jatkuvuutta ja tavoiteltua loppunäkymää. Nimeä muokkausta varten konkreettinen yksityiskohta, joka ei vastannut kuvausta, ja säilytä kohtauksen onnistuneet osat. Pidä kehote, täsmällinen valitsin, asetukset, tehtävän tunniste ja valmiit videot yhdessä, jotta myöhempi vertailu perustuu todellisiin tuotoksiin.
Ailoot Ultra · Videot POST /v1/videos viduq2
viduq2Aloitus
Vidu Q2 luo videoita tekstimuotoisesta kohtauskuvauksesta. Kesto on 1–10 sekuntia, tuloksen resoluutio 540p, 720p tai 1080p ja kuvasuhteita on viisi. Tämä täsmällinen viduq2-profiili käyttää kehotetta tyylin ja liikkeen määrittämiseen ja palauttaa tuloksen asynkronisen tehtävän kautta.
- Hyväksytyt syötteet
- Teksti
- Tulokset
- Video
Saatavilla Ailootissa · syötteet & menetelmät
Ailoot Ultra · Videot POST /v1/videos
- Syötetyypit
text- Tulostyypit
video
| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat viduq2 | Oletus— |
Kenttäprompt | Tyyppistring | VaatimusPakollinen | Arvot & rajat Ehdot: Kuvaile luotava kohtaus. Dokumentoitu raja on 2000 merkkiä; Ailoot tarkistaa, että merkkijono ei ole tyhjä, ja säilyttää tekstin. | Oletus— |
Kenttäduration | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 10 Ehdot: Mallikohtainen viduq2-kuvaus määrittää kestoksi 1–10 kokonaista sekuntia. Mallikohtaista oletuskestoa ei ole dokumentoitu. Yksikkö: sekuntia | Oletus— |
Kenttäseed | Tyyppistring | VaatimusValinnainen | Arvot & rajat Ehdot: Jätä pois tai lähetä merkkijono "0" satunnaisuutta varten. Annettu nollasta poikkeava seed valitsee dokumentoidun kiinteää seed-arvoa käyttävän toiminnan; numeerista vaihteluväliä ei ole määritetty. | Oletus— |
Kenttäaspect_ratio | Tyyppistring | VaatimusValinnainen | Arvot & rajat 16:9, 9:16, 3:4, 4:3, 1:1 | Oletus16:9 |
Kenttäresolution | Tyyppistring | VaatimusValinnainen | Arvot & rajat 540p, 720p, 1080p Ehdot: Mallikohtainen viduq2-luettelo dokumentoi nämä luokat kestolle 1–10 sekuntia. Yhteinen enum ja taulukko mainitsevat myös arvon 360p; sen sovellettavuus on ristiriidassa luettelon kanssa, eikä sitä vahvisteta tässä. | Oletus720p |
Kenttästyle | Tyyppistring | VaatimusValinnainen | Arvot & rajat general, anime Ehdot: Yhteinen pyyntörakenne hyväksyy tämän kentän, mutta dokumentaatio toteaa nimenomaisesti, ettei sillä ole vaikutusta viduq2-malliin. | Oletusgeneral |
Kenttämovement_amplitude | Tyyppistring | VaatimusValinnainen | Arvot & rajat auto, small, medium, large Ehdot: Yhteinen pyyntörakenne hyväksyy tämän kentän, mutta dokumentaatio toteaa nimenomaisesti, ettei sillä ole vaikutusta q2-malleihin. | Oletusauto |
Syöteaineistojen yhdistelmät
Menetelmän parametrit ja elinkaari
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, prompt |
Parametrioptional | Sopimusduration, seed, aspect_ratio, resolution, style, movement_amplitude |
Parametrimaterial_types | Sopimustext |
Parametriadditional_properties | Sopimustrue |
Parametrivalidation_scope | SopimusAiloot validoi ei-tyhjät model/prompt-merkkijonot. Alla olevat valinnaiset tyypit ja rajat muodostavat dokumentoidun pyyntösopimuksen; muut pyyntökentät säilytetään valittua mallia varten. |
Menetelmien aliakset: /v1/videos/generations
Elinkaari: 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
Luo kerran ja säilytä palautettu julkinen id ja polling_url.
Kysy alkuperäisen operaation tilaa ja lue state; valmistuminen edellyttää success-tilaa ja käyttäjälle kuuluvaa creations[].url-tulosta.
Lataa video jokaisesta palautetusta käyttäjälle kuuluvasta URL-osoitteesta; älä päättele esimerkistä kiinteää tulosmäärää, kestoa tai kuvataajuutta.
Hinnoittelu
Lopullisen veloituksen laskenta
Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
- Nopea tila
- Ei määritetty Kun nopea tila on valittu
- Flex-tila
- Ei määritetty Kun flex-tila on valittu
- Päättelyn enimmäisteho
- Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä
Arvioidut vertailuhinnat
Hinnat asetusten mukaan
Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.
| Asetukset | Hinnasto | Ennustettu määrä | Veloitus |
|---|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Ennustettu määrä— | Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia |
| AsetuksetArvioitu luontikustannus | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $5.12 arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta. |
Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
Esimerkkipyynnöt
Ailoot Ultra · Videot
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
Vastaanota ja tallenna tulokset
Ailoot Ultra · Videot
JSON säilyttää natiivin state-kentän ja creations-taulukon, ja siihen lisätään julkinen id/provider_task_id/polling_url. Valitut video-osoitteet ovat tyhjiä ennen julkaisua ja muuttuvat Ailoot-palvelun hallinnoimiksi allekirjoitetuiksi osoitteiksi valmistumisen jälkeen.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Säilytä kaikki valmistuneet tulokset
Tallenna jokainen valmistunut video tai palautettu tiedosto; nouda jokainen todellinen palautettu aineiston URL.
Lataa jokainen creations[].url-kentässä todellisuudessa palautettu URL; sisältöindeksi yksilöi yhden todellisen palautetun tuloksen.
Jos alkuperäinen vastaus on tarkistettava
Lukittu määrittely ei luettele yhtään lopullista epäonnistumistilaa. Säilytä alkuperäinen vastaus, otsakkeet ja id sekä tarkista sama operaatio, jos tila on tuntematon tai ilmenee result_pending_check-virhe; älä koskaan lähetä tuntemattomaan tilaan jäänyttä luontipyyntöä uudelleen.
Vastauksen kentät
| Kenttä | Tyyppi | Merkitys |
|---|---|---|
Kenttäid | Tyyppistring | MerkitysPalautettu julkinen Ailoot-tehtävän tai -operaation tunniste. |
Kenttäprovider_task_id | Tyyppistring | MerkitysAlkuperäinen tehtävätunniste, joka on erillinen julkisesta id-tunnisteesta. |
Kenttäpolling_url | Tyyppistring | MerkitysPalautettu Ailoot-hakupolku alkuperäiselle tehtävälle. |
Kenttätask_id | Tyyppistring when supplied | MerkitysLuontivastauksessa oleva alkuperäinen tunniste. |
Kenttästate | Tyyppistring when supplied | MerkitysNatiivi tehtävätila: created lukitulle odotustilalle ja success valmistumiselle. |
Kenttäerr_code | Tyyppistring when supplied | MerkitysTehtävän diagnostiikkatiedot; tallennettu määrittely ei sisällä virhekoodien luetteloa. |
Kenttäcreations[].url | Tyyppistring|string[] | MerkitysJokainen valittu valmistuneen videon URL korvataan Ailoot-palvelun hallinnoimalla allekirjoitetulla URL-osoitteella. |
Kenttäcreations[].video.duration | Tyyppinumber when supplied | MerkitysPalautettu videon kesto; tarkista todellinen valmistunut tulos. |
Kenttäcreations[].video.fps | Tyyppiinteger when supplied | MerkitysPalautettu kuvataajuus; kiinteää kuvataajuutta ei luvata. |
Kenttäcreations[].video.resolution.width | Tyyppiinteger when supplied | MerkitysPalautetun tuloksen leveys pikseleinä. |
Kenttäcreations[].video.resolution.height | Tyyppiinteger when supplied | MerkitysPalautetun tuloksen korkeus pikseleinä. |
Virheet ja seuraavat vaiheet
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoVirheellinen JSON/model, puuttuvat tai tyhjät pakolliset merkkijonot tai virheellinen sisältöindeksi. | Seuraava vaihe |
Vastaus401 · authentication_error | EhtoVirheellinen Ailoot API -avain. | Seuraava vaihe |
Vastaus403 · permission_error | EhtoAPI-avaimen ryhmällä ei ole käyttöoikeutta tähän mediareittiin. | Seuraava vaihe |
Vastaus404 · not_found_error | EhtoAlkuperäinen tehtävä tai pyydetty tulos puuttuu tai ei kuulu samalle käyttäjälle/API-avaimelle/ryhmälle. | Seuraava vaihe |
Vastaus502 · result_pending_check | EhtoAlkuperäinen lähetys tai tilatieto on puutteellinen tai sitä ei voida täsmäyttää; säilytä alkuperäinen tunniste äläkä lähetä pyyntöä uudelleen. | Seuraava vaihe |
Vastaus503 · result_pending_check | EhtoAlkuperäistä sidontaa, reittiä tai käyttäjälle kuuluvaa mediaa tarkistetaan edelleen; jatka saman alkuperäisen operaation tarkistamista. | Seuraava vaihe |
Vastaus503 · server_error | EhtoMediapalvelu tai alkuperäisen tehtävän tallennustila ei ole saatavilla. | Seuraava vaihe |
Aliakset
Mallin aliakset
Ailoot Ultra viduq2
Menetelmäpolkujen aliakset
/v1/videos/generations
Liittyvät kutsujan ID:t
FAQ · Vidu: Q2 Text-to-Video
- Mitä syötteitä ja tuloksia on saatavilla?
POST /v1/videos·viduq2:text→video- Mitä kenttiä pyyntö käyttää?
POST /v1/videos·viduq2:model,prompt,duration,seed,aspect_ratio,resolution,style,movement_amplitude- Mitä rajoja sovelletaan?
POST /v1/videos·viduq2:duration.minimum:1;duration.maximum:10