models

Vidu: Q2 Text-to-Video

Markdown · JSON

Vidu: Q2 Text-to-Video

Vidu Q2 maakt video vanuit een tekstuele scènebeschrijving, met een duur van 1–10 seconden, uitvoer in 540p, 720p of 1080p en vijf beeldverhoudingen. Dit specifieke viduq2-profiel gebruikt de prompt voor stijl en beweging en geeft het resultaat via een asynchrone taak terug.

Over het model

Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.

Vidu Q2 maakt video vanuit een geschreven scène via het tekst-naar-video-profiel dat met viduq2 wordt geselecteerd. De vereiste invoer bestaat uit de exacte modelidentificator en een prompt die de scène beschrijft. Gebruik het voor een kort productconcept, een overzichtsbeeld of een handeling van een personage waarvan uiterlijk en beweging in woorden kunnen worden gespecificeerd. Deze geconfigureerde methode is tekst-naar-video; de beschrijving kent geen afzonderlijke modus voor afbeeldingsreferenties of videobewerking aan de selector toe.

Bouw de beschrijving rond een zichtbare reeks op. Benoem het onderwerp, de locatie, de handeling, de shotgrootte, de camerabeweging en de eindcompositie. Beschrijf bij een productconcept een object op een tafelblad, licht dat over het materiaal beweegt en een langzame camerabeweging ernaartoe die op een herkenbaar detail eindigt. Toon bij een locatiescène eerst de omgeving voordat u naar het aandachtspunt beweegt. Houd de handeling passend bij de gekozen cliplengte, zodat de scène ruimte heeft voor het beoogde einde.

De promptlimiet is 2.000 tekens. Zet het essentiële onderwerp en de handeling voorop en voeg daarna de details van belichting, materiaal, omgeving en camera toe die het gewenste resultaat veranderen. Specificeer de visuele stijl in de prompt. De Q2-specifieke handleiding vermeldt dat de afzonderlijke parameters style en movement_amplitude voor dit model geen effect hebben; de voorinstelling general of anime en de opties voor bewegingsamplitude vervangen dus geen duidelijke scènebeschrijving.

De modelspecifieke duurinstelling accepteert gehele seconden van één tot tien. De Q2-specifieke resolutiekeuzes zijn 540p, 720p en 1080p, met 720p als gedocumenteerde standaard. Kies duur en resolutie samen op basis van de handeling en de bestemming. Een korte onthulling en een langere beweging vereisen een andere timing; een hogere gevraagde duur moet de zichtbare reeks dienen, in plaats van alleen een ongewijzigde beschrijving uit te rekken. Controleer de werkelijke afmetingen en lengte van de teruggegeven clip bij het voorbereiden van de uiteindelijke plaatsing.

De gedocumenteerde keuzes voor aspect_ratio zijn 16:9, 9:16, 3:4, 4:3 en 1:1, met 16:9 als standaard. De handleiding neemt 3:4 en 4:3 expliciet op voor de Q2-familie. Kies het beeldformaat vóór de generatie en beschrijf een passende compositie: houd een hoofdonderwerp goed herkenbaar in een staand beeld of gebruik de breedte van een liggend beeld voor de omringende omgeving. Houd het eindbeeld duidelijk genoeg voor de beoogde pagina, presentatie of latere plaatsing van bijschriften.

Het veld seed regelt variatie. Weglaten of 0 opgeven kiest een willekeurige waarde; een niet-nulwaarde kiest de gedocumenteerde optie met een vaste seed voor herhaalbare generatie. Bewaar de teruggegeven seed bij de prompt en instellingen wanneer u versies vergelijkt. De gedeelde bewerking documenteert ook de instellingen audio en off_peak, specifiek voor Q3-modellen. Die Q3-opties zijn geen mogelijkheden die aan dit Q2-profiel zijn toegekend; plan deze aanvraag rond de gedocumenteerde tekstinvoer en video-uitvoer.

Generatie verloopt asynchroon. Indienen geeft task_id en een begintoestand terug, met created voor een nieuw aangemaakte taak. Bewaar die taakidentiteit tijdens het volgen van de verwerking. De gedocumenteerde resultaatopvraag gebruikt state=success voor een geslaagd resultaat en geeft een array creations terug. Elke vermelding bevat de video-URL in creations[].url; bewaar elke teruggegeven video in plaats van aan te nemen dat een taak altijd precies één creatie bevat.

