Video & Materialien

Video erstellen

Starten Sie eine Video-Generierungsaufgabe

POST
/v1/videos/generations

Übersicht

Die Video-Generierung erfolgt asynchron. Eine erfolgreiche Erstellungsanfrage gibt eine Task-id (derselbe Wert wie task_id) und eine poll_url zurück. Rufen Sie GET /v1/tasks/{id} mit dieser ID auf, bis der status completed oder failed lautet, und lesen Sie dann video_url aus. Siehe Videostatus abrufen.

  • Die Ergebnisdatei wird 30 Tage lang gespeichert. Laden Sie sie herunter, falls Sie sie länger benötigen; siehe Datenaufbewahrung.
  • Eine in der Warteschlange befindliche Seedance-Aufgabe kann mit Aufgabe abbrechen abgebrochen werden.
  • Kosten können reserviert werden, wenn die Aufgabe angenommen wird, und werden abgerechnet, sobald die Aufgabe abgeschlossen ist oder fehlschlägt. Siehe Abrechnung & Preise.
  • Senden Sie einen Idempotency-Key-Header, um eine Erstellungsanfrage nach einem Timeout sicher zu wiederholen.

Jedes Modell akzeptiert eigene Operationen und Felder. GET /v1/models/{model} (Modell abrufen) listet für jede Operation die akzeptierten Felder, Auflösungen, Dauern und Seitenverhältnisse auf. Ein Feld oder Wert außerhalb dieser Liste gibt 400 mit den akzeptierten Werten zurück. Setzen Sie duration, resolution, aspect_ratio und output_audio selbst: Wenn Sie eines davon weglassen, verwendet TokenLab den Standardwert des Modells für die Operation. Falls kein Standardwert zutrifft, gibt die Anfrage 400 zurück und benennt das zu setzende Feld.

Audio- und Medieneingabe

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.

Verwenden Sie öffentlich erreichbare https-URLs für Bilder, Videos und Audio, und halten Sie diese gültig, bis die Aufgabe beginnt. Eine Medien-URL kann bis zu 8.192 Zeichen lang sein. Einige Modelle akzeptieren auch Inline-data:-Bild-URLs (bis zu 2.000.000 Zeichen pro Feld); URLs sind für große Dateien zuverlässiger. Mischen Sie keine Inline-Base64- und Remote-URLs in derselben Anfrage.

Request-Body

modelstringStandard: veo3.1

ID des Videomodells. Listen Sie aktuelle Videomodelle mit Modelle auflisten (recommended_for=video) auf und übergeben Sie das Modell anschließend explizit.

PixVerse

  • Modell: pixverse-c1, pixverse-v6, pixverse-v5.6
  • Operationen: text-to-video, image-to-video, start-end-to-video, reference-to-video
  • Audio-Auswahl: output_audio, Standard false

Auf TokenLab akzeptieren die obigen PixVerse-Modelle operation=video-extension nicht.

HappyHorse

  • Modell: happyhorse-1.0
  • Operationen: text-to-video, image-to-video, reference-to-video, video-to-video
  • Audio-Auswahl: Senden Sie output_audio nicht
promptstring

Textbeschreibung des Videos, bis zu 10.000 Zeichen. Die meisten Operationen erfordern eine Angabe; die Modelldetails geben an, welche keine benötigen.

operationstring

Generierungsmodus: text-to-video, image-to-video, reference-to-video, start-end-to-video, video-to-video, video-extension oder motion-control. Jedes Modell unterstützt nur einige davon; die anderen geben 400 unsupported_operation zurück. Wenn Sie diesen Parameter weglassen, leitet TokenLab ihn aus den Eingaben ab: eine task_id mit extend_at oder extend_times ergibt video-extension, Referenzbilder oder Materialien ergeben reference-to-video, end_image ergibt start-end-to-video, eine Videoeingabe ergibt video-to-video, eine Bildeingabe (image, image_url, image_urls oder start_image) ergibt image-to-video und andernfalls text-to-video. Senden Sie den Parameter explizit, damit ein nicht übereinstimmendes Feld frühzeitig einen Fehler auslöst.

