Video API

Videos generieren

Führen Sie Seedance 2.5, Seedance 2.5 CN, Seedance 2.0, Seedance 2.0 CN, Seedance 2.0 Fast, Seedance 2.0 Fast CN, Seedance 2.0 Mini, Seedance 2.0 Mini CN aus. Jede Videoanfrage erstellt eine Aufgabe, die Sie abfragen oder per Webhook empfangen.

Generierungsmodi

Legen Sie mode fest, um einen Workflow auszuwählen. Der Standardwert ist text_to_video. Wählen Sie einen Modus aus, um das folgende Beispiel zu aktualisieren.

Anfragebeispiel

POSThttps://api.mlmux.com/v1/videos/generations

curl https://api.mlmux.com/v1/videos/generations \
  -H "Authorization: Bearer $MLMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "model/seedance-2.5-max",
  "prompt": "A cinematic tracking shot along a coastal road at sunrise, warm backlight, gentle camera drift",
  "mode": "text_to_video",
  "ratio": "16:9",
  "resolution": "720p",
  "duration": 8,
  "generate_audio": true,
  "route_mode": "official-cheap"
}'

Parameter

Feld	Typ	Erforderlich	Beschreibung
`model`	string	Ja	Eine Modell-ID aus der folgenden Tabelle.
`prompt`	string	Ja	Szene, Motiv, Bewegung, Kamera, Beleuchtung und Audio-Regie.
`mode`	string	Nein	`text_to_video` (Standard), `image_to_video`, `first_last_frame` oder `multi_ref`.
`ratio`	string	Nein	`16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9` oder `adaptive`, sofern aufgeführt. Standardmäßig `adaptive`.
`resolution`	string	Nein	`480p`, `720p`, `1080p` oder `4K`, wie für das Modell angegeben. Standardmäßig `720p`.
`duration`	integer	Nein	Cliplänge in Sekunden innerhalb des Modellbereichs. Standardmäßig 5. Verwenden Sie `-1`, um das Modell wählen zu lassen.
`generate_audio`	boolean	Nein	Synchronisiertes Audio zum Clip generieren.
`route_mode`	string	Nein	`official` oder `official-cheap`. Standardmäßig der Route Mode des Schlüssels, sonst `official-cheap`.
`image_url`	string	Bedingt	Erforderlich für `image_to_video`: das Startbild (Frame).
`first_frame_url` `last_frame_url`	string	Bedingt	Erforderlich für `first_last_frame`. Alternativ können zwei geordnete `image_urls` übergeben werden.
`image_urls`	string[]	Bedingt	Referenzbilder für `multi_ref`.
`video_urls` `audio_urls`	string[]	Bedingt	Referenzvideos und -audiodateien für `multi_ref`.

multi_ref erfordert mindestens eine Referenz. Seedance 2.5 akzeptiert bis zu 30 Bilder, 10 Videos und 10 Audiodateien (insgesamt 50); andere Modelle akzeptieren bis zu 9 Bilder, 3 Videos und 3 Audiodateien (insgesamt 12). Verwenden Sie öffentliche https-URLs oder laden Sie Dateien vorab über POST /v1/uploads hoch.

Modelle

Modell	Modell-ID	Auflösung	Seitenverhältnis	Dauer
Seedance 2.5	`model/seedance-2.5-max`	480p · 720p · 1080p	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–30 s
Seedance 2.5 CN	`model/seedance-2.5-cn-max`	480p · 720p · 1080p	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–30 s
Seedance 2.0	`model/seedance-2.0-max`	480p · 720p · 1080p · 4K	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–15 s
Seedance 2.0 CN	`model/seedance-2.0-cn-max`	480p · 720p · 1080p · 4K	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–15 s
Seedance 2.0 Fast	`model/seedance-2.0-fast-max`	480p · 720p	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–15 s
Seedance 2.0 Fast CN	`model/seedance-2.0-fast-cn-max`	480p · 720p	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–15 s
Seedance 2.0 Mini	`model/seedance-2.0-mini-max`	480p · 720p	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–15 s
Seedance 2.0 Mini CN	`model/seedance-2.0-mini-cn-max`	480p · 720p	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–15 s

Diese IDs enden auf -max, daher sind ratio, resolution und duration optional und greifen auf die oben genannten Standardwerte zurück.

Task-Lebenszyklus

Das Erstellen eines Videos gibt immer HTTP 202 mit einem Task zurück. Speichern Sie dessen id und fragen Sie poll_url ab. Wenn status auf succeeded steht, enthält die Antwort video, usage und actual_charge_credits.

GEThttps://api.mlmux.com/v1/videos/generations/{task_id}

202 Accepted

{
  "id": "task_01a9...",
  "object": "video.generation.task",
  "status": "queued",
  "created": 1767225600,
  "model": "model/seedance-2.5-max",
  "api_method": "videos.generations.create",
  "poll_url": "/v1/videos/generations/task_01a9...",
  "progress": 0,
  "message": "queued",
  "estimated_charge_credits": 1.84
}

Erfolgreich

{
  "id": "task_01a9...",
  "object": "video.generation.task",
  "status": "succeeded",
  "progress": 100,
  "message": "completed",
  "video": "https://.../generated/01a9....mp4",
  "last_frame_image": "https://.../generated/01a9....jpg",
  "usage": {
    "output_tokens": 172800,
    "video_seconds": 8,
    "video_resolution": "720p"
  },
  "estimated_charge_credits": 1.84,
  "actual_charge_credits": 1.79
}

