Verwenden Sie doubao-seedance-2-5-flash mit POST /ai/v1/videos, rufen Sie den Status des Tasks ab und laden Sie anschließend das Ergebnis herunter. Das aktuelle AIHubMix-Schema unterstützt Ausgaben in 480p/720p, Clips mit einer Länge von 4–30 Sekunden sowie bis zu 10 Bild-, 5 Video- und 5 Audioreferenzen. Ältere Clients, die /v1/videos verwenden, müssen sowohl den Endpunkt als auch die Modell-ID ändern.
Dieser Leitfaden wurde am 16. November 2026 überprüft. Sowohl die oben angegebene Kurz-ID als auch doubao-seedance-2-5-flash-261115 lieferten ein Modellschema und lehnten eine Anfrage mit 1080p mit 400 schema_violation ab. Ein separater Erstellungsversuch für einen 4 Sekunden langen Clip in 480p ergab 402 insufficient_quota; es wurde kein Video generiert. Der folgende Ablauf entspricht dem aktuellen Schema und der Dokumentation. Eine erfolgreiche Generierung, die Latenz, MOV-Ausgabe und Bearbeitung wurden bei dieser Überprüfung jedoch nicht durchgängig getestet.
Voraussetzungen und Ermittlung des Schemas
Auf der Seedance 2.5 Flash-Modellseite ist das Modell unter der in diesem Leitfaden durchgehend verwendeten Kurz-ID aufgeführt. Bevor Sie einen Task einreichen:
- Aktivieren Sie asynchrone Medientasks in der AIHubMix-Konsole. Der dokumentierte Fehler für Konten, bei denen diese Funktion nicht aktiviert ist, lautet
403 async_not_enabled. - Vergewissern Sie sich, dass der API-Schlüssel Zugriff hat und das Konto über ausreichend Guthaben verfügt. Bei der Live-Prüfung trat
402 insufficient_quotamit der MeldungYour account has insufficient quota. Add credits and try again.auf. - Exportieren Sie
AIHUBMIX_API_KEYin Ihrer Shell. Hinterlegen Sie den Schlüssel weder in Quelldateien noch im Browsercode. - Rufen Sie das aktuelle Schema ab. Für die Anfrage zur Schemaermittlung ist keine Authentifizierung erforderlich.
curl --fail-with-body -sS \
'https://aihubmix.com/call/schema/models/doubao-seedance-2-5-flash/endpoints' \
| jq '.endpoints[] | select(.path == "/ai/v1/videos") | .request.schema'
Das Schema vom 16. November führt für Flash nur /ai/v1/videos auf. Als Werte für resolution werden 480p und 720p akzeptiert (Standardwert 720p). Für duration ist eine Ganzzahl von 4 bis 30 oder -1 für eine vom Modell gewählte Dauer zulässig. Geben Sie eine explizite Dauer an, wenn Sie ein vorhersehbares Budget benötigen.
Erstellen, Status abfragen und herunterladen
Die AIHubMix-API zur Videogenerierung trennt Erstellung, Statusabfragen und Downloads voneinander. Eine erfolgreiche HTTP-Antwort bei der Erstellung bedeutet, dass ein Task angenommen wurde; nur status: "completed" bestätigt den Abschluss. Eine Abfrage kann HTTP 200 zurückgeben, obwohl der Task selbst den Status status: "failed" hat.
Einen Text-zu-Video-Task einreichen
Dieses Beispiel fordert einen 10 Sekunden langen Produktclip in 720p und 16:9 mit Audio an. Es verwendet ausschließlich Text und ist daher nicht von extern gehosteten Referenzbildern abhängig.
curl --fail-with-body -sS -X POST https://aihubmix.com/ai/v1/videos \
-H "Authorization: Bearer $AIHUBMIX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "doubao-seedance-2-5-flash",
"prompt": "A matte ceramic espresso cup sits on wet slate as warm morning light sweeps across rising steam. The camera slowly dollies in. Quiet cafe ambience.",
"duration": 10,
"aspect_ratio": "16:9",
"resolution": "720p",
"generate_audio": true
}'
Speichern Sie die zurückgegebene Task-id sofort. Fragen Sie alle 15 Sekunden mit GET /ai/v1/videos/{id} den Status ab, bis er completed, failed oder cancelled lautet. Verwenden Sie für die laufende Statusabfrage die Videodetailroute: Sie aktualisiert den Anbieterstatus; die einheitliche Taskliste ersetzt diese Abfrage nicht. Laden Sie das Video nach Abschluss mit GET /ai/v1/videos/{id}/content herunter und verwenden Sie dabei denselben Bearer-Header.
Ein vollständiger Python-Client
Installieren Sie die Abhängigkeit mit python3 -m pip install requests, speichern Sie den folgenden Code als seedance_flash.py und führen Sie dann in der Shell, in der Ihr API-Schlüssel verfügbar ist, python3 seedance_flash.py aus. Dieses Beispiel implementiert den dokumentierten Ablauf; wegen des oben genannten Kontingentfehlers konnte die Generierung nicht vollständig getestet werden.
import os
import time
from pathlib import Path
import requests
BASE_URL = "https://aihubmix.com"
HEADERS = {
"Authorization": f"Bearer {os.environ['AIHUBMIX_API_KEY']}",
"Content-Type": "application/json",
}
PAYLOAD = {
"model": "doubao-seedance-2-5-flash",
"prompt": "A matte ceramic espresso cup sits on wet slate as warm morning light sweeps across rising steam. The camera slowly dollies in. Quiet cafe ambience.",
"duration": 10,
"aspect_ratio": "16:9",
"resolution": "720p",
"generate_audio": True,
}
# Submit once. A network timeout does not prove that creation failed.
response = requests.post(
f"{BASE_URL}/ai/v1/videos", headers=HEADERS, json=PAYLOAD, timeout=60
)
response.raise_for_status()
task = response.json()
task_id = task["id"]
print(f"Task ID: {task_id}", flush=True)
deadline = time.monotonic() + 20 * 60
while task["status"] not in {"completed", "failed", "cancelled"}:
if time.monotonic() >= deadline:
raise TimeoutError(f"Still waiting for {task_id}; query it again, do not recreate it.")
time.sleep(15)
response = requests.get(
f"{BASE_URL}/ai/v1/videos/{task_id}", headers=HEADERS, timeout=30
)
response.raise_for_status()
task = response.json()
if task["status"] != "completed":
raise RuntimeError(f"Task {task_id}: {task.get('error') or task['status']}")
response = requests.get(
f"{BASE_URL}/ai/v1/videos/{task_id}/content", headers=HEADERS, timeout=120
)
response.raise_for_status()
Path("seedance_flash_10s.mp4").write_bytes(response.content)
print("Saved seedance_flash_10s.mp4")
Die Frist von 20 Minuten ist ein clientseitiges Wartezeitlimit, keine serverseitige Stornierung und keine Garantie für die Generierungsdauer. Schlägt die Statusabfrage oder der Download fehl, behalten Sie die Task-ID und wiederholen Sie den betreffenden Vorgang. Senden Sie nach einer Zeitüberschreitung oder bei unklarem Anbieterstatus nicht automatisch eine weitere Generierungsanfrage.
Zu den offiziellen Online-Inferenzpreisen von BytePlus kostet Flash bei 480p/720p 7.00 $ pro Million Token ohne Videoeingabe beziehungsweise 4.30 $ mit Videoeingabe. Für das reine Textbeispiel ergibt sich die Schätzung 10 × 1280 × 720 × 24 / 1024 = 216,000 Token: 1.51 $ mit Flash gegenüber 2.31 $ mit dem Flaggschiffmodell 2.5 in 720p. Dies sind berechnete Schätzungen für BytePlus, keine gemessenen Kosten bei AIHubMix.
Referenzen und Webhooks
Um einen Clip mit Medien zu steuern, fügen Sie Einträge in input_references hinzu. Jeder Eintrag enthält einen type (image_url, video_url oder audio_url) und eine url, die auf zugängliche Medien verweist. Das Schema begrenzt die Anzahl dieser Typen auf 10 / 5 / 5. Für die Steuerung des ersten und letzten Frames verwenden Sie stattdessen frame_images; jeder Eintrag enthält ein frame_type sowie ein verschachteltes image_url.url. Füllen Sie nicht gleichzeitig frame_images und input_references aus. Frame-Workflows erfordern aspect_ratio: "adaptive", und für einen letzten Frame muss auch ein erster Frame vorhanden sein.
Die Dokumentation zu Async Tasks beschreibt HTTPS-Callbacks über webhook_url. Das aktuelle Flash-Schema enthält dieses Feld, lässt aber webhook_events_filter aus und setzt additionalProperties: false. Lassen Sie den Filter daher weg, wenn Sie diesem Modellschema folgen. Standardmäßig werden laut Dokumentation completed, failed und cancelled gesendet. Die Zustellung erfolgt mindestens einmal; es gibt bis zu sechs Versuche mit Wiederholungsintervallen von 1, 4, 16, 64 und 256 Sekunden. Deduplizieren Sie anhand von event_id. Task-Callbacks verfügen über kein separates Signaturgeheimnis. Fragen Sie daher den Task ab, um seinen endgültigen Status zu bestätigen. Für Anwendungen, die eine Signaturprüfung benötigen, beschreibt die Dokumentation Abonnements auf Kontoebene.
Fehler: gemessene Ergebnisse und Angaben aus der Dokumentation
1080p: eine gemessene Ablehnung durch das Schema
Beide AIHubMix-Modell-IDs gaben bei einer 4-Sekunden-Anfrage mit resolution: "1080p" HTTP 400 zurück. Die zurückgegebenen Fehlerfelder lauteten:
{
"error": {
"code": "schema_violation",
"message": "`resolution` must be one of: 480p, 720p, null.",
"type": "invalid_request_error"
}
}
Die Antwort enthielt außerdem eine Request-Trace-ID, die hier weggelassen wurde. Dies ist eine beobachtete Ablehnung durch das Gateway, kein vermuteter Upstream-Fehler. Daraus lassen sich weder eine erfolgreiche Generierung noch eine Geschwindigkeitsmessung ableiten.
Die folgenden weiteren Einschränkungen stammen aus dem aktuellen Flash-Schema; diese ungültigen Kombinationen wurden bei der Live-Prüfung nicht einzeln eingereicht.
| Eingabeproblem | Schemaanforderung | Lösung |
|---|---|---|
| 4K-Ausgabe | 480p oder 720p | Niedrigere Auflösung wählen |
| Zu viele Referenzen | 10 Bilder / 5 Videos / 5 Audio | Anzahl reduzieren |
| Zwei Referenz-Arrays | Ein nicht leeres Array | Einen Workflow auswählen |
| Nur letzter Frame | Erster Frame ebenfalls erforderlich | Beide Frames angeben |
| Festes Seitenverhältnis mit Frames | Adaptives Seitenverhältnis | „adaptive“ verwenden |
Referenzen mit echten Personen: verifizierte Assets verwenden
AIHubMix dokumentiert doubao_real_person_required für den Fall, dass Doubao eine Ablehnung aus Datenschutzgründen für ein Bild einer echten Person ausgibt. Dieser Fehler trat bei dieser Prüfung nicht auf. Die dokumentierte Meldung lautet:
Diese Anfrage verwendet ein Bild einer echten Person. Schließen Sie die Verifizierung für echte Personen ab und verwenden Sie eine aktive Asset-Referenz. Siehe https://docs.aihubmix.com/cn/api/doubao-real-person-assets.
Befolgen Sie den Leitfaden zu Doubao-Assets für echte Personen: Erstellen Sie eine Gruppe unter /ai/v1/asset-groups, legen Sie unter /ai/v1/asset-groups/{id}/verification-sessions eine Verifizierungssitzung an, lassen Sie die abgebildete Person die Webverifizierung abschließen, registrieren Sie das Asset unter /ai/v1/asset-groups/{id}/assets und warten Sie, bis es aktiv ist. Verwenden Sie asset://<ASSET_ID> als Generierungsreferenz. Eine URL zu einem unveränderten Foto ersetzt weder die Einwilligung noch den Asset-Workflow.
Kontingent, Anfragegröße und Downloads
Der gemessene Fehler 402 insufficient_quota verhinderte, dass die Anfrage mit gültiger Auflösung die Generierung erreichte. Laden Sie Guthaben auf, bevor Sie es erneut versuchen. Eine korrekte Anfrage wird durch Änderungen am Prompt oder an der Modell-ID nicht erfolgreich. 403 async_not_enabled ist ein anderer, dokumentierter Fehler aufgrund einer fehlenden Voraussetzung; die Funktion muss in der Konsole aktiviert werden.
AIHubMix dokumentiert ein Limit von 32 MiB für den Anfrage-Body sowie den Fehler 413 request_too_large. Öffentliche URLs vermeiden, dass Base64 die Größe des Anfrage-Bodys erhöht; die referenzierten Medien müssen jedoch weiterhin die Größen- und Formatlimits des Modells erfüllen.
Speichern Sie ein fertiggestelltes Video zeitnah. Im bestehenden Seedance-2.5-Integrationsleitfaden von AIHubMix wird darauf hingewiesen, dass Ausgabe-URLs nur kurz gültig sind, etwa 30 Minuten; eine feste Aufbewahrungsdauer für Flash wurde hier nicht überprüft. Die Video-API kann expires_at: null zurückgeben, was keine unbegrenzte Speicherung garantiert. Zu den dokumentierten Downloadfehlern zählen 410 artifact_expired und 429 too_many_downloads. Wenn beim Download ein vorübergehender Dienstfehler auftritt, wiederholen Sie den Download für den bestehenden Task, statt den Clip erneut zu generieren.
Migrationsfallen, auf die auch eine gültige Anfrage stoßen kann
Der Seedance-2.5-Leitfaden von Volcengine führt Flash ausdrücklich als Teil der Modellfamilie auf und bestätigt MOV-Ausgabe, Bearbeitung und Verlängerung. Diese Funktionen des Anbieters müssen jedoch von den Fähigkeiten unterschieden werden, die über das Gateway verifiziert wurden.
- MOV- und Bearbeitungsfelder sind verfügbar, wurden hier aber nicht durchgängig getestet. Das Flash-Schema akzeptiert
extra.output_format: "mp4"oder"mov"sowie fürextra.omni_reference_task_typedie Werteauto,reference,editundextend. Wenn Sie das Task-Typ-Feld explizit senden, verlangt das Schema nicht leereinput_references. Füreditsind außerdem eine Videoreferenz, ein adaptives Seitenverhältnis undduration: -1erforderlich; fürextendeine Videoreferenz und ein adaptives Seitenverhältnis. - Ein expliziter Task-Typ garantiert nicht, dass das Modell ihn akzeptiert. Ark dokumentiert die asynchronen Fehler
InvalidParameter.TaskTypeConstraint, wenn der ermittelte Task-Typ und die Parameter nicht zusammenpassen, sowieInvalidParameter.TaskTypeMismatch, wenn der ermittelte Typ vom explizit angeforderten abweicht. Die genaue Zuordnung bei AIHubMix wurde nicht gemessen. Prüfen Sie den zurückgegebenen Task-error, anstatt einen bestimmten Gateway-Fehlercode anzunehmen. - Flash unterstützt keine Draft-Promotion. Der Anbieter beschränkt den zweistufigen Workflow von 480p Draft bis zur finalen Version auf das Flaggschiffmodell 2.5. Flash unterstützt ihn nicht, und in den aktuellen AIHubMix-Schemata für beide Modelle fehlen
draftunddraft_task. - Videoeingaben verändern die Abrechnung. Bei der offiziellen Abrechnung werden die Dauer der Eingabe- und Ausgabevideos herangezogen; außerdem kann eine Mindestzahl an Token gelten. Der Preis von 4.30 $/M ist keine Garantie dafür, dass ein videobasierter Task weniger kostet als ein ansonsten identischer, rein textbasierter Task. Prüfen Sie die tatsächliche Nutzung und die Kontenabrechnung, statt sich allein auf die Formel zu verlassen.
- Einige Beschreibungen bleiben mehrdeutig. Das Gateway-Schema von Flash enthält
extra.priority,extra.safety_identifierundextra.tools, doch in den Beschreibungen steht weiterhin „nur für die 2.0-Serie“. In der Referenz zu Ark für das Erstellen von Aufgaben werdenpriorityundtoolsauch für die 2.5-Familie aufgeführt. Die bloße Aufnahme ins Schema bestätigt nicht, dass sie bei AIHubMix wirksam sind. Prüfen Sie die jeweilige Funktion, bevor Sie sich im Produktivbetrieb darauf verlassen.
Checkliste vor dem Start
- Aktivieren Sie asynchrone Aufgaben und prüfen Sie das Guthaben Ihres Kontos.
- Verwenden Sie die kurze Flash-ID mit
/ai/v1/videosund rufen Sie das aktuelle Schema ab. - Wählen Sie 480p oder 720p und eine explizite Dauer zwischen 4 und 30 Sekunden.
- Beschränken Sie Referenzen auf 10 Bilder, 5 Videos und 5 Audioclips.
- Halten Sie Frame-Referenzen getrennt und verwenden Sie für sie das adaptive Seitenverhältnis.
- Leiten Sie Referenzen mit dem Abbild einer realen Person über verifizierte, aktive Assets.
- Speichern Sie die Aufgaben-ID, prüfen Sie den endgültigen Aufgabenstatus und laden Sie das Ergebnis umgehend herunter.
- Wiederholen Sie Abfragen oder Downloads für eine bestehende Aufgabe, wenn der Generierungsstatus unklar ist.
Häufig gestellte Fragen
Kann ich für Flash den OpenAI-kompatiblen Pfad /v1/videos verwenden?
Im aktuellen Flash-Schema ist nur /ai/v1/videos aufgeführt. Verwenden Sie für die Beispiele in diesem Leitfaden diesen nativen asynchronen Pfad.
Warum schlägt eine Anfrage mit Frame-Bild und aspect_ratio: "16:9" fehl?
Flash verlangt im Schema aspect_ratio: "adaptive", wenn nicht leere frame_images angegeben werden. Ein Schluss-Frame erfordert außerdem einen Start-Frame, und Frame-Referenzen lassen sich nicht mit nicht leeren input_references kombinieren.
Wie behebe ich doubao_real_person_required?
Folgen Sie dem Ablauf zur persönlichen Verifizierung und Asset-Registrierung, warten Sie, bis das Asset aktiv ist, und verweisen Sie darauf mit einer Asset-URI. Der Code bezeichnet eine spezifische Datenschutzablehnung von Doubao; bei dieser Prüfung ließ sie sich nicht reproduzieren.
Warum kann ein kurzes Referenzvideo mehr kosten, als die Formel vorhersagt?
Die Abrechnungsregeln des Anbieters können bei Videoeingaben eine Mindestanzahl an Tokens ansetzen. Die Formel liefert nur einen Schätzwert. Prüfen Sie den tatsächlichen Verbrauch und die Abrechnungsdaten des Kontos, um den berechneten Betrag festzustellen.
Werden fehlgeschlagene Generierungen oder Moderationsablehnungen berechnet?
Laut den offiziellen Abrechnungsregeln von BytePlus und Volcengine werden erfolgreiche Generierungen berechnet, fehlgeschlagene Generierungen und Ablehnungen durch die Inhaltsmoderation hingegen nicht. In der Fehlerdokumentation von AIHubMix wird empfohlen, historische Abrechnungsdaten auf frühere Kosten zu prüfen. Hier wurde keine Abrechnung für eine erfolgreiche oder fehlgeschlagene Generierung gemessen.
Wie lange habe ich Zeit, ein Flash-Ergebnis herunterzuladen?
Laden Sie es unmittelbar nach Abschluss herunter. Im vorhandenen Seedance-2.5-Leitfaden wird auf URLs mit einer Gültigkeit von ungefähr 30 Minuten hingewiesen. Die genaue Speicherdauer von Flash wurde jedoch nicht verifiziert, und ein Nullwert im Ablaufzeitfeld bedeutet nicht, dass das Ergebnis dauerhaft verfügbar ist.
Werden MOV-Ausgabe und Bearbeiten/Verlängern über AIHubMix unterstützt?
Das aktuelle Flash-Schema stellt die entsprechenden Felder unter extra bereit, und der Anbieter dokumentiert diese Funktionen. Ihr durchgängiges Verhalten über AIHubMix wurde nicht verifiziert, da der Erstellungstest mit einer Antwort wegen unzureichenden Kontingents endete.
Weiterlesen: die Seedance-2.5-Flash-Reihe
- Sie möchten vor der Modellwahl Preisunterschiede und Kompromisse bei der Auflösung vergleichen? Seedance 2.5 Flash vs. 2.5 und 2.0: Lohnt sich das Upgrade?
Quellen
Dokumentation und Schema geprüft am 16. November 2026; Validierungsantworten um 08:26 UTC erfasst. Die Preise sind offizielle Schätzungen von BytePlus und keine gemessenen Gebühren des Gateways.
- Video Generation API (AIHubMix-Dokumentation)
- Async Tasks API (AIHubMix-Dokumentation)
- Doubao Real-Person Assets Guide (AIHubMix-Dokumentation)
- ModelArk Pricing (BytePlus)
- Seedance 2.5 Tutorial (Volcengine Ark)



