Nutzen Sie die RunComfy-API, um blackforestlabs/flux-3/video auszuführen. Zulässige Ein- und Ausgaben finden Sie im Schema.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3/video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "A powerful dappled-grey stallion gallops across a windswept green moor under a brooding storm sky, mane and tail streaming, clumps of turf kicking up in slow motion, distant thunder rumbling and hooves pounding the earth, cinematic low-angle tracking shot, moody desaturated color, anamorphic look."
}'Weisen Sie der Umgebungsvariable YOUR_API_TOKEN Ihren API-Schlüssel zu (Verwaltung unter Profil). Senden Sie bei jeder Anfrage im Header Authorization einen Bearer-Token: Authorization: Bearer $YOUR_API_TOKEN.
Senden Sie einen asynchronen Generierungsauftrag und erhalten Sie sofort eine request_id sowie URLs für Status, Ergebnisse und Abbruch.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3/video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "A powerful dappled-grey stallion gallops across a windswept green moor under a brooding storm sky, mane and tail streaming, clumps of turf kicking up in slow motion, distant thunder rumbling and hooves pounding the earth, cinematic low-angle tracking shot, moody desaturated color, anamorphic look."
}'Ruft den aktuellen Status für eine request_id ab („in_queue“, „in_progress“, „completed“ oder „cancelled“).
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"Ruft die endgültigen Ausgaben und Metadaten für die angegebene request_id ab; ist der Auftrag noch nicht fertig, liefert die Antwort den aktuellen Status zum Weiterpollen.
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"Bricht einen wartenden Auftrag per request_id ab; laufende Aufträge können nicht abgebrochen werden.
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"Geben Sie eine öffentlich erreichbare HTTPS-URL an. Der Host muss serverseitige Abrufe erlauben (ohne Login/Cookies), nicht drosseln oder Bots blockieren. Empfohlen: Bilder ≤ 50 MB (~4K), Videos ≤ 100 MB (~2–5 Min. bei 720p). Für private Assets stabile oder vorab signierte URLs verwenden.
{
"type": "object",
"title": "Eingabeschema",
"required": [
"prompt"
],
"properties": {
"prompt": {
"title": "Prompt",
"description": "Textprompt für das Video (empfohlen: Chinesisch bis etwa 500 Zeichen, Englisch bis etwa 1000 Wörter). ",
"type": "string",
"default": "A powerful dappled-grey stallion gallops across a windswept green moor under a brooding storm sky, mane and tail streaming, clumps of turf kicking up in slow motion, distant thunder rumbling and hooves pounding the earth, cinematic low-angle tracking shot, moody desaturated color, anamorphic look."
},
"images": {
"title": "Bilder",
"description": "Referenzbilder für den multimodalen Referenzmodus (0–9). Unterstützte Formate: JPEG, PNG, WebP, BMP, TIFF und GIF.",
"type": "array",
"items": {
"type": "string",
"format": "image_uri"
},
"maxItems": 9
},
"videos": {
"title": "Videos",
"description": "Referenzvideos für den multimodalen Referenzmodus (0–3). Unterstützte Formate: MP4 und MOV. Die Videolänge muss zwischen 2 und 15 Sekunden liegen.",
"type": "array",
"items": {
"type": "string",
"format": "video_uri"
},
"maxItems": 3
},
"audios": {
"title": "Audio-URLs",
"description": "Referenzaudio für den multimodalen Referenzmodus (0–3). Unterstützte Formate: WAV und MP3. Die Audiodauer muss zwischen 2 und 15 Sekunden liegen; die Datei muss kleiner als 15 MB sein.",
"type": "array",
"items": {
"type": "string",
"format": "audio_uri"
},
"maxItems": 3
},
"aspect_ratio": {
"title": "Seitenverhältnis (B:H)",
"description": "Standardmäßig ist die adaptive Auswahl aktiv: Das Modell wählt das nächstgelegene Verhältnis; das tatsächliche Verhältnis wird bei der Aufgabenabfrage zurückgegeben.",
"type": "string",
"enum": [
"adaptive",
"16:9",
"9:16",
"4:3",
"3:4",
"1:1",
"21:9"
],
"default": "adaptive"
},
"duration": {
"title": "Dauer (Sekunden)",
"description": "Ganzzahlige Sekundenzahl im Bereich [4, 15].",
"type": "integer",
"minimum": 4,
"maximum": 15,
"default": 5
},
"resolution": {
"title": "Auflösung",
"description": "",
"type": "string",
"enum": [
"480p",
"720p",
"1080p",
"4k"
],
"default": "720p"
},
"generate_audio": {
"title": "Audio erzeugen",
"description": "Wenn aktiviert, gibt das Modell ein Video mit synchronisiertem Ton aus (Sprache, Soundeffekte und Musik). ",
"type": "boolean",
"default": true
},
"seed": {
"title": "Seed",
"description": "Zufalls-Seed für die Videoerzeugung. ",
"type": "integer"
},
"tools": {
"title": "Websuche",
"description": " Wenn `web_search` aktiviert ist, kann das Modell abhängig vom Prompt online suchen, etwa nach bestimmten Produkten oder dem aktuellen Wetter. Das kann die Aktualität der Fakten verbessern, verlängert aber die Verarbeitungszeit. ",
"type": "boolean",
"default": false
}
}
}{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "Einzelbild-URL"
},
"video": {
"type": "string",
"format": "uri",
"description": "Einzelvideo-URL"
},
"images": {
"type": "array",
"description": "mehrere Bild-URLs",
"items": {
"type": "string",
"format": "uri"
}
},
"videos": {
"type": "array",
"description": "mehrere Video-URLs",
"items": {
"type": "string",
"format": "uri"
}
}
}
}
}RunComfy ist die führende ComfyUI Plattform, die ComfyUI online Umgebung und Services bietet, zusammen mit ComfyUI Workflows mit atemberaubenden Visualisierungen. RunComfy bietet auch AI Models, Künstlern ermöglichen, die neuesten AI-Tools zu nutzen, um unglaubliche Kunst zu schaffen.