Verwenden Sie vidu-2.0-reference mit model und prompt unter /v1/videos. Die Anfrage stellt image als String oder Array mit bis zu zehn Strings, end_image, aspect_ratio, duration und resolution bereit. Wählen Sie vier oder acht Sekunden, 360p, 720p oder 1080p sowie die Formate 16:9, 1:1 oder 9:16.
Beschreiben Sie eine neue Einstellung, die von den gewählten Motivreferenzen geführt wird. Benennen Sie bei bereitgestellten Bildern die Rolle jeder Referenz und die zu bewahrenden Motivdetails. Geben Sie Handlung und Kameraführung als getrennte Anweisungen vor und definieren Sie anschließend Endpose oder Bildausschnitt. Bewahren Sie gewählte Bilder, Prompt und optionales Endbild mit der Anfrage auf, damit sich das fertige Video mit demselben Material vergleichen lässt.
Übermitteln Sie die Einstellung einmal über /v1/videos 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 alle fertigen Videoausgaben und die vollständige Antwort. Prüfen Sie die gesamte Handlung und die endgültige Komposition anhand des bereitgestellten Materials und des Briefings.
", "aboutText": "Verwenden Sie vidu-2.0-reference mit model und prompt unter /v1/videos. Die Anfrage stellt image als String oder Array mit bis zu zehn Strings, end_image, aspect_ratio, duration und resolution bereit. Wählen Sie vier oder acht Sekunden, 360p, 720p oder 1080p sowie die Formate 16:9, 1:1 oder 9:16.\n\nBeschreiben Sie eine neue Einstellung, die von den gewählten Motivreferenzen geführt wird. Benennen Sie bei bereitgestellten Bildern die Rolle jeder Referenz und die zu bewahrenden Motivdetails. Geben Sie Handlung und Kameraführung als getrennte Anweisungen vor und definieren Sie anschließend Endpose oder Bildausschnitt. Bewahren Sie gewählte Bilder, Prompt und optionales Endbild mit der Anfrage auf, damit sich das fertige Video mit demselben Material vergleichen lässt.\n\nÜbermitteln Sie die Einstellung einmal über /v1/videos 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 alle fertigen Videoausgaben und die vollständige Antwort. Prüfen Sie die gesamte Handlung und die endgültige Komposition anhand des bereitgestellten Materials und des Briefings.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "cbb898d303c984e9c1b85e03f8bf180f0b8e0bc0765610ccea0e1e0b7f4cb5eb", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de", "methods": [ { "html": "vidu-2.0-referenceVidu 2.0 Reference verbindet ein schriftliches Videobriefing mit optionalen Bildreferenzen und einem Endbild. Wählen Sie über Ailoot Bildausschnitt, Auflösung und eine Dauer von vier oder acht Sekunden.
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.
Verwenden Sie vidu-2.0-reference mit model und prompt unter /v1/videos. Die Anfrage stellt image als String oder Array mit bis zu zehn Strings, end_image, aspect_ratio, duration und resolution bereit. Wählen Sie vier oder acht Sekunden, 360p, 720p oder 1080p sowie die Formate 16:9, 1:1 oder 9:16.
Beschreiben Sie eine neue Einstellung, die von den gewählten Motivreferenzen geführt wird. Benennen Sie bei bereitgestellten Bildern die Rolle jeder Referenz und die zu bewahrenden Motivdetails. Geben Sie Handlung und Kameraführung als getrennte Anweisungen vor und definieren Sie anschließend Endpose oder Bildausschnitt. Bewahren Sie gewählte Bilder, Prompt und optionales Endbild mit der Anfrage auf, damit sich das fertige Video mit demselben Material vergleichen lässt.
Übermitteln Sie die Einstellung einmal über /v1/videos 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 alle fertigen Videoausgaben und die vollständige Antwort. Prüfen Sie die gesamte Handlung und die endgültige Komposition anhand des bereitgestellten Materials und des Briefings.
POST /v1/videostext, imagevideo| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits vidu-2.0-reference Bedingungen: Verwenden Sie genau diesen Ailoot-Routingselektor. | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 16:9, 1:1, 9:16 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 4, 8 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 360p, 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— |
| 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}
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.
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Abrechnungsmenge | Gebühr |
|---|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungsmenge— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| KonfigurationPro Anfrage | Tarifstaffel— | Prognostizierte Menge— | Abrechnungsmengeeine Anfrage | Gebühr Eingabe · Schätzung nur zum Vergleich $0.8 pro Anfrage |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungsmenge— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.8 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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\n: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "vidu-2.0-reference", "prompt": "A cat is walking on grass.", "image": "YOUR_ACCESSIBLE_IMAGE_URL"}')\np['image']=os.environ['AILOOT_IMAGE_URL']\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_STATUS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("result.json").read_text())\nu=urljoin("https://api.ailoot.ai",r["polling_url"])\np=urlsplit(u)\nif p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:\n raise SystemExit("Unexpected returned polling URL; preserve the response")\nsubprocess.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)\n# Read this same original polling_url again while pending.\n# Preserve unknown/result_pending_check; do not repeat creation.\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("status.json").read_text())\nroles={}\ndef visit(v,path=""):\n if isinstance(v,dict):\n for k,x in v.items(): visit(x,path+"/"+k)\n elif isinstance(v,list):\n for i,x in enumerate(v): visit(x,path+"/"+str(i))\n elif isinstance(v,str):\n u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)\n 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"):\n roles.setdefault(u,[]).append(path)\nvisit(r)\nif not roles: raise SystemExit("No completed owned assets; retain the original status")\nmanifest=[]\nfor i,(u,paths) in enumerate(roles.items()):\n target=Path(f"asset-{i}.bin")\n subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)\n raw=target.read_bytes()\n if not raw: raise SystemExit("Empty asset; retain original status and metadata")\n 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"\n name=f"asset-{i}.{ext}"\n if target.name!=name: target.rename(name)\n manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})\nPath("asset-manifest.json").write_text(json.dumps(manifest,indent=2))\nprint("Saved",len(manifest),"unique owned assets; every response role retained")\nPY_ASSETS\nGET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}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, ursprüngliche Kennungen, jede tatsächliche Ausgabe sowie alle Verbrauchs- und Abrechnungsfelder auf. Speichern Sie jedes eindeutige, Ihnen zugeordnete Asset und bewahren Sie jede darauf verweisende Rolle auf.
Bewahren Sie die zurückgegebene öffentliche Aufgaben- oder Vorgangs-ID und sämtliche Header auf. Lesen Sie ausschließlich die ursprüngliche Aufgabe aus; unknown oder result_pending_check berechtigt nicht zu einer weiteren Erstellung.
| Feld | Typ |
|---|---|
Feldid | Typstring |
Feldpolling_url | Typstring |
Feldprovider_task_id | Typstring |
Feldtask_id | Typstring |
Feldstatus | Typstring |
Feldvideo_url | Typstring |
| 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. |
Ailoot Ultra vidu-2.0-reference
/v1/videos/generations