Zum Hauptinhalt springen
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. Wenn das ausgewählte Seedance-Modell die TokenLab-Materialbibliothek verwenden kann, werden Bild-URLs und unterstützte Inline-data-URLs vor der Generierung als wiederverwendbare TokenLab-Materialien vorbereitet. Dauert die Vorbereitung länger als 60 Sekunden, versuchen Sie es erneut, sobald die zurückgegebenen auto_material_asset_ids ACTIVE sind. Kann das ausgewählte Modell die Materialbibliothek nicht verwenden, laufen normale Bildeingaben über den regulären Bildpfad.

​
Unterstützte Operationen

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.
OperationErforderliche oder typische EingabeAnwendungsfall
text-to-videopromptNur aus Text generieren
image-to-videoimage_url oder kompatibles imageEin Startbild animieren
reference-to-videoreference_images und optionale video_urls / audio_urls bei unterstützten ModellenIdentität, Stil oder Asset-Referenzen beibehalten
start-end-to-videostart_image, end_imageErste und letzte Frames steuern
video-to-videovideo_url oder modell-spezifische task_idEinen bestehenden Clip transformieren oder hochskalieren
motion-controlimage_url plus video_urlBewegungsreferenz auf ein Subjekt anwenden
audio-to-videoaudio_urlAudio-konditionierte Videoabläufe
video-extensiontask_id, extend_at oder modell-spezifische ErweiterungsfelderEin generiertes Video fortsetzen

​
Modellerkennung

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, kling-3.0-video, 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 erstellen

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 Felder

  • Anfragen der Veo 3 Familie sind standardmäßig auf Audio-an, wenn output_audio weggelassen wird. Setzen Sie es explizit, wenn das Modell den Schalter unterstützt und Ihre UX von Ton abhängt.
  • kling_elements ist für kling-3.0-video bildkonditionierte Anfragen. Referenzieren Sie jedes Element im prompt als @name; kombinieren Sie es nicht mit output_audio=true.
  • 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 grok-imagine-video verwendet video-to-video eine öffentliche .mp4 video_url; modell-spezifische Einschränkungen wie duration und resolution müssen aus dem Modelldetails stammen.

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

​
Ergebnisse abfragen

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 Fallstricke

  • 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-Referenz

ThemaReferenz
Video erstellenVideo erstellen
Video-Status abrufenVideo-Status abrufen
Aufgabenstatus abrufenAufgabenstatus abrufen
Aufgabe abbrechenAufgabe abbrechen
Abrechnung & PreisgestaltungAbrechnung & Preisgestaltung

​
OpenAI-Style und Volc-kompatible Video-APIs

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.