De resultaatdocumentatie rapporteert ook de werkelijke duur, fps en resolutiebreedte en -hoogte van de video. Bewaar die gerapporteerde waarden bij de voltooide clip, in plaats van de beeldsnelheid of afmetingen uit een voorbeeld als vaste Q2-specificatie te behandelen. Het antwoord bij het aanmaken van de taak bevat naast de aanvraagconfiguratie een waarde credits. Bewaar die gerapporteerde taakmetadata en de voltooide identiteit bij het resultaat, zodat elke video verbonden blijft met de generatie-instellingen.

Controleer de volledige reeks aan de hand van de oorspronkelijke beschrijving: het uiterlijk van het onderwerp, objectvorm, bewegingsrichting, cameracontinuïteit en het beoogde eindbeeld. Benoem bij een herziening het concrete detail dat niet aan de opdracht voldeed en behoud de geslaagde delen van de scène. Bewaar de prompt, exacte selector, instellingen, taakidentiteit en voltooide video’s bij elkaar, zodat een latere vergelijking op de werkelijke resultaten berust.

Ailoot Ultra · Videogeneratie POST /v1/videos viduq2

viduq2

Vidu /viduq2

Aan de slag

Vidu Q2 maakt video vanuit een tekstuele scènebeschrijving, met een duur van 1–10 seconden, uitvoer in 540p, 720p of 1080p en vijf beeldverhoudingen. Dit specifieke viduq2-profiel gebruikt de prompt voor stijl en beweging en geeft het resultaat via een asynchrone taak terug.

Toegestane invoer
Tekst
Resultaten
Video

Beschikbaar in Ailoot · invoer en methoden

Ailoot Ultra · Videogeneratie POST /v1/videos
Invoer
text
Uitvoer
video
VeldTypeVereisteWaarden en limietenStandaard
VeldmodelTypestringVereisteVereistWaarden en limieten
viduq2
Standaard—
VeldpromptTypestringVereisteVereistWaarden en limieten
Voorwaarden: Beschrijf de te genereren scène. De gedocumenteerde limiet bedraagt 2000 tekens; Ailoot controleert of de tekenreeks niet leeg is en behoudt de tekst.
Standaard—
VelddurationTypeintegerVereisteOptioneelWaarden en limieten
Minimum: 1
Maximum: 10
Voorwaarden: De modelspecifieke beschrijving van viduq2 vermeldt 1–10 volledige seconden. Er is geen modelspecifieke standaardduur gedocumenteerd.
Eenheid: seconden
Standaard—
VeldseedTypestringVereisteOptioneelWaarden en limieten
Voorwaarden: Laat weg of verstuur de tekenreeks "0" voor willekeurige uitvoer. Een opgegeven seed met een waarde verschillend van nul selecteert het gedocumenteerde gedrag met een vaste seed; er is geen numeriek bereik opgegeven.
Standaard—
Veldaspect_ratioTypestringVereisteOptioneelWaarden en limieten
16:9, 9:16, 3:4, 4:3, 1:1
Standaard16:9
VeldresolutionTypestringVereisteOptioneelWaarden en limieten
540p, 720p, 1080p
Voorwaarden: De modelspecifieke lijst voor viduq2 documenteert deze categorieën voor 1–10 seconden. Een gedeelde enum en tabel vermelden ook 360p; het toepassingsgebied daarvan is in tegenspraak met die lijst en wordt hier niet bevestigd.
Standaard720p
VeldstyleTypestringVereisteOptioneelWaarden en limieten
general, anime
Voorwaarden: De gedeelde aanvraag accepteert dit veld, maar de documentatie vermeldt uitdrukkelijk dat het geen effect heeft voor viduq2.
Standaardgeneral
Veldmovement_amplitudeTypestringVereisteOptioneelWaarden en limieten
auto, small, medium, large
Voorwaarden: De gedeelde aanvraag accepteert dit veld, maar de documentatie vermeldt uitdrukkelijk dat het geen effect heeft voor q2-modellen.
Standaardauto
Combinaties van invoermaterialen