image_urlstring

Öffentlich zugängliche URL des Bildes für den ersten Frame. Seedance 2.0-Modelle akzeptieren auch asset://asset-YYYYMMDDHHMMSS-xxxxx, um ein ACTIVE TokenLab-Material als ersten Frame zu verwenden. Bevorzugen Sie eine https-URL für die breiteste Modellunterstützung.

imagestring

Inline-Bild als Daten-URL (zum Beispiel data:image/jpeg;base64,...). Wird nur von einigen Modellen akzeptiert; image_url funktioniert bei mehreren.

image_urlsarray

Bild-URLs für Modelle, die dieses Feld auflisten. Siehe reference_images für die Anzahlbeschränkungen.

reference_imagesarray

Referenzbilder für reference-to-video als https-URLs oder Daten-URLs. Das Anzahllimit hängt vom Modell ab:

  • seedance-2.0, seedance-2.0-fast und seedance-2.0-mini: bis zu 9 Bildreferenzen insgesamt, einschließlich Material-Assets. Mehr gibt 400 too_many_seedance_reference_images zurück.
  • seedance-2.5: bis zu 30 Bildeingaben insgesamt über image_urls und reference_images hinweg.
  • grok-imagine-video: bis zu 7, und duration ist auf 10 Sekunden begrenzt. grok-imagine-video-1.5 und grok-imagine-video-1.5-preview akzeptieren keine Referenzbilder.
  • Andere Modelle: siehe die Modelldetails. Eine Anfrage über dem Limit gibt 400 too_many_items zurück.

Seedance 2.0-Modelle akzeptieren auch asset://asset-YYYYMMDDHHMMSS-xxxxx für ein ACTIVE TokenLab-Material. Informationen zur Modellauswahl, zu 4K-Grenzen und Hinweisen zu Mini finden Sie im Leitfaden zu Seedance 2.0-Videomodellen. Kombinieren Sie bei grok-imagine-video Referenzbilder nicht mit image_url oder image.

start_imagestring

Bild für den ersten Frame. In Kombination mit end_image ist die Anfrage start-end-to-video. Ohne end_image handelt es sich um image-to-video, wobei start_image wie image bei Modellen funktioniert, deren Vertrag dies vorsieht. Akzeptiert eine öffentliche URL oder eine Daten-URL; Seedance 2.0-Modelle akzeptieren zudem asset://asset-YYYYMMDDHHMMSS-xxxxx.

end_imagestring

Bild für den letzten Frame für start-end-to-video. Akzeptiert dieselben Eingaben wie start_image.

material_asset_idstring

TokenLab Seedance-Material-Asset-ID, die von Material-Asset erstellen zurückgegeben wird. Wird nur von den Seedance 2.0-Modellen akzeptiert; andere Modelle geben 400 unsupported_seedance_material_asset_model zurück. Das Asset muss ACTIVE sein und zu Ihrem Konto gehören. Dieses Feld ist eine generische Referenzeingabe; um explizit die Bedeutung als erster Frame, letzter Frame oder Referenzbild zuzuweisen, tragen Sie stattdessen asset://<material_asset_id> in start_image, end_image oder reference_images ein.

material_asset_idsarray

Bis zu 9 TokenLab Seedance-Material-Asset-IDs. Sie zählen zu den 9 Bildreferenzen der Seedance 2.0-Modelle.

Gewöhnliche Bild-URLs werden als Bildeingaben übergeben; sie erstellen keine wiederverwendbaren Material-Assets. Erstellen Sie wiederverwendbare Assets über die Material-API und verwenden Sie anschließend deren TokenLab-IDs oder asset://asset-YYYYMMDDHHMMSS-xxxxx-URIs. Wenn ein explizites Material 409 seedance_material_preparing zurückgibt, prüfen Sie die zurückgegebenen inactive_asset_ids und versuchen Sie es erneut, nachdem diese Materialien den Status ACTIVE erhalten haben.

video_urlstring

Öffentlich zugängliche URL des Quellvideos für Operationen, die eines erfordern: video-to-video, video-extension und motion-control, bei Modellen, die dieses Feld auflisten.

