Video & Materialien
Video erstellen
Starten Sie eine Video-Generierungsaufgabe
Ü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-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.
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
veo3.1ID 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, Standardfalse
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_audionicht
Textbeschreibung des Videos, bis zu 10.000 Zeichen. Die meisten Operationen erfordern eine Angabe; die Modelldetails geben an, welche keine benötigen.
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.
Ö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.
Inline-Bild als Daten-URL (zum Beispiel data:image/jpeg;base64,...). Wird nur von einigen Modellen akzeptiert; image_url funktioniert bei mehreren.
Bild-URLs für Modelle, die dieses Feld auflisten. Siehe reference_images für die Anzahlbeschränkungen.
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-fastundseedance-2.0-mini: bis zu 9 Bildreferenzen insgesamt, einschließlich Material-Assets. Mehr gibt400 too_many_seedance_reference_imageszurück.seedance-2.5: bis zu 30 Bildeingaben insgesamt überimage_urlsundreference_imageshinweg.grok-imagine-video: bis zu 7, unddurationist auf 10 Sekunden begrenzt.grok-imagine-video-1.5undgrok-imagine-video-1.5-previewakzeptieren keine Referenzbilder.- Andere Modelle: siehe die Modelldetails. Eine Anfrage über dem Limit gibt
400 too_many_itemszurü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.
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.
Bild für den letzten Frame für start-end-to-video. Akzeptiert dieselben Eingaben wie start_image.
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.
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.
Ö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.
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.
Ö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.
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.
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.
Sekunde des Quellvideos, an der eine video-extension beginnt. Erforderlich bei grok-imagine-video.
Sekunden, die bei einer video-extension hinzugefügt werden sollen, bei Modellen, die dieses Feld auflisten. grok-imagine-video akzeptiert 6 oder 10.
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.
Kompatibilitätsalias für duration. Wenn beide gesendet werden, müssen sie identisch sein.
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.
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.
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.
Containerformat, mp4 oder mov, für Modelle, die dieses Feld auflisten, wie etwa seedance-2.5. Für Modelle weglassen, die es nicht auflisten.
Gibt den zuletzt generierten Frame zusätzlich als last_frame_url zurück. Nur Seedance-Modelle.
Wasserzeichen-Umschalter für Modelle, die dieses Feld auflisten (Seedance-Modelle).
Was im generierten Video vermieden werden soll, bis zu 5.000 Zeichen, für Modelle, die dieses Feld auflisten.
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.
Bilder pro Sekunde (1–120), für Modelle, die dieses Feld auflisten.
Frame-Anzahl, für Modelle, die dieses Feld auflisten. Seedance-Modelle akzeptieren dies nicht.
Sekunden, die die Aufgabe in der Warteschlange verbleiben darf, bevor sie abläuft (3600 bis 259200), für Seedance-Modelle.
Aufgabenpriorität von 0 bis 9, für Seedance-Modelle. Nicht mit service_tier=flex kombinieren.
default wird als Kompatibilitäts-No-Op auf Seedance 2.0- und 2.5-Modellen akzeptiert. flex wird bei diesen Modellen abgelehnt.
Endbenutzer-Sicherheitskennung (bis zu 128 Zeichen) für Seedance-Modelle. Falls weggelassen, verwendet TokenLab user, sofern angegeben.
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"}.
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_audioundreference_images. - Aus Kompatibilitätsgründen akzeptiert TokenLab auch
ratio,generate_audio,outputAudio,secondsundreferenceImages. - Wenn ein primäres Feld und sein Alias beide gesendet werden, müssen ihre Werte übereinstimmen. Eine Nichtübereinstimmung gibt
400mitconflicting_audio_selector,conflicting_durationoderconflicting_aspect_ratiozurü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-Modelle | seedance-2.5 | |
|---|---|---|
| Auflösung | seedance-2.0: 480p, 720p, 1080p, 4k. seedance-2.0-fast und seedance-2.0-mini: 480p, 720p | 480p, 720p |
| Dauer | -1, 4 bis 15 Sekunden | -1, 4 bis 30 Sekunden |
| Seitenverhältnis | 1:1, 3:4, 4:3, 9:16, 16:9, 21:9, adaptive | Dasselbe für Text-to-Video und Reference-to-Video. Image-to-Video, Start-End, Videobearbeitung und Erweiterung erfordern adaptive; Videobearbeitung erfordert zudem duration=-1 |
| Ausgabeformat | mp4 | mp4 oder mov |
seed | Akzeptiert | Nicht akzeptiert |
| Referenzeingaben | 9 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 -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.
Aufgaben-ID. Identisch mit task_id.
Aufgaben-ID zum Abfragen mit GET /v1/tasks/{id}.
Status-URL für diese Aufgabe, /v1/tasks/{id}. Rufen Sie sie mit Ihrem API-Key auf.
Aufgabenstatus: pending, processing, completed, failed. Eine neue Aufgabe ist normalerweise pending.
Unix-Zeitstempel der Aufgabenerstellung.
Verwendetes Modell.
ID der Abrechnungstransaktion, wenn die Abrechnung bereits abgeschlossen ist. Sie ist unabhängig von der Aufgaben-ID.
Video-URL, nur vorhanden, wenn die Erstellungsantwort das Ergebnis bereits enthält. Normalerweise lesen Sie diese aus der Statusantwort aus.
Fehlermeldung oder strukturiertes Fehlerobjekt, wenn die Aufgabe fehlschlägt.
Fehler
| Status und Code | Bedeutung |
|---|---|
400 invalid_request | Ein 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_long | Die 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_parameter | Eine Eingabe passt nicht zur Operation, beispielsweise ein mit text-to-video gesendetes Bild. |
400 conflicting_audio_selector, conflicting_duration, conflicting_aspect_ratio | Ein Alias und sein primäres Feld stimmen nicht überein. |
400 unpriceable_selection | Fü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_model | Zu viele Bildreferenzen für ein Seedance 2.0-Modell oder ein Material wurde an ein anderes Modell gesendet. |
402 | Unzureichendes Guthaben. |
403 task_not_owned | Die task_id gehört zu einem anderen Workspace. |
409 seedance_material_preparing, seedance_material_route_unavailable | Ein Material ist noch nicht ACTIVE oder das ausgewählte Modell kann die bereitgestellten Materialien nicht verwenden. |
429 | Ratenbegrenzung ü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
{
"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 API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Ort: header
Header
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"
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.
1 <= length <= 255Anfragekörper
application/json
Antwort
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json