Methodeparameters en levenscyclus
ParameterContract
Parametercontent_typeContractapplication/json
ParameterrequiredContractmodel, prompt
ParameteroptionalContractduration, seed, aspect_ratio, resolution, style, movement_amplitude
Parametermaterial_typesContracttext
Parameteradditional_propertiesContracttrue
Parametervalidation_scopeContractAiloot valideert of de tekenreeksen model/prompt niet leeg zijn. De optionele types en limieten hieronder vormen het gedocumenteerde aanvraagcontract; andere aanvraagvelden blijven behouden voor het geselecteerde model.

Methodealiasnamen: /v1/videos/generations

Levenscyclus: 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

Maak eenmaal aan en bewaar de teruggestuurde openbare id en polling_url.

Vraag de oorspronkelijke operatie herhaaldelijk op en lees state; de voltooiing is bereikt bij success en een creations[].url-resultaat dat je toebehoort.

Download elke teruggestuurde video-URL die je toebehoort; leid uit het voorbeeld geen vast aantal uitvoerbestanden, vaste duur of vaste beeldfrequentie af.

Tarieven

Zo worden de uiteindelijke kosten berekend

De getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen niet de definitieve factureerbare hoeveelheid.

Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.

Snelle modus
Niet opgegeven Wanneer de snelle modus geselecteerd is
Flex-modus
Niet opgegeven Wanneer de flex-modus geselecteerd is
Maximale redeneerinspanning
Niet opgegeven Wanneer voor maximale redeneerinspanning de default-aanpassing wordt gebruikt

Geschatte tarieven ter vergelijking

Prijzen per configuratie

Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.

ConfiguratieTariefstaffelVerwachte hoeveelheidKosten
ConfiguratieBasistarieven voor tokensTariefstaffelBasistariefVerwachte hoeveelheid—Kosten
Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens
Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens
Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens
Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens
Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens
ConfiguratieGeschatte generatiekostenTariefstaffel—Verwachte hoeveelheidschatting voor één generatieKosten
Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $5.12 schatting vóór generatie

Deze raming is geen extra kost of vast tarief voor de voltooide generatie.

Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →

Voorbeeldverzoeken

Ailoot Ultra · Videogeneratie

curl · video makencurl · lees de oorspronkelijke taakcurl · al je eigen video's downloaden
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

Resultaten ophalen en opslaan

Ailoot Ultra · Videogeneratie

JSON behoudt de natieve state en creations-array en voegt de openbare id/provider_task_id/polling_url toe. Geselecteerde video-URL's zijn leeg vóór publicatie en worden na voltooiing ondertekende URL's van Ailoot.

  • GET /v1/videos/{request_id}
  • GET /v1/videos/generations/{request_id}
  • GET /v1/videos/{request_id}/content
  • GET /v1/videos/generations/{request_id}/content
Alle voltooide resultaten bewaren

Sla elke voltooide video of elk teruggegeven bestand op; haal elke daadwerkelijk teruggegeven bestands-URL op.

Download elke werkelijk teruggestuurde URL in creations[].url; een inhoudsindex verwijst naar één werkelijk teruggestuurd uitvoerbestand.

Als het oorspronkelijke antwoord moet worden gecontroleerd

De vastgezette declaratie somt geen terminale foutstatus op. Bewaar het oorspronkelijke antwoord, de headers en de id en controleer dezelfde operatie bij elke onbekende status of result_pending_check-fout; dien een aanmaakaanvraag met onbekende uitkomst nooit opnieuw in.

