Medienleitfäden
Video-Generierung
Erstellen Sie Videos aus Text, Bildern, Audio oder vorhandenen Clips
Die Video-Generierung erfolgt asynchron. POST /v1/videos/generations gibt eine Task-ID und normalerweise eine poll_url zurück. Fragen Sie GET /v1/tasks/{id} mit dieser ID ab, bis das fertige Video bereit ist.
Senden Sie öffentliche HTTP(S)-URLs oder unterstützte Daten-URLs in den Bildfeldern, die von Ihrem ausgewählten Modell akzeptiert werden. Diese Eingaben folgen dem normalen Medienpfad und erstellen nicht automatisch wiederverwendbare Material-IDs.
Wenn ein explizites Material noch vorbereitet wird, gibt POST /v1/videos/generations den Status 409 seedance_material_preparing mit inactive_asset_ids zurück. Fragen Sie diese Assets ab, bis sie den Status ACTIVE erreichen, und versuchen Sie es dann erneut mit denselben Material-IDs. Wenn ein Asset den Status FAILED aufweist, überprüfen Sie die error_message und korrigieren oder importieren Sie es erneut, bevor Sie es erneut versuchen.
Wählen Sie eine API
Verwenden Sie /v1/videos/generations für eine neue Video-Integration. Bestehende Seedance 2.0-Clients, die bereits Volcengine content[]- oder Action-Anfragen senden, können dieses Format über /api/v3 beibehalten. Beide APIs verwenden einen TokenLab Bearer-Key, aber ihre Felder und Statuswerte unterscheiden sich.
Wählen Sie aus, was erstellt werden soll
Setzen Sie operation explizit, damit die API die richtigen Felder für den Auftrag validieren kann.
| Operation | Erforderliche oder typische Eingabe | Anwendungsfall |
|---|---|---|
text-to-video | prompt | Generierung nur aus Text |
image-to-video | image_url oder kompatibles image | Animieren eines Startbildes |
reference-to-video | reference_images und optional video_urls / audio_urls bei unterstützten Modellen | Beibehalten von Identität, Stil oder Asset-Referenzen |
start-end-to-video | start_image, end_image | Steuerung des ersten und letzten Frames |
video-to-video | video_url oder modellspezifische task_id | Transformieren oder Hochskalieren eines vorhandenen Clips |
motion-control | image_url plus video_url | Anwenden einer Bewegungsreferenz auf ein Subjekt |
audio-to-video | audio_url | Audio-gesteuerte Video-Flows |
video-extension | task_id, extend_at oder modellspezifische Erweiterungsfelder | Fortsetzen eines generierten Videos |
Wählen Sie ein Modell
curl "https://api.tokenlab.sh/v1/models?recommended_for=video" \
-H "Authorization: Bearer sk-your-api-key"Verwenden Sie eine von TokenLab zurückgegebene Modell-ID und wählen Sie dann den Generierungstyp mit operation und den entsprechenden Medieneingaben. Verwenden Sie keinen Operationsnamen als Modell-ID.
Lesen Sie die Details zum ausgewählten Modell, bevor Sie sich auf spezialisierte Felder wie reference_images, kling_elements, output_audio, duration, resolution oder aspect_ratio verlassen.
Erstellen Sie ein Video
curl https://api.tokenlab.sh/v1/videos/generations \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "veo3.1",
"operation": "text-to-video",
"prompt": "A calm cinematic shot of a cat walking through a sunlit garden",
"resolution": "720p",
"duration": 4,
"aspect_ratio": "16:9"
}'Verwenden Sie https-URLs für Medien, die aus dem Internet abgerufen werden können. Temporäre URLs müssen gültig bleiben, bis TokenLab den Task erstellt hat.
Modellspezifische Felder
Das Audioverhalten hängt vom ausgewählten Modell und dem Vorgang ab. Ein Video kann Ton enthalten, auch wenn kein Audio-Selektor verfügbar ist. Das Weglassen eines Selektors ist etwas anderes als das Senden von false.
veo3.1,veo3.1-fastundveo3.1-litegenerieren immer Audio. Lassen Sieoutput_audioweg oder senden Sietrue;falsewird abgelehnt.wan-2.6undwan-2.7enthalten immer Audio. Lassen Sieoutput_audioweg oder senden Sietrue.wan-3.0undwan-3.0-primeenthalten ebenfalls immer Audio und akzeptieren keinen Audio-Selektor.hailuo-h3generiert natives Audio und verfügt über keinen Stummschalter. Senden Sie keinen Audio-Selektor, der nicht in den Modelldetails aufgeführt ist.viduq3-proundviduq3-turbogenerieren standardmäßig Audio; senden Sieoutput_audio: false(oderaudio: false) für eine stumme Ausgabe. Seedance- und PixVerse-Modelle akzeptierenoutput_audio; senden Sie diesen Parameter explizit, anstatt sich auf den Standardwert zu verlassen. Verwenden Sie ihn nur für Vorgänge, bei denen er aufgeführt ist.audio_url/audio_urlsstellen Eingabe- oder Referenz-Audio bereit. Sie sind keine Schalter für die Audioausgabe. Videobearbeitung, Motion Transfer und Style Transfer können die Eingabe-Tonspur beibehalten; das Bewahren des Quell-Audios bedeutet nicht, dass es stummgeschaltet wird.
Überprüfen Sie die Modelldetails auf zulässige Werte und audioabhängige Preise. Wenn ein Modell diese auflistet, müssen die Aliase outputAudio, generate_audio und der boolesche Wert audio bei gleichzeitiger Verwendung mit output_audio übereinstimmen. Gehen Sie nicht davon aus, dass jede Version oder jeder Vorgang innerhalb einer Modellfamilie dieselben Audiosteuerungen verwendet.
- Lesen Sie für die Seedance 2.0-Familie den Seedance 2.0 Video-Modelle-Leitfaden, bevor Sie 4K-Ausgabe, Fast/Mini-Auflösungsbegrenzungen oder multimodale Referenzeingaben verwenden.
- Senden Sie für
grok-imagine-video(Video-zu-Video) einenpromptund eine öffentliche HTTPS.mp4video_url. Eine TokenLab.mp4-Ergebnis-URL aus einem früheren Task funktioniert ebenfalls. Diese Operation verwendet keineduration-,resolution- oderaspect_ratio-Selektoren.
PixVerse und HappyHorse
| Modell | Operationen | Eingaben | Auflösung | Dauer | Audio-Auswahl |
|---|---|---|---|---|---|
pixverse-c1, pixverse-v6 | text-to-video, image-to-video, start-end-to-video, reference-to-video | prompt; image_url; start_image + end_image; reference_images | 360p, 540p, 720p, 1080p | Beliebige Ganzzahl von 1 bis 15 Sekunden | output_audio, Standard false |
pixverse-v5.6 | text-to-video, image-to-video, start-end-to-video, reference-to-video | Gleiche Felder wie C1 und V6 | 360p, 540p, 720p, 1080p | 5, 8 oder 10 Sekunden; 1080p unterstützt 5 oder 8 Sekunden | output_audio, Standard false |
happyhorse-1.0 | text-to-video, image-to-video, reference-to-video, video-to-video | prompt; image_url; reference_images; video_url + reference_images | 720p, 1080p | 3 bis 15 Sekunden für Generierungsvorgänge; video-to-video-Ausgabe ist auf 15 Sekunden begrenzt | Senden Sie output_audio nicht |
Auf TokenLab akzeptieren die obigen PixVerse-Modelle operation=video-extension nicht.
curl https://api.tokenlab.sh/v1/videos/generations \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "pixverse-v6",
"operation": "image-to-video",
"prompt": "A slow camera move through a neon-lit street",
"image_url": "https://example.com/start.jpg",
"resolution": "1080p",
"duration": 5,
"output_audio": true
}'Abrufen des fertigen Videos
Rufen Sie GET /v1/tasks/{id} mit der id oder task_id aus der Antwort der Erstellung auf, bis der Task completed oder failed ist.
Abgeschlossene Video-Tasks können je nach Modell und Anzahl der Ausgaben video_url, video oder videos zurückgeben. Behandeln Sie billing_transaction_id als Abrechnungsidentifikator, nicht als Task-Identifikator.
Video-Ergebnis-URLs sind TokenLab-Medien-Ergebnis-URLs, die auf den Dateityp enden, wie z. B. .mp4, und 30 Tage lang gültig bleiben. media_retention.items meldet den Speicherstatus jedes Elements und das expires_at-Datum; die Antwort kann media_retention weglassen, wenn der Speicherstatus nicht rechtzeitig bekannt ist, die URL funktioniert dennoch. Fehlgeschlagene und laufende Tasks geben leere Video-URL-Felder zurück. Asynchrone Task-Snapshots haben einen separaten Lebenszyklus. Siehe Datenaufbewahrung.
Häufige Fehlerquellen
- Verwenden Sie in neuem Code keine modalitätsspezifischen Statuspfade wie
/v1/videos/generations/{id}; fragen Sie stattdessenGET /v1/tasks/{id}ab. - Kombinieren Sie keine Felder für den ersten Frame mit dedizierten Referenzbild-Flows, es sei denn, die Modelldetails erlauben dies.
- Gehen Sie nicht davon aus, dass
durationdie Länge des Eingabe-Referenzvideos beschreibt; sie steuert normalerweise die Länge der generierten Ausgabe. - Senden Sie einen
Idempotency-KeymitPOST /v1/videos/generations. Senden Sie nach einem Timeout dieselbe Anfrage mit demselben Key, um den ursprünglichen Task zu erhalten. Prüfen Sie ohne Key, ob bereits ein Task erstellt wurde, bevor Sie es erneut versuchen.
API-Referenz
| Thema | Referenz |
|---|---|
| Video erstellen | Video erstellen |
| Videostatus abrufen | Videostatus abrufen |
| Taskstatus abrufen | Taskstatus abrufen |
| Task abbrechen | Task abbrechen |
| Abrechnung & Preise | Abrechnung & Preise |
Hailuo H3-Max generiert 5–15-sekündige Videos in 480p oder 768p aus Text, einem ersten Frame oder einem ersten und letzten Frame. Sein auf Geschwindigkeit ausgerichteter Workflow ist nützlich, um schnell eine Aufnahmeidee in einen kurzen Clip zu verwandeln.
{
"model": "hailuo-h3-max",
"operation": "text-to-video",
"prompt": "A slow camera move through a quiet garden",
"resolution": "768p",
"duration": 5,
"aspect_ratio": "16:9"
}