seedance-2.5 API

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

Beispielausgabeseedance-2.5POST /v1/videos5.1s

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

Prompt: A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, no text.

Anfrage, die dieses Beispiel erstellt hat

{
  "model": "seedance-2.5",
  "prompt": "A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, 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.5",
    "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.5
content[]	Ja	text, image_url, video_url und audio_url; Verwenden Sie role, um den Medienzweck zu identifizieren
resolution	Nein	480p / 720p / 1080p
ratio	Nein	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	Nein	-1 für automatisches Timing oder 4–30 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
omni_reference_task_type	Nein	auto / reference / edit / extend; Bearbeitung und Erweiterung erfordern strengere Verhältnis-/Dauerregeln
output_format	Nein	mp4 / mov
return_last_frame	Nein	Gibt den letzten Frame als Bild zurück

Eingabe- und Ausgabegrenzen

Dieses Modell unterstützt 480p, 720p und 1080p. Verwenden Sie -1 für die automatische Zeitmessung oder wählen Sie 4–30 Sekunden. Eine Anfrage kann bis zu 30 Bilder, 10 Videos und 10 Audioclips kombinieren. Die normale Referenzgenerierung akzeptiert ein explizites Verhältnis oder adaptive; Bearbeitungs-, Erweiterungs- und erste/letzte Frame-Workflows erfordern ratio: "adaptive", und die Bearbeitung erfordert duration: -1. Bilder virtueller Personen müssen zuerst in die Asset-Bibliothek hochgeladen werden; Modelflare bietet keine Verifizierung realer Personen an.

Dokumentierte Workflow-Beispiele

Seedance 2.5 klassifiziert Referenz-, Bearbeitungs-, Erweiterungs- und Frame-geführte Workflows anhand der Medienrollen und des Aufgabentyps. Die Beispiele behalten den offiziellen Vertrag bei, während sie den Endpunkt und die Modell-ID von Modelflare verwenden.

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.5",
    "omni_reference_task_type": "reference",
    "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"}
    ],
    "ratio": "16:9", "duration": 15, "output_format": "mp4"
  }'

Videobearbeitung

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "edit",
    "content": [
      {"type":"text","text":"Remove the background pedestrians but preserve the main subject"},
      {"type":"video_url","video_url":{"url":"https://example.com/source.mov"},"role":"reference_video"}
    ],
    "ratio": "adaptive", "duration": -1, "output_format": "mov"
  }'

Videoerweiterung

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "extend",
    "content": [{"type":"video_url","video_url":{"url":"https://example.com/source.mp4"},"role":"reference_video"}],
    "ratio": "adaptive", "duration": 11, "output_format": "mov"
  }'

Erstes und letztes Bild

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "content": [
      {"type":"text","text":"The subject smiles while the camera makes a smooth orbit"},
      {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
      {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
    ],
    "ratio": "adaptive", "duration": -1, "return_last_frame": true
  }'

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.5	Das auf dieser Seite dokumentierte Modell.