Ein fehlgeschlagener Task hat den status failed und den Grund in message. Ausgabe-URLs werden von MLMux gehostet; laden Sie Dateien herunter, die Sie behalten möchten.

Webhooks

Statt Polling zu nutzen, abonnieren Sie request.succeeded und request.failed. Details zu Payload und Signaturprüfung finden Sie unter Webhooks.

Video API

Videos generieren

Generierungsmodi

Legen Sie mode fest, um einen Workflow auszuwählen. Der Standardwert ist text_to_video. Wählen Sie einen Modus aus, um das folgende Beispiel zu aktualisieren.

Anfragebeispiel

POSThttps://api.mlmux.com/v1/videos/generations

curl https://api.mlmux.com/v1/videos/generations \
  -H "Authorization: Bearer $MLMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "model/seedance-2.5-max",
  "prompt": "A cinematic tracking shot along a coastal road at sunrise, warm backlight, gentle camera drift",
  "mode": "text_to_video",
  "ratio": "16:9",
  "resolution": "720p",
  "duration": 8,
  "generate_audio": true,
  "route_mode": "official-cheap"
}'

Parameter

Feld	Typ	Erforderlich	Beschreibung
`model`	string	Ja	Eine Modell-ID aus der folgenden Tabelle.
`prompt`	string	Ja	Szene, Motiv, Bewegung, Kamera, Beleuchtung und Audio-Regie.
`mode`	string	Nein	`text_to_video` (Standard), `image_to_video`, `first_last_frame` oder `multi_ref`.
`ratio`	string	Nein	`16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9` oder `adaptive`, sofern aufgeführt. Standardmäßig `adaptive`.
`resolution`	string	Nein	`480p`, `720p`, `1080p` oder `4K`, wie für das Modell angegeben. Standardmäßig `720p`.
`duration`	integer	Nein	Cliplänge in Sekunden innerhalb des Modellbereichs. Standardmäßig 5. Verwenden Sie `-1`, um das Modell wählen zu lassen.
`generate_audio`	boolean	Nein	Synchronisiertes Audio zum Clip generieren.
`route_mode`	string	Nein	`official` oder `official-cheap`. Standardmäßig der Route Mode des Schlüssels, sonst `official-cheap`.
`image_url`	string	Bedingt	Erforderlich für `image_to_video`: das Startbild (Frame).
`first_frame_url` `last_frame_url`	string	Bedingt	Erforderlich für `first_last_frame`. Alternativ können zwei geordnete `image_urls` übergeben werden.
`image_urls`	string[]	Bedingt	Referenzbilder für `multi_ref`.
`video_urls` `audio_urls`	string[]	Bedingt	Referenzvideos und -audiodateien für `multi_ref`.

Modelle

Modell	Modell-ID	Auflösung	Seitenverhältnis	Dauer
Seedance 2.5	`model/seedance-2.5-max`	480p · 720p · 1080p	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–30 s
Seedance 2.5 CN	`model/seedance-2.5-cn-max`	480p · 720p · 1080p	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–30 s
Seedance 2.0	`model/seedance-2.0-max`	480p · 720p · 1080p · 4K	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–15 s
Seedance 2.0 CN	`model/seedance-2.0-cn-max`	480p · 720p · 1080p · 4K	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–15 s
Seedance 2.0 Fast	`model/seedance-2.0-fast-max`	480p · 720p	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–15 s
Seedance 2.0 Fast CN	`model/seedance-2.0-fast-cn-max`	480p · 720p	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–15 s
Seedance 2.0 Mini	`model/seedance-2.0-mini-max`	480p · 720p	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–15 s
Seedance 2.0 Mini CN	`model/seedance-2.0-mini-cn-max`	480p · 720p	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–15 s

Diese IDs enden auf -max, daher sind ratio, resolution und duration optional und greifen auf die oben genannten Standardwerte zurück.

Task-Lebenszyklus

GEThttps://api.mlmux.com/v1/videos/generations/{task_id}

202 Accepted

{
  "id": "task_01a9...",
  "object": "video.generation.task",
  "status": "queued",
  "created": 1767225600,
  "model": "model/seedance-2.5-max",
  "api_method": "videos.generations.create",
  "poll_url": "/v1/videos/generations/task_01a9...",
  "progress": 0,
  "message": "queued",
  "estimated_charge_credits": 1.84
}

Erfolgreich

{
  "id": "task_01a9...",
  "object": "video.generation.task",
  "status": "succeeded",
  "progress": 100,
  "message": "completed",
  "video": "https://.../generated/01a9....mp4",
  "last_frame_image": "https://.../generated/01a9....jpg",
  "usage": {
    "output_tokens": 172800,
    "video_seconds": 8,
    "video_resolution": "720p"
  },
  "estimated_charge_credits": 1.84,
  "actual_charge_credits": 1.79
}

Ein fehlgeschlagener Task hat den status failed und den Grund in message. Ausgabe-URLs werden von MLMux gehostet; laden Sie Dateien herunter, die Sie behalten möchten.

Webhooks

Statt Polling zu nutzen, abonnieren Sie request.succeeded und request.failed. Details zu Payload und Signaturprüfung finden Sie unter Webhooks.