Antwoordvelden
VeldTypeBetekenis
VeldidTypestringBetekenisTeruggestuurde openbare taak- of operatiecode van Ailoot.
Veldprovider_task_idTypestringBetekenisOorspronkelijke taakcode, afzonderlijk van de openbare id.
Veldpolling_urlTypestringBetekenisTeruggestuurd opzoekpad van Ailoot voor de oorspronkelijke taak.
Veldtask_idTypestring when suppliedBetekenisOorspronkelijke identificatiecode uit het aanmaakantwoord.
VeldstateTypestring when suppliedBetekenisNatieve taakstatus: created voor de vastgezette wachtstatus en success bij voltooiing.
Velderr_codeTypestring when suppliedBetekenisTaakdiagnose; de opgeslagen specificatie declareert geen opgesomde lijst met foutcodes.
Veldcreations[].urlTypestring|string[]BetekenisElke geselecteerde URL van een voltooide video wordt vervangen door een ondertekende URL van Ailoot.
Veldcreations[].video.durationTypenumber when suppliedBetekenisTeruggestuurde videoduur; controleer het werkelijk voltooide resultaat.
Veldcreations[].video.fpsTypeinteger when suppliedBetekenisTeruggestuurde beeldfrequentie; er wordt geen vaste beeldfrequentie beloofd.
Veldcreations[].video.resolution.widthTypeinteger when suppliedBetekenisTeruggestuurde uitvoerbreedte in pixels.
Veldcreations[].video.resolution.heightTypeinteger when suppliedBetekenisTeruggestuurde uitvoerhoogte in pixels.
Fouten en vervolgstappen
AntwoordVoorwaardeVolgende stap
Antwoord400 · invalid_request_errorVoorwaardeOngeldige JSON of ongeldig model, ontbrekende of lege verplichte tekenreeksen, of een ongeldige inhoudsindex.Volgende stap
Antwoord401 · authentication_errorVoorwaardeOngeldige Ailoot API-sleutel.Volgende stap
Antwoord403 · permission_errorVoorwaardeDe groep van de API-sleutel heeft geen toegang tot deze mediaroute.Volgende stap
Antwoord404 · not_found_errorVoorwaardeDe oorspronkelijke taak of gevraagde uitvoer ontbreekt of behoort niet toe aan dezelfde gebruiker/API-sleutel/groep.Volgende stap
Antwoord502 · result_pending_checkVoorwaardeDe oorspronkelijke indiening of status is onvolledig of kan niet met de gegevens worden afgestemd; bewaar de oorspronkelijke ID en dien de aanvraag niet opnieuw in.Volgende stap
Antwoord503 · result_pending_checkVoorwaardeDe oorspronkelijke koppeling, route of media die je toebehoren worden nog gecontroleerd; blijf die oorspronkelijke operatie controleren.Volgende stap
Antwoord503 · server_errorVoorwaardeDe mediadienst of de opslag van de oorspronkelijke taak is niet beschikbaar.Volgende stap

Aliasnamen

Modelaliasnamen

Ailoot Ultra viduq2

Aliasnamen voor methodepaden

/v1/videos/generations

Gerelateerde aanroeper-ID’s

viduq2

FAQ · Vidu: Q2 Text-to-Video
Welke invoer en resultaten zijn beschikbaar?

POST /v1/videos · viduq2: text → video

Welke velden gebruikt het verzoek?

POST /v1/videos · viduq2: model, prompt, duration, seed, aspect_ratio, resolution, style, movement_amplitude

Welke limieten gelden?

POST /v1/videos · viduq2: duration.minimum: 1; duration.maximum: 10

Meer details

Verbind Ailoot met Claude Code, OpenCode, Hermes of je eigen applicatie.

Het bedrijf en zijn projectenportefeuille

Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden.

Koop tokens met korting.

Abonnementsvoordeel voor regelmatig gebruik. Promotiecodes geven tot 50% korting op tokens.

Abonnement
Kies een abonnement met korting voor je terugkerende verzoeken.
Promotiecode tot 50%
Vul de code bij aankoop in. De prijs wordt volgens de lopende actie herberekend.
Kosten in de geschiedenis
Model, tokens en bedrag worden per verzoek bewaard.

Kies een abonnement · Bekijk modelprijzen

Verbind de API met het product dat je verkoopt.

SaaS, apps en bots volgens de openbare aanbodvoorwaarden en licentieovereenkomst van Ailoot. Vraag voor doorverkoop een resellerlicentie aan.

Commerciële applicatie
Voeg tekst-, beeld-, video- en geluidsgeneratie aan betaalde functies van je service toe.
Resellerlicentie
Stuur een projectbeschrijving en toegangsschema. Vraag schriftelijke voorwaarden voor gebruik en doorverkoop.
Documenten op de site
Aanbodvoorwaarden, licentieovereenkomst en gegevensbeleid zijn vóór het verbinden beschikbaar.

Vraag een resellerlicentie aan · Aanbodvoorwaarden en licentieovereenkomst