video_urlsarray

Quell- oder Referenzvideos für Modelle, die dieses Feld auflisten. seedance-2.5 akzeptiert bis zu 10 Videoeingaben insgesamt über video_url und video_urls hinweg. Siehe die Modelldetails für andere Modelle.

audio_urlstring

Öffentliche Audio-URL für eine Audioreferenz oder eine audiogesteuerte Operation bei Modellen, die dieses Feld auflisten. Es handelt sich um eine Eingabe, nicht um einen Schalter für die Audioausgabe.

audio_urlsarray

Referenzaudio für Modelle, die dieses Feld auflisten. seedance-2.5 akzeptiert bis zu 10 Audioeingaben insgesamt über audio_url und audio_urls hinweg und erlaubt eine Anfrage mit Audioreferenzen ohne Prompt. Bei seedance-2.5 dürfen Referenzaudio und Referenzvideo zusammen maximal 30 Sekunden dauern.

task_idstring

ID einer früheren Aufgabe in Ihrem Workspace für video-extension bei Modellen, die dieses Feld auflisten. Eine Aufgabe, die nicht zu Ihrem Workspace gehört, gibt 403 task_not_owned zurück.

extend_atinteger

Sekunde des Quellvideos, an der eine video-extension beginnt. Erforderlich bei grok-imagine-video.

extend_timesstring

Sekunden, die bei einer video-extension hinzugefügt werden sollen, bei Modellen, die dieses Feld auflisten. grok-imagine-video akzeptiert 6 oder 10.

durationinteger

Ausgabedauer in Sekunden. Die zulässigen Werte hängen vom Modell und der Operation ab; andere Werte geben 400 invalid_duration zurück. Seedance-Modelle akzeptieren auch -1, damit das Modell die Dauer innerhalb seines Bereichs wählt; die Abrechnung wird dann bis zum Abschluss der Aufgabe konservativ geschätzt. Einige Operationen erfordern keine Dauer, wie beispielsweise motion-control und grok-imagine-video Video-to-Video.

secondsinteger

Kompatibilitätsalias für duration. Wenn beide gesendet werden, müssen sie identisch sein.

aspect_ratiostring

Seitenverhältnis, zum Beispiel 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 oder adaptive (Seedance). Die zulässigen Werte hängen vom Modell und der Operation ab; andere Werte geben 400 invalid_aspect_ratio zurück.

resolutionstring

Ausgabeauflösung, zum Beispiel 480p, 720p, 1080p oder 4k. Die zulässigen Werte hängen vom Modell und der Operation ab, und einige Modelle verwenden auch 360p, 540p oder 768p. Andere Werte geben 400 invalid_resolution zurück.

output_audioboolean

Auswahl für die Audioausgabe bei Operationen, die dies auflisten. Ein Weglassen folgt dem Modellstandard; false fordert eine stumme Ausgabe nur dort an, wo das Modell dies zulässt. Siehe die Audiohinweise oben und die ausgewählten Modelldetails.

output_formatstring

Containerformat, mp4 oder mov, für Modelle, die dieses Feld auflisten, wie etwa seedance-2.5. Für Modelle weglassen, die es nicht auflisten.

return_last_frameboolean

Gibt den zuletzt generierten Frame zusätzlich als last_frame_url zurück. Nur Seedance-Modelle.

watermarkboolean

Wasserzeichen-Umschalter für Modelle, die dieses Feld auflisten (Seedance-Modelle).

negative_promptstring

Was im generierten Video vermieden werden soll, bis zu 5.000 Zeichen, für Modelle, die dieses Feld auflisten.

seedinteger

Seed für reproduzierbare Generierung, für Modelle, die dieses Feld auflisten. Seedance 2.0-Modelle akzeptieren -1 für einen zufälligen Seed; seedance-2.5 akzeptiert dieses Feld nicht.

fpsinteger

Bilder pro Sekunde (1–120), für Modelle, die dieses Feld auflisten.

framesinteger

Frame-Anzahl, für Modelle, die dieses Feld auflisten. Seedance-Modelle akzeptieren dies nicht.

execution_expires_afterinteger

