Zum Hauptinhalt springen
POST
Senden Sie POST /v1/videos/generations, lesen Sie data[0].task_id und fragen Sie anschließend GET /v1/tasks/{task_id} ab.
string
erforderlich
Verwenden Sie Authorization: Bearer <token>. <token> ist Ihr APIMart-API-Schlüssel.

Anfrageparameter

string
erforderlich
Verwenden Sie seedance-2-5-flash. Auch doubao-seedance-2-5-flash wird akzeptiert. Der Name mit Punkt seedance-2.5-flash wird nicht unterstützt.
boolean
Standard:"false"
Legt fest, ob der Inhalt vor dem Absenden des Videoauftrags moderiert wird.
  • true: Prompts und Eingabebilder mit omni-moderation-latest prüfen
  • false oder nicht angegeben: keine Moderationsanfrage und damit keine zusätzlichen Moderationskosten oder Verzögerung (Standard)
Ein Treffer liefert HTTP 400 (nsfw_content_detected), ohne Aufgabe oder Generierungskosten. Referenzvideos und Audio werden nicht geprüft. Bei Ausfall der Moderation kann die Anfrage fortgesetzt werden.
string
erforderlich
Erforderlicher Prompt. Referenzieren Sie Medien mit @图片1 / @视频1 / @音频1. Die Indizes beginnen bei 1 und folgen der Reihenfolge im jeweiligen Medienarray.
string
Standard:"720p"
Nur 480p / 720p; Standard: 720p. Werte wie 1080p, 2k oder 4k führen beim Senden zu HTTP 400.
string
Standard:"adaptive"
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive (Standard). Alias: aspect_ratio. Start-/Endbild-, Bearbeitungs- und Verlängerungsaufgaben erfordern adaptive.
integer
Ganze Sekunden 4–30; normale Anfragen verwenden ohne Angabe 5. -1 bedeutet automatisch. Explizites edit erlaubt nur -1 oder keine Angabe; Letzteres wird zu -1, die Dauer folgt dem Quellvideo. Automatische Dauer reserviert 30 Sekunden und wird nach tatsächlichen Tokens abgerechnet.
boolean
Standard:"true"
Ton erzeugen, standardmäßig true. Alias: audio. Steuert den Ausgabeton unabhängig von den Eingabereferenzen audio_urls.
boolean
Standard:"false"
KI-Wasserzeichen hinzufügen; Standard false.
integer
Optionaler Zufallsseed. Derselbe Seed garantiert kein identisches Ergebnis.
string
Standard:"mp4"
Ausgabecontainer: mp4 (Standard) oder mov.
string
Standard:"auto"
auto (Standard), reference, edit oder extend, nur mit Referenzmedien. Explizite Typen aktivieren die unten beschriebenen Prüfungen beim Senden.
string[]
Referenzbilder, alle als reference_image behandelt. Zusammen mit image_with_roles maximal 10 Bilder. Für Start- und Endbilder verwenden Sie image_with_roles.
object[]
Jedes Element enthält url und role. Rollen: reference_image, first_frame (maximal 1), last_frame (maximal 1, mit Startbild). Zusammen mit image_urls maximal 10 Bilder; vermeiden Sie widersprüchliche Rollen. Bei video_urls / audio_urls werden Start-/Endbilder als multimodale Referenzbilder behandelt.
string[]
Maximal 5 Referenzvideos, jeweils 2–30 Sekunden, insgesamt höchstens 30 Sekunden. Quellvideos zur Bearbeitung müssen 4–30 Sekunden lang sein.
string[]
Maximal 5 Audioreferenzen, jeweils 2–30 Sekunden, insgesamt höchstens 30 Sekunden. Reine Audioreferenzen ohne Bild oder Video werden unterstützt.
boolean
Standard:"false"
Mit true wird nach Erfolg ein Endbild unter data.result.videos[].last_frame_url zurückgegeben.
Dem Modell bei Bedarf Websuche erlauben; Standard false.
object[]
Optionale Werkzeuge, z. B. [{"type":"web_search"}] für Websuche.
draft / draft_task_id werden nicht unterstützt. Entfernen Sie diese Felder, sonst wird beim Senden HTTP 400 zurückgegeben. Für Entwürfe verwenden Sie Seedance 2.5.

Medienanforderungen

Verwenden Sie öffentlich erreichbare http(s)-URLs oder freigegebene asset://-IDs. Ausgabeauflösung und Pixelgrenzen der Eingabevideos werden getrennt geprüft.

Aufgabentypen und Einschränkungen

Verletzungen expliziter Typgrenzen führen vor Aufgabenerstellung und Abrechnung zu HTTP 400. Bei auto bestimmt das Modell den Typ anhand von Medien und Prompt; Einschränkungen können daher erst während der Generierung zum Fehler führen. Auch ein expliziter Typ kann bei widersprüchlichem Prompt mit InvalidParameter.TaskTypeMismatch scheitern.

Anfragebeispiele

Multimodale Referenz

Start- und Endbilder

Videobearbeitung

Videoverlängerung

Private Medien

Bilder oder Videos mit echten Gesichtern müssen zuerst in der Medienbibliothek freigegeben werden; danach verwenden Sie asset://. Setzen Sie auch beim Upload model auf seedance-2-5-flash. Siehe Medienbibliothek-API; verwenden Sie den Flash-Namen im folgenden Beispiel.
Fragen Sie die Medienprüfung über die einheitliche Aufgaben-API ab. Nach Freigabe erhalten Sie die asset://-ID aus der Medienliste und verwenden sie in image_urls, image_with_roles[].url, video_urls oder audio_urls.

Aufgabenstatus und Ergebnisse

Fragen Sie die Status-API ab. pending / processing: läuft; completed: erfolgreich; failed: fehlgeschlagen. Lesen Sie data.result.videos[0].url[0]; url ist ein Array.

Abrechnung

  • Beim Senden wird anhand des Sekundenpreises der Auflösung reserviert. Mit Referenzvideo gilt der Eingabetarif für Ausgabedauer plus gesamte Referenzvideodauer.
  • Normale Anfragen ohne duration reservieren 5 Ausgabesekunden. duration: -1 oder edit ohne Dauer reserviert 30 Ausgabesekunden.
  • Nach Erfolg: data.usage.completion_tokens ÷ 1,000,000 × passender Preis je Million Tokens, mit Kontorabatten. Die Differenz wird erstattet oder nachberechnet. Je nach Referenzvideo gilt token oder token-input; der endgültige Betrag steht in data.cost.
  • Abgewiesene Anfragen verursachen keine Generierungskosten. Bei Generierungsfehlern wird die Reservierung erstattet. Preise und Rabatte siehe Preisseite.

Häufige Fehler