Vidu: Q2 Text-to-Video
Vidu Q2 lager video fra en scenebeskrivelse i tekst, med varighet på 1–10 sekunder, 540p, 720p eller 1080p som utdata og fem sideforhold. Denne bestemte viduq2-profilen bruker ledeteksten til stil og bevegelse og returnerer resultatet gjennom en asynkron oppgave.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
Vidu Q2 lager video fra en skriftlig scene gjennom profilen for tekst til video som velges med viduq2. De påkrevde inndataene er den nøyaktige modellidentifikatoren og en ledetekst som beskriver scenen. Bruk den til et kort produktkonsept, et etableringsbilde eller en figurs handling der utseende og bevegelse kan angis med ord. Denne konfigurerte metoden er tekst til video; beskrivelsen tilordner ikke velgeren en separat modus for bildereferanser eller videoredigering.
Bygg beskrivelsen rundt en synlig sekvens. Angi motiv, sted, handling, bildeutsnitt, kamerabevegelse og sluttkomposisjon. For et produktkonsept beskriver du en gjenstand på et bord, lys som beveger seg over materialet og en langsom kameratilnærming som ender ved en gjenkjennelig detalj. For en stedsscene etablerer du omgivelsene før kameraet beveger seg mot fokuspunktet. Tilpass handlingen til valgt klipplengde, slik at scenen har plass til den ønskede avslutningen.
Grensen for ledeteksten er 2,000 tegn. Sett det vesentlige motivet og handlingen først, og legg deretter til detaljer om lys, materiale, miljø og kamera som endrer ønsket resultat. Angi den visuelle stilen i ledeteksten. Den Q2-spesifikke veiledningen sier at de separate parameterne style og movement_amplitude ikke har effekt for denne modellen, så forhåndsinnstillingene general eller anime og valgene for bevegelsesutslag erstatter ikke en tydelig scenebeskrivelse.
Den modellspesifikke varighetsinnstillingen godtar hele sekunder fra én til ti. De Q2-spesifikke oppløsningsvalgene er 540p, 720p og 1080p, med 720p som dokumentert standard. Velg varighet og oppløsning sammen ut fra handlingen og bruksstedet. En kort avdekking og en lengre bevegelse trenger ulik tidsfordeling; en økning i ønsket varighet bør tjene den synlige sekvensen fremfor bare å strekke en uendret beskrivelse. Undersøk det returnerte klippets faktiske dimensjoner og lengde når du klargjør den endelige plasseringen.
De dokumenterte valgene for aspect_ratio er 16:9, 9:16, 3:4, 4:3 og 1:1, med 16:9 som standard. Veiledningen inkluderer uttrykkelig 3:4 og 4:3 for Q2-familien. Velg bildeformat før generering og beskriv en komposisjon som passer: hold hovedmotivet tydelig i et stående bilde, eller bruk bredden i et liggende bilde til omgivelsene. La sluttbildet være tydelig nok for den tiltenkte siden, presentasjonen eller senere teksting.
Feltet seed styrer variasjon. Å utelate det eller oppgi 0 velger en tilfeldig verdi; en verdi ulik null velger den dokumenterte innstillingen med fast seed for gjentakbar generering. Behold returnert seed sammen med ledeteksten og innstillingene når du sammenligner versjoner. Den felles operasjonen dokumenterer også innstillingene audio og off_peak spesielt for Q3-modeller. Disse Q3-valgene er ikke egenskaper tilordnet denne Q2-profilen; planlegg forespørselen rundt dens dokumenterte tekstinndata og videoutdata.
Genereringen er asynkron. Innsending returnerer task_id og en innledende tilstand, med created brukt for en nyopprettet oppgave. Behold oppgaveidentiteten mens du følger behandlingen. Den dokumenterte resultatspørringen bruker state=success for et vellykket resultat og returnerer et creations-array. Hvert element har videoens URL i creations[].url; lagre alle returnerte videoer fremfor å anta at oppgaven alltid inneholder nøyaktig ett generert resultat.
Resultatdokumentasjonen rapporterer også den faktiske videoens varighet, fps og oppløsningens bredde og høyde. Behold disse rapporterte verdiene sammen med det ferdige klippet fremfor å behandle et eksempels bildefrekvens eller dimensjoner som en fast Q2-spesifikasjon. Svaret ved opprettelse av oppgaven inkluderer en credits-verdi ved siden av forespørselskonfigurasjonen. Behold de rapporterte oppgavemetadataene og den fullførte oppgavens identitet sammen med resultatet, slik at hver video fortsatt er knyttet til genereringsinnstillingene sine.
Vurder hele sekvensen opp mot den opprinnelige beskrivelsen: motivets utseende, gjenstandens form, bevegelsesretning, kamerakontinuitet og ønsket sluttbilde. For en revisjon angir du den konkrete detaljen som ikke traff beskrivelsen, og bevarer de vellykkede delene av scenen. Behold ledeteksten, den nøyaktige velgeren, innstillingene, oppgaveidentiteten og de ferdige videoene samlet, slik at en senere sammenligning bygger på de faktiske resultatene.
Ailoot Ultra · Videogenerering POST /v1/videos viduq2
viduq2Start
Vidu Q2 lager video fra en scenebeskrivelse i tekst, med varighet på 1–10 sekunder, 540p, 720p eller 1080p som utdata og fem sideforhold. Denne bestemte viduq2-profilen bruker ledeteksten til stil og bevegelse og returnerer resultatet gjennom en asynkron oppgave.
- Godkjente inndata
- Tekst
- Resultater
- Video
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · Videogenerering POST /v1/videos
- Inndatatyper
text- Utdatatyper
video
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser viduq2 | Standard— |
Feltprompt | Typestring | KravPåkrevd | Verdier & grenser Vilkår: Beskriv scenen som skal genereres. Den dokumenterte grensen er 2000 tegn; Ailoot kontrollerer at strengen har innhold og bevarer teksten. | Standard— |
Feltduration | Typeinteger | KravValgfritt | Verdier & grenser Minimum: 1 Maksimum: 10 Vilkår: Den modellspesifikke beskrivelsen for viduq2 angir 1–10 hele sekunder. Ingen modellspesifikk standardvarighet er dokumentert. Enhet: sekunder | Standard— |
Feltseed | Typestring | KravValgfritt | Verdier & grenser Vilkår: Utelat feltet eller send strengen "0" for tilfeldighet. En oppgitt seed som ikke er null, velger den dokumenterte virkemåten med fast seed; intet numerisk intervall er angitt. | Standard— |
Feltaspect_ratio | Typestring | KravValgfritt | Verdier & grenser 16:9, 9:16, 3:4, 4:3, 1:1 | Standard16:9 |
Feltresolution | Typestring | KravValgfritt | Verdier & grenser 540p, 720p, 1080p Vilkår: Den modellspesifikke listen for viduq2 dokumenterer disse nivåene for 1–10 sekunder. En felles enum og tabell nevner også 360p; anvendelsen strider mot listen og forutsettes ikke her. | Standard720p |
Feltstyle | Typestring | KravValgfritt | Verdier & grenser general, anime Vilkår: Den felles forespørselen godtar dette feltet, men dokumentasjonen sier uttrykkelig at det ikke har noen virkning for viduq2. | Standardgeneral |
Feltmovement_amplitude | Typestring | KravValgfritt | Verdier & grenser auto, small, medium, large Vilkår: Den felles forespørselen godtar dette feltet, men dokumentasjonen sier uttrykkelig at det ikke har noen virkning for q2-modeller. | Standardauto |
Kombinasjoner av inngående materialer
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, prompt |
Parameteroptional | Avtaleduration, seed, aspect_ratio, resolution, style, movement_amplitude |
Parametermaterial_types | Avtaletext |
Parameteradditional_properties | Avtaletrue |
Parametervalidation_scope | AvtaleAiloot validerer at strengene model/prompt har innhold. De valgfrie typene og grensene nedenfor utgjør den dokumenterte forespørselskontrakten; andre forespørselsfelt bevares for den valgte modellen. |
Metodealiaser: /v1/videos/generations
Livssyklus: 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
Opprett én gang og behold returnert offentlig id og polling_url.
Spør jevnlig etter den opprinnelige operasjonen og les state; success og et creations[].url-resultat du eier, utgjør grensen for ferdigstilling.
Last ned hver returnerte URL for en video du eier; ikke utled et fast antall utdata, en fast varighet eller en fast bildefrekvens fra eksemplet.
Priser
Slik beregnes det endelige beløpet
De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Ikke angitt Når hurtigmodus er valgt
- Flex-modus
- Ikke angitt Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats
Estimerte satser for sammenligning
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Forventet mengde | Kostnad |
|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Forventet mengde— | Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $5.12 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen. |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Eksempelforespørsler
Ailoot Ultra · Videogenerering
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
Motta og lagre resultater
Ailoot Ultra · Videogenerering
JSON bevarer opprinnelig state og creations-matrisen, med offentlig id/provider_task_id/polling_url lagt til. Valgte videoadresser er tomme før publisering og blir signerte adresser som tilhører Ailoot etter ferdigstilling.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Behold alle ferdige resultater
Lagre hver ferdige video eller returnerte fil; hent hver faktisk returnerte ressurs-URL.
Last ned hver faktisk returnert URL i creations[].url; en innholdsindeks identifiserer ett faktisk returnert utdataelement.
Hvis det opprinnelige svaret må kontrolleres
Den fastsatte deklarasjonen oppgir ingen terminal feiltilstand. Behold opprinnelig svar, svarhoder og id, og kontroller den samme operasjonen ved enhver ukjent tilstand eller result_pending_check-feil; send aldri en opprettelse med ukjent utfall på nytt.
Svarfelter
| Felt | Type | Betydning |
|---|---|---|
Feltid | Typestring | BetydningReturnert offentlig identifikator for en oppgave eller operasjon i Ailoot. |
Feltprovider_task_id | Typestring | BetydningOpprinnelig oppgaveidentifikator, atskilt fra offentlig id. |
Feltpolling_url | Typestring | BetydningReturnert oppslagssti i Ailoot for den opprinnelige oppgaven. |
Felttask_id | Typestring when supplied | BetydningOpprinnelig identifikator som finnes i opprettelsessvaret. |
Feltstate | Typestring when supplied | BetydningOpprinnelig oppgavetilstand: created for den fastsatte ventetilstanden og success ved ferdigstilling. |
Felterr_code | Typestring when supplied | BetydningOppgavediagnostikk; den lagrede spesifikasjonen oppgir ingen opplisting av feilkoder. |
Feltcreations[].url | Typestring|string[] | BetydningHver valgt URL for en ferdigstilt video erstattes med en signert URL som tilhører Ailoot. |
Feltcreations[].video.duration | Typenumber when supplied | BetydningReturnert videovarighet; undersøk det faktiske ferdigstilte resultatet. |
Feltcreations[].video.fps | Typeinteger when supplied | BetydningReturnert bildefrekvens; ingen fast bildefrekvens loves. |
Feltcreations[].video.resolution.width | Typeinteger when supplied | BetydningReturnert utdatabredde i piksler. |
Feltcreations[].video.resolution.height | Typeinteger when supplied | BetydningReturnert utdatahøyde i piksler. |
Feil og neste trinn
| Svar | Vilkår | Neste trinn |
|---|---|---|
Svar400 · invalid_request_error | VilkårUgyldig JSON/modell, manglende eller tomme påkrevde strenger eller ugyldig innholdsindeks. | Neste trinn |
Svar401 · authentication_error | VilkårUgyldig Ailoot API-nøkkel. | Neste trinn |
Svar403 · permission_error | VilkårAPI-nøkkelgruppen har ikke tilgang til denne medieruten. | Neste trinn |
Svar404 · not_found_error | VilkårDen opprinnelige oppgaven eller de forespurte utdataene mangler eller tilhører ikke samme bruker/API-nøkkel/gruppe. | Neste trinn |
Svar502 · result_pending_check | VilkårDen opprinnelige innsendingen eller statusen er ufullstendig eller kan ikke avstemmes; behold den opprinnelige ID-en og ikke send inn på nytt. | Neste trinn |
Svar503 · result_pending_check | VilkårDen opprinnelige bindingen, ruten eller mediene du eier, kontrolleres fortsatt; fortsett å kontrollere den opprinnelige operasjonen. | Neste trinn |
Svar503 · server_error | VilkårMedietjenesten eller lagringen for den opprinnelige oppgaven er utilgjengelig. | Neste trinn |
Aliaser
Modellaliaser
Ailoot Ultra viduq2
Aliaser for metodestier
/v1/videos/generations
Tilknyttede anroper-ID-er
FAQ · Vidu: Q2 Text-to-Video
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/videos·viduq2:text→video- Hvilke felt bruker forespørselen?
POST /v1/videos·viduq2:model,prompt,duration,seed,aspect_ratio,resolution,style,movement_amplitude- Hvilke grenser gjelder?
POST /v1/videos·viduq2:duration.minimum:1;duration.maximum:10