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.

OperationErforderliche oder typische EingabeAnwendungsfall
text-to-videopromptGenerierung nur aus Text
image-to-videoimage_url oder kompatibles imageAnimieren eines Startbildes
reference-to-videoreference_images und optional video_urls / audio_urls bei unterstützten ModellenBeibehalten von Identität, Stil oder Asset-Referenzen
start-end-to-videostart_image, end_imageSteuerung des ersten und letzten Frames
video-to-videovideo_url oder modellspezifische task_idTransformieren oder Hochskalieren eines vorhandenen Clips
motion-controlimage_url plus video_urlAnwenden einer Bewegungsreferenz auf ein Subjekt
audio-to-videoaudio_urlAudio-gesteuerte Video-Flows
video-extensiontask_id, extend_at oder modellspezifische ErweiterungsfelderFortsetzen 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-fast und veo3.1-lite generieren immer Audio. Lassen Sie output_audio weg oder senden Sie true; false wird abgelehnt.
  • wan-2.6 und wan-2.7 enthalten immer Audio. Lassen Sie output_audio weg oder senden Sie true. wan-3.0 und wan-3.0-prime enthalten ebenfalls immer Audio und akzeptieren keinen Audio-Selektor.
  • hailuo-h3 generiert natives Audio und verfügt über keinen Stummschalter. Senden Sie keinen Audio-Selektor, der nicht in den Modelldetails aufgeführt ist.
  • viduq3-pro und viduq3-turbo generieren standardmäßig Audio; senden Sie output_audio: false (oder audio: false) für eine stumme Ausgabe. Seedance- und PixVerse-Modelle akzeptieren output_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_urls stellen 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) einen prompt und eine öffentliche HTTPS .mp4 video_url. Eine TokenLab .mp4-Ergebnis-URL aus einem früheren Task funktioniert ebenfalls. Diese Operation verwendet keine duration-, resolution- oder aspect_ratio-Selektoren.

PixVerse und HappyHorse

ModellOperationenEingabenAuflösungDauerAudio-Auswahl
pixverse-c1, pixverse-v6text-to-video, image-to-video, start-end-to-video, reference-to-videoprompt; image_url; start_image + end_image; reference_images360p, 540p, 720p, 1080pBeliebige Ganzzahl von 1 bis 15 Sekundenoutput_audio, Standard false
pixverse-v5.6text-to-video, image-to-video, start-end-to-video, reference-to-videoGleiche Felder wie C1 und V6360p, 540p, 720p, 1080p5, 8 oder 10 Sekunden; 1080p unterstützt 5 oder 8 Sekundenoutput_audio, Standard false
happyhorse-1.0text-to-video, image-to-video, reference-to-video, video-to-videoprompt; image_url; reference_images; video_url + reference_images720p, 1080p3 bis 15 Sekunden für Generierungsvorgänge; video-to-video-Ausgabe ist auf 15 Sekunden begrenztSenden 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 stattdessen GET /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 duration die Länge des Eingabe-Referenzvideos beschreibt; sie steuert normalerweise die Länge der generierten Ausgabe.
  • Senden Sie einen Idempotency-Key mit POST /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

ThemaReferenz
Video erstellenVideo erstellen
Videostatus abrufenVideostatus abrufen
Taskstatus abrufenTaskstatus abrufen
Task abbrechenTask abbrechen
Abrechnung & PreiseAbrechnung & 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"
}

Auf dieser Seite