seedance-2.0 API

Verwenden Sie die genaue Modell-ID seedance-2.0. Das Modellfeld muss genau mit dieser Seite übereinstimmen.

Beispielausgabeseedance-2.0POST /v1/videos5.1s

Parameter: duration=5resolution=1080pratio=16:9

Prompt: One continuous take, no cuts. An empty indoor swimming pool at night, tiled walls and underwater lights. A swimmer in a chrome-finish suit stands on the edge and lifts both arms; the water answers by leaving the pool, rising as a single rotating column of turquoise that twists up past the roof beams and holds there, the emptied tiles glowing underneath. The camera starts low at the pool edge, cranes up alongside the column and tilts to look down into the drained basin. One hard cyan key from the underwater lights, warm sodium spill from the high windows. Real weight and inertia, spray and refraction, no text.

Anfrage, die dieses Beispiel erstellt hat

{
  "model": "seedance-2.0",
  "prompt": "One continuous take, no cuts. An empty indoor swimming pool at night, tiled walls and underwater lights. A swimmer in a chrome-finish suit stands on the edge and lifts both arms; the water answers by leaving the pool, rising as a single rotating column of turquoise that twists up past the roof beams and holds there, the emptied tiles glowing underneath. The camera starts low at the pool edge, cranes up alongside the column and tilts to look down into the drained basin. One hard cyan key from the underwater lights, warm sodium spill from the high windows. Real weight and inertia, spray and refraction, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Authentifizierung und Endpunkt

Verwenden Sie einen Modelflare-API-Schlüssel mit https://modelflare.dev/v1. Der Gateway-Einstiegspunkt ist POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Erstellen Sie eine Aufgabe

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "720p",
    "duration": 5,
    "generate_audio": false
  }'

Umfrage und Download

Speichern Sie die Aufgaben-ID. Abfrage GET /v1/videos/{task_id} und Download mit GET /v1/videos/{task_id}/content. Ergebnis-URLs können ablaufen. Übertragen Sie die Datei daher umgehend.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Notizen anfordern

Seedance verwendet content[] für Text, Rahmen und Referenzmedien; Der separate Seedance Asset Management-Vertrag wird unabhängig dokumentiert.

Hinweis

Laden Sie Bilder virtueller Personen zuerst in die Seedance-Asset-Bibliothek hoch. Warten Sie auf den Status Active und verwenden Sie dann asset://<ID> in content[]. Modelflare bietet keine Verifizierung realer Personen an.

Parameter anfordern

Seedance verwendet einen asynchronen multimodalen Umschlag. Text und Medien in content[] einfügen; Medienrollen wählen erste/letzte Frame- oder Referenz-Workflows aus.

Feld	Erforderlich	Notizen
model	Ja	seedance-2.0
content[]	Ja	text, image_url, video_url und audio_url; Verwenden Sie role, um den Medienzweck zu identifizieren
resolution	Nein	480p / 720p / 1080p / 4k (Standard 720p)
ratio	Nein	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	Nein	4–15 Sekunden
generate_audio	Nein	Erzeugen Sie synchronisierte Dialoge, Effekte und Hintergrundaudio
tools	Nein	Verwenden Sie web_search nur dort, wo die offizielle Modellseite dies unterstützt
watermark	Nein	Ob ein Wasserzeichen hinzugefügt werden soll

Eingabe- und Ausgabegrenzen

Dieses Modell unterstützt die Ausgabe in 480p, 720p, 1080p und 4K mit einer Dauer von 4–15 Sekunden. Multimodale Referenzen ermöglichen bis zu neun Bilder, drei Videos und drei Audioclips; Audio kann nicht alleine verwendet werden. Medien mit role-Werten in content[] markieren; Workflows für den ersten Frame, die Bearbeitung, die Erweiterung und die Websuche haben ihre eigenen Einschränkungen. Bilder virtueller Personen müssen zuerst in die Asset-Bibliothek hochgeladen werden; Modelflare bietet keine Verifizierung realer Personen an.

Dokumentierte Workflow-Beispiele

Die Seedance 2.0-Serie unterstützt Text-zu-Video, erste/erste und letzte Frames, multimodale Referenzen, Bearbeitung, Erweiterung und Websuche für Text-zu-Video. Bestellen Sie Medien als Text, Bild, Video und dann als Audio.

Multimodale Referenz

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "content": [
      {"type": "text", "text": "@image1 performs the movement from @video1, paced to @audio1"},
      {"type": "image_url", "image_url": {"url": "https://example.com/character.jpg"}, "role": "reference_image"},
      {"type": "video_url", "video_url": {"url": "https://example.com/motion.mp4"}, "role": "reference_video"},
      {"type": "audio_url", "audio_url": {"url": "https://example.com/music.mp3"}, "role": "reference_audio"}
    ],
    "generate_audio": true, "ratio": "16:9", "duration": 11
  }'

Videobearbeitung und Websuche

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0", "content": [{"type": "text", "text": "Macro shot of cherry blossoms in spring"}],
    "generate_audio": true, "ratio": "16:9", "duration": 11,
    "tools": [{"type": "web_search"}]
  }'

Fehler und fehlgeschlagene Aufgaben

Ungültige Modellparameter geben ein 4xx mit einer Anforderungs-ID zurück. Eine asynchrone Aufgabe kann auch nach erfolgreicher Erstellung als fehlgeschlagen gelten. Verwenden Sie error_code und error_message aus der Umfrageantwort als letzten Aufgabengrund. Wiederholen Sie dieselbe Anfrage nicht mit einer anderen JSON-Form.

Unterstützter Bereich

Auf dieser Seite werden Modelflare-Modellgenerierungs- und -bearbeitungsaufrufe behandelt. Such- oder Kartenanreicherung, Sprachverwaltung und Elementbibliotheksverwaltung sind Ressourcen-APIs außerhalb dieser öffentlichen Modellaufrufoberfläche und keine erforderlichen Anforderungsfelder.

Preise und Abrechnung

Dieses Modell verwendet eine tokenbasierte Abrechnung. Den aktuellen Kundenpreis, den Referenzlistenpreis und die vollständige Spezifikation finden Sie auf der Modellpreisseite.

Hinweis

Diese Seite dokumentiert die öffentliche Schnittstelle von Modelflare. Bei den hier dargestellten Feldern und Grenzen handelt es sich um den aktuellen Vertrag.

Varianten

Modell-ID	Unterschied
seedance-2.0	Das auf dieser Seite dokumentierte Modell.