Sekunden, die die Aufgabe in der Warteschlange verbleiben darf, bevor sie abläuft (3600 bis 259200), für Seedance-Modelle.

priorityinteger

Aufgabenpriorität von 0 bis 9, für Seedance-Modelle. Nicht mit service_tier=flex kombinieren.

service_tierstring

default wird als Kompatibilitäts-No-Op auf Seedance 2.0- und 2.5-Modellen akzeptiert. flex wird bei diesen Modellen abgelehnt.

safety_identifierstring

Endbenutzer-Sicherheitskennung (bis zu 128 Zeichen) für Seedance-Modelle. Falls weggelassen, verwendet TokenLab user, sofern angegeben.

toolsarray

Tools, die das Modell während der Generierung verwenden darf, für Seedance 2.0- und 2.5-Modelle. Das unterstützte Tool ist {"type": "web_search"}.

userstring

Eine eindeutige Kennung für den Endbenutzer. Bei Seedance-Modellen verwendet TokenLab diesen Wert auch als safety_identifier, wenn dieses Feld weggelassen wird.

Kompatible Feldnamen

  • Primäre Felder verwenden snake_case: aspect_ratio, output_audio und reference_images.
  • Aus Kompatibilitätsgründen akzeptiert TokenLab auch ratio, generate_audio, outputAudio, seconds und referenceImages.
  • Wenn ein primäres Feld und sein Alias beide gesendet werden, müssen ihre Werte übereinstimmen. Eine Nichtübereinstimmung gibt 400 mit conflicting_audio_selector, conflicting_duration oder conflicting_aspect_ratio zurück.

Seedance-Parameter

Seedance-Modelle (seedance-2.0, seedance-2.0-fast, seedance-2.0-mini und seedance-2.5) akzeptieren die oben genannten TokenLab-Feldnamen sowie die Aliase seconds, ratio und generate_audio. Die Versionen unterscheiden sich:

Seedance 2.0-Modelleseedance-2.5
Auflösungseedance-2.0: 480p, 720p, 1080p, 4k. seedance-2.0-fast und seedance-2.0-mini: 480p, 720p480p, 720p
Dauer-1, 4 bis 15 Sekunden-1, 4 bis 30 Sekunden
Seitenverhältnis1:1, 3:4, 4:3, 9:16, 16:9, 21:9, adaptiveDasselbe für Text-to-Video und Reference-to-Video. Image-to-Video, Start-End, Videobearbeitung und Erweiterung erfordern adaptive; Videobearbeitung erfordert zudem duration=-1
Ausgabeformatmp4mp4 oder mov
seedAkzeptiertNicht akzeptiert
Referenzeingaben9 Bildreferenzen einschließlich Materialien (Materialien werden nur bei diesen Modellen akzeptiert)30 Bilder, 10 Videos und 10 Audiodateien insgesamt

Die Modelldetails sind die aktuelle Quelle für diese Werte. Senden Sie duration, resolution, aspect_ratio und output_audio explizit, anstatt sich auf einen Standardwert zu verlassen; der recommended_request des Modells zeigt eine typische Anfrage.

duration=-1 oder seconds=-1 lässt Seedance die Ausgabedauer innerhalb des Modellbereichs wählen. TokenLab schätzt die Kosten vor Abschluss der Aufgabe konservativ und rechnet sie anschließend anhand der tatsächlichen Nutzung der abgeschlossenen Aufgabe ab, sobald diese verfügbar ist. service_tier=flex und frames werden bei diesen Modellen abgelehnt.

Seedance-Beispiel

cURL
curl -X POST "https://api.tokenlab.sh/v1/videos/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A sleek product reveal with cinematic camera movement",
    "operation": "text-to-video",
    "duration": -1,
    "aspect_ratio": "adaptive",
    "resolution": "720p",
    "output_audio": true
  }'

Antwort

Felder, die Ergebnisse, Fehler, Zeitstempel und das Modell beschreiben, werden zurückgegeben, sobald sie für die Aufgabe verfügbar sind.

idstring

Aufgaben-ID. Identisch mit task_id.

task_idstring

Aufgaben-ID zum Abfragen mit GET /v1/tasks/{id}.

poll_urlstring

Status-URL für diese Aufgabe, /v1/tasks/{id}. Rufen Sie sie mit Ihrem API-Key auf.

statusstring

Aufgabenstatus: pending, processing, completed, failed. Eine neue Aufgabe ist normalerweise pending.

createdinteger

Unix-Zeitstempel der Aufgabenerstellung.

modelstring

Verwendetes Modell.

billing_transaction_idstring

ID der Abrechnungstransaktion, wenn die Abrechnung bereits abgeschlossen ist. Sie ist unabhängig von der Aufgaben-ID.

video_urlstring

Video-URL, nur vorhanden, wenn die Erstellungsantwort das Ergebnis bereits enthält. Normalerweise lesen Sie diese aus der Statusantwort aus.

errorstring | object

Fehlermeldung oder strukturiertes Fehlerobjekt, wenn die Aufgabe fehlschlägt.

Fehler

Status und CodeBedeutung
400 invalid_requestEin Feld ist fehlerhaft, liegt außerhalb des gültigen Bereichs oder fehlt. error.param benennt es. Eine Meldung wie "Set aspect_ratio explicitly" bedeutet, dass das weggelassene Feld für diese Anfrage keinen Standardwert hat.
400 unsupported_operation, unsupported_parameter, invalid_resolution, invalid_duration, invalid_aspect_ratio, invalid_parameter_value, too_many_items, prompt_too_longDie Anfrage stimmt nicht mit den vom Modell für die Operation akzeptierten Werten überein. Der Fehler listet in der Regel die akzeptierten Werte auf.
400 invalid_parameterEine Eingabe passt nicht zur Operation, beispielsweise ein mit text-to-video gesendetes Bild.
400 conflicting_audio_selector, conflicting_duration, conflicting_aspect_ratioEin Alias und sein primäres Feld stimmen nicht überein.
400 unpriceable_selectionFür die ausgewählte Kombination ist kein Preis hinterlegt. Ändern Sie resolution, duration, aspect_ratio oder die Audioeinstellung.
400 too_many_seedance_reference_images, unsupported_seedance_material_asset_modelZu viele Bildreferenzen für ein Seedance 2.0-Modell oder ein Material wurde an ein anderes Modell gesendet.
402Unzureichendes Guthaben.
403 task_not_ownedDie task_id gehört zu einem anderen Workspace.
409 seedance_material_preparing, seedance_material_route_unavailableEin Material ist noch nicht ACTIVE oder das ausgewählte Modell kann die bereitgestellten Materialien nicht verwenden.
429Ratenbegrenzung überschritten. Siehe Ratenbegrenzungen.

Anfrage

curl -X POST "https://api.tokenlab.sh/v1/videos/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo3.1",
    "prompt": "A cat walking through a garden, cinematic lighting",
    "operation": "text-to-video",
    "duration": 4,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Antwort

Response
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "model": "veo3.1",
  "created": 1706000000
}

Bild zu Video

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "hailuo-2.3",
        "prompt": "The scene begins from the provided image and adds gentle natural motion.",
        "operation": "image-to-video",
        "image_url": "https://example.com/image.jpg",
        "duration": 6,
        "resolution": "768p"
    }
)

Referenz zu Video

Verwenden Sie operation=reference-to-video, wenn das Modell eine dedizierte Referenzkonditionierung unterstützt. Bildreferenzen werden in reference_images übergeben; Modelle, die Referenzvideos und -audio akzeptieren, verwenden video_urls und audio_urls. duration legt ausschließlich die Länge der generierten Ausgabe fest. Es begrenzt nicht die Länge des eingegebenen Referenzvideos. Siehe reference_images oben für die Anzahlbeschränkungen pro Modell.

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "veo3.1",
        "prompt": "Keep the same subject identity, palette, and framing while adding subtle natural motion.",
        "operation": "reference-to-video",
        "reference_images": [
            "https://example.com/ref-a.jpg",
            "https://example.com/ref-b.jpg"
        ],
        "duration": 8,
        "resolution": "720p",
        "aspect_ratio": "9:16"
    }
)

Keyframe-Steuerung

Verwenden Sie start_image und end_image, um das erste und letzte Frame zu steuern:

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "viduq2-pro",
        "operation": "start-end-to-video",
        "start_image": "https://example.com/day.jpg",
        "end_image": "https://example.com/night.jpg",
        "duration": 5,
        "resolution": "720p"
    }
)

Video zu Video

Verwenden Sie operation=video-to-video, wenn das Modell ein bestehendes Video als primäre Eingabe akzeptiert. Senden Sie für grok-imagine-video eine öffentliche HTTPS-.mp4-URL in video_url und den Bearbeitungs-prompt, und lassen Sie resolution, duration und aspect_ratio weg.

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "grok-imagine-video",
        "operation": "video-to-video",
        "video_url": "https://example.com/source.mp4",
        "prompt": "Enhance the clip while preserving the original motion."
    }
)

Video-Erweiterung

Verwenden Sie operation=video-extension, um ein früheres Ergebnis fortzusetzen. Senden Sie die task_id einer Aufgabe aus Ihrem Workspace und einen prompt; die übrigen Felder hängen vom Modell ab. grok-imagine-video benötigt zusätzlich extend_at und akzeptiert für extend_times den Wert 6 oder 10. veo3.1 und veo3.1-fast akzeptieren task_id und prompt. Seedance-Modelle listen video_url, video_urls und task_id für diese Operation auf.

Bewegungssteuerung

Verwenden Sie operation=motion-control, wenn das Modell sowohl ein Subjektbild als auch ein Bewegungsreferenzvideo erwartet. Senden Sie image_url und video_url; resolution ist erforderlich.

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "kling-3.0-motion-control",
        "operation": "motion-control",
        "prompt": "Keep the subject identity stable while following the motion reference.",
        "image_url": "https://example.com/subject.png",
        "video_url": "https://example.com/motion.mp4",
        "resolution": "720p"
    }
)

Modellsuche

Das öffentliche Videoinventar und die unterstützten Operationen ändern sich im Laufe der Zeit. Nutzen Sie die Modelle-API, um die aktuelle Unterstützung zu prüfen, bevor Sie einen modellspezifischen Ablauf anbinden:

curl "https://api.tokenlab.sh/v1/models?recommended_for=video"

curl "https://api.tokenlab.sh/v1/models/veo3.1"

Lesen Sie die Modelldetail-Antwort, bevor Sie sich auf modellspezifische Operationen oder Felder verlassen. Operationen wie video-extension und motion-control sind modellspezifisch; bestätigen Sie die aktuelle Verfügbarkeit dort, anstatt sich auf statische Beispiele auf dieser Seite zu verlassen.

Autorisierung

BearerAuth
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Header

X-TokenLab-Delivery-Policy?string

Zustellungsrichtlinie pro Anfrage. Überschreibt die API-Key- und Workspace-Standardeinstellungen. Versucht automatisch zuerst TokenLab Verified und kann vor der Ausgabe, der Annahme der Anfrage oder der Erstellung persistenter Ressourcen einmalig auf Official umstellen.

Zulässige Werte

  • "auto"
  • "verified"
  • "official"
Idempotency-Key?string

Optionaler Schlüssel, der eine Erstellungsanfrage sicher für Wiederholungsversuche macht. Senden Sie für jede Aufgabe einen neuen eindeutigen Wert, wie z. B. eine UUID. Ein Wiederholungsversuch mit demselben Schlüssel und demselben Body gibt das Ergebnis der ursprünglichen Erstellungsanfrage zurück, in der Regel die ursprüngliche Aufgabe, und erstellt, versendet oder berechnet keine zweite Aufgabe. Ein abweichender Body mit einem bereits akzeptierten Schlüssel wird mit 409 abgelehnt. Ein Schlüssel mit mehr als 255 Zeichen wird ignoriert, und die Anfrage verfügt dann über keinen Idempotenz-Schutz. Siehe Sichere Wiederholungsversuche mit einem Idempotenz-Schlüssel.

Länge1 <= length <= 255

Anfragekörper

application/json

Antwort

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json