Videoerstellung

Die Videoerstellung ist asynchron. POST /v1/videos/generations gibt eine öffentliche Aufgabenidentität und normalerweise eine poll_url zurück; das endgültige Video erscheint in späteren Statusantworten.

Übergeben Sie öffentliche HTTP(S)-URLs oder unterstützte data-URLs in den Bildfeldern des gewählten Modells. Sie werden als normale Medieneingaben verarbeitet und erzeugen nicht automatisch wiederverwendbare Material-IDs.

Ist ein ausdrücklich angegebenes Material noch in Vorbereitung, liefert POST /v1/videos/generations den Fehler 409 seedance_material_preparing mit inactive_asset_ids. Fragen Sie diese Assets bis ACTIVE ab und wiederholen Sie die Anfrage mit denselben IDs. Bei FAILED prüfen Sie zunächst error_message und korrigieren oder importieren das Asset erneut.

Unterstützte OperationenCopy Anchor Link

Verwenden Sie explizite operation in der Produktion. TokenLab kann einige Operationen aus den Eingaben ableiten, aber explizite Betriebswerte machen Validierung, Unterstützung und Wiederholungen klarer.

ModellerkennungCopy Anchor Link

curl "https://api.tokenlab.sh/v1/models?recommended_for=video" \
  -H "Authorization: Bearer sk-your-api-key"

Verwenden Sie in model die von TokenLab angezeigten Modell-IDs und wählen Sie Funktionsvarianten mit operation und den passenden Medieneingaben. Beispiele sind wan-2.7, happyhorse-1.0, viduq3, viduq3-mix, pixverse-v6, veo3.1 und seedance-2.0; verwenden Sie keine operationsspezifischen Suffixe als TokenLab-Modellnamen.

Lesen Sie die Details des ausgewählten Modells, bevor Sie sich auf spezialisierte Felder wie reference_images, kling_elements, output_audio, duration, resolution oder aspect_ratio verlassen.

Anfrage erstellenCopy Anchor Link

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": "Eine ruhige filmische Aufnahme einer Katze, die durch einen sonnigen Garten läuft",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'

Für Produktionsmedieneingaben bevorzugen Sie öffentliche https URLs gegenüber Inline-data: URLs. Wenn Sie temporäre URLs verwenden, halten Sie diese gültig, bis TokenLab die Aufgabe erstellt hat.

Eingaben und modell-spezifische FelderCopy Anchor Link

Das Audioverhalten hängt vom Modell und Vorgang ab. Videos können Ton enthalten, auch wenn kein Audioschalter angeboten wird. Weglassen ist nicht dasselbe wie false.

• veo3.1 und veo3.1-fast erzeugen gemäß Gemini API immer Audio. Auch die Videogenerierung mit wan-2.6 und wan-2.7 bietet keine Stummschaltung. Lassen Sie output_audio weg oder setzen Sie es auf true, soweit die Modelldetails dies erlauben.
• hailuo-h3 und Grok-Videomodelle erzeugen natives Audio. Senden Sie keine Audioschalter, die nicht in den Modelldetails stehen.
• Seedance 1.5/2.x und viduq3-pro / viduq3-turbo aktivieren Audio standardmäßig und unterstützen stumme Ausgabe. PixVerse C1/V5.6/V6 deaktivieren Audio standardmäßig. Verwenden Sie output_audio nur bei Vorgängen, die es aufführen. Vidu akzeptiert auch das deklarierte boolesche Feld audio.
• audio_url / audio_urls liefern Eingabe- oder Referenzaudio und schalten die Audioausgabe nicht um. Videobearbeitung, Bewegungsübertragung und Stiltransfer können die ursprüngliche Tonspur behalten. Originalton beibehalten bedeutet nicht stummschalten.

Zulässige Werte und Audiopreise stehen in den Modelldetails. Unterstützte Aliase outputAudio, generate_audio und boolesches audio müssen bei gemeinsamer Angabe mit output_audio übereinstimmen. Versionen und Vorgänge derselben Modellfamilie können unterschiedliche Audiosteuerungen haben.

• Lesen Sie für die Seedance 2.0 Familie den Leitfaden zu Seedance 2.0 Videomodellen, bevor Sie 4K-Ausgabe, Fast/Mini-Auflösungsgrenzen oder multimodale Referenzeingaben verwenden.
• Für video-to-video mit grok-imagine-video senden Sie prompt und eine öffentliche HTTPS-URL einer .mp4-Datei als video_url. Diese Operation verwendet keine Auswahl über duration, resolution oder aspect_ratio.

PixVerse und HappyHorseCopy Anchor Link

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
  }'

Ergebnisse abfragenCopy Anchor Link

Verwenden Sie zuerst die zurückgegebene poll_url. Wenn Sie einen festen Endpunkt benötigen, verwenden Sie GET /v1/tasks/{id} mit derselben id / task_id aus der Erstellungsantwort.

Abgeschlossene Videoaufgaben können je nach Modell und Ausgabemenge video_url, video oder videos zurückgeben. Behandeln Sie billing_transaction_id als Abrechnungsidentifikator, nicht als Aufgabenidentifikator.

Häufige FallstrickeCopy Anchor Link

• Kodieren Sie keine alten Video-Statuspfade; bevorzugen Sie poll_url.
• Kombinieren Sie keine ersten Frame-Felder mit speziellen Referenzbildabläufen, es sei denn, der Modelldetails erlaubt dies.
• Gehen Sie nicht davon aus, dass duration die Länge des Eingangsreferenzvideos beschreibt; es steuert normalerweise die Länge des generierten Outputs.
• Wiederholen Sie keine Erstellungsanfragen nach einem Timeout, ohne zu überprüfen, ob bereits eine Aufgabe erstellt wurde.

API-ReferenzCopy Anchor Link

OpenAI-Style und Volc-kompatible Video-APIsCopy Anchor Link

Verwenden Sie /v1/videos/generations für die einheitliche TokenLab Video-API über mehrere Modelle hinweg. Wenn Sie eine bestehende Seedance-2.0-Integration migrieren, die bereits Volc-ähnliche content[]- oder Action-Anfragen nutzt, verwenden Sie die Seedance-Kompatibilitätsendpunkte unter /api/v3. Beide Varianten verwenden TokenLab Bearer API Keys und asynchrones Polling, aber Anfrage- und Antwortformate unterscheiden sich.

{
  "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"
}