viduq2-turbo
Vidu Q2 Turbo erstellt ein Video aus einem Prompt mit optionaler Führung durch ein Bild und ein Schlussbild. Wählen Sie über Ailoot eine Dauer von einer bis zehn Sekunden, den Bildausschnitt und die Auflösung.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Wählen Sie viduq2-turbo mit model und prompt aus. Die Anfrage stellt image als String oder als Array mit bis zu zehn Strings sowie end_image, eine Dauer von einer bis zehn Sekunden und eine Auflösung von 540p, 720p oder 1080p bereit. Zur Auswahl der Seitenverhältnisse gehören Querformat, Hochformat, Quadrat, 4:3 und 3:4.
Bereiten Sie eine klar erkennbare Handlung mit einem festgelegten Endzustand vor. Beschreiben Sie im Prompt die anfängliche Bildkomposition, die Bewegung und die Kameraführung. Wenn Bilder die Aufnahme anleiten, benennen Sie den Beitrag jedes Bildes und die Details, die im Ergebnis erhalten bleiben sollen. Geben Sie die abschließende Bildkomposition ausdrücklich an und bewahren Sie die gewählten Referenzen und Steuerungsparameter beim fertigen Clip auf, um ihn gezielt prüfen zu können.
Reichen Sie die Aufnahme einmal über /v1/videos ein und bewahren Sie die zurückgegebene Anfrage-ID auf. Fragen Sie den Status desselben Vorgangs über /v1/videos/{request_id} ab und speichern Sie anschließend jede fertiggestellte Videoausgabe sowie die vollständige Antwort. Prüfen Sie den gesamten Handlungsablauf und die abschließende Bildkomposition anhand des bereitgestellten Materials und des Briefings.
Ailoot Ultra · Video POST /v1/videos viduq2-turbo
viduq2-turboEinstieg
Vidu Q2 Turbo erstellt ein Video aus einem Prompt mit optionaler Führung durch ein Bild und ein Schlussbild. Wählen Sie über Ailoot eine Dauer von einer bis zehn Sekunden, den Bildausschnitt und die Auflösung.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- Video
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Video POST /v1/videos
- Eingabe
text,image- Ausgabe
video
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits viduq2-turbo Bedingungen: Verwenden Sie genau diesen Ailoot-Routingselektor. | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 16:9, 1:1, 9:16, 4:3, 3:4 Bedingungen: Verwenden Sie das für das ausgewählte Modell dokumentierte Feld und die aufgeführten Auswahlwerte; lassen Sie einen nicht angegebenen optionalen Wert weg. | Standard— |
Feldduration | Typinteger | AnforderungOptional | Werte und Limits 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 Bedingungen: Verwenden Sie das für das ausgewählte Modell dokumentierte Feld und die aufgeführten Auswahlwerte; lassen Sie einen nicht angegebenen optionalen Wert weg. | Standard— |
Feldend_image | Typstring | AnforderungOptional | Werte und Limits Bedingungen: Verwenden Sie das für das ausgewählte Modell dokumentierte Feld und die aufgeführten Auswahlwerte; lassen Sie einen nicht angegebenen optionalen Wert weg. | Standard— |
Feldimage | Typstring or array<string> | AnforderungOptional | Werte und Limits Bedingungen: Geben Sie Ihre tatsächliche erreichbare Bild-URL an. Eine Liste wird nur akzeptiert, wenn das Parameterschema ein Array vorsieht. | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Bedingungen: Verwenden Sie das für das ausgewählte Modell dokumentierte Feld und die aufgeführten Auswahlwerte; lassen Sie einen nicht angegebenen optionalen Wert weg. | Standard— |
Feldresolution | Typstring | AnforderungOptional | Werte und Limits 540p, 720p, 1080p Bedingungen: Verwenden Sie das für das ausgewählte Modell dokumentierte Feld und die aufgeführten Auswahlwerte; lassen Sie einen nicht angegebenen optionalen Wert weg. | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parameteroptional | Vertragaspect_ratio, duration, end_image, image, resolution |
Parametermaterial_types | Vertragtext, image |
Parameterconditions | VertragVerwenden Sie genau diesen Ailoot-Routingselektor., Verwenden Sie das für das ausgewählte Modell dokumentierte Feld und die aufgeführten Auswahlwerte; lassen Sie einen nicht angegebenen optionalen Wert weg., Verwenden Sie das für das ausgewählte Modell dokumentierte Feld und die aufgeführten Auswahlwerte; lassen Sie einen nicht angegebenen optionalen Wert weg., Verwenden Sie das für das ausgewählte Modell dokumentierte Feld und die aufgeführten Auswahlwerte; lassen Sie einen nicht angegebenen optionalen Wert weg., Geben Sie Ihre tatsächliche erreichbare Bild-URL an. Eine Liste wird nur akzeptiert, wenn das Parameterschema ein Array vorsieht., Verwenden Sie das für das ausgewählte Modell dokumentierte Feld und die aufgeführten Auswahlwerte; lassen Sie einen nicht angegebenen optionalen Wert weg., Verwenden Sie das für das ausgewählte Modell dokumentierte Feld und die aufgeführten Auswahlwerte; lassen Sie einen nicht angegebenen optionalen Wert weg. |
Methodenaliasnamen: /v1/videos/generations
Lebenszyklus: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Gebühr |
|---|---|---|---|
| KonfigurationBasistarife für Tokens | TarifstaffelGrundtarif | Prognostizierte Menge— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · In Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · In Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.1 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "viduq2-turbo", "prompt": "A cat is walking on grass.", "image": "YOUR_ACCESSIBLE_IMAGE_URL"}')
p['image']=os.environ['AILOOT_IMAGE_URL']
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_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
# Submit once. Retain the complete result, original identifiers and every response header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
Ergebnisse abrufen und speichern
Ailoot Ultra · Video
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.
Bewahren Sie die vollständige Antwort und die Header, die ursprünglichen Kennungen, jede tatsächliche Ausgabe und alle Verbrauchs- und Abrechnungsfelder auf. Speichern Sie jedes eindeutige, Ihnen zugeordnete Asset und erhalten Sie jede Rolle, die darauf verweist.
Wenn die ursprüngliche Antwort geprüft werden muss
Bewahren Sie die zurückgegebene öffentliche Aufgaben- oder Vorgangs-id und alle Header auf. Lesen Sie ausschließlich die ursprüngliche Aufgabe; unknown oder result_pending_check berechtigen nicht zu einer weiteren Erstellung.
Antwortfelder
| Feld | Typ |
|---|---|
Feldid | Typstring |
Feldpolling_url | Typstring |
Feldprovider_task_id | Typstring |
Feldtask_id | Typstring |
Feldstatus | Typstring |
Feldvideo_url | Typstring |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungEin Pflichtfeld, die Modellauswahl, der Typ oder die Eingabedarstellung ist ungültig. | Nächster SchrittPrüfen Sie die zurückgegebenen Validierungsdetails, bevor Sie eine separate Anfrage vorbereiten. |
Antwort | BedingungDie ursprüngliche Anfrage oder ihr Ergebnis ist unbekannt oder muss geprüft werden. | Nächster SchrittBewahren Sie die ursprünglichen Kennungen und Header auf; lesen Sie nur unterstützte Status- oder Bibliothekseinträge. Senden Sie den Erstellungsauftrag nicht erneut. |
Aliasnamen
Modellaliasnamen
Ailoot Ultra viduq2-turbo
Aliasnamen für Methodenpfade
/v1/videos/generations
Zugehörige Aufrufer-IDs
FAQ · viduq2-turbo
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/videos·viduq2-turbo:text,image→video- Welche Felder verwendet die Anfrage?
POST /v1/videos·viduq2-turbo:model,aspect_ratio,duration,end_image,image,prompt,resolution