Video mit Flatkey generieren

Basis-URL: https://router.flatkey.ai Flatkey generiert Videos über einen einzigen asynchronen Endpunkt. Du reichst einen Auftrag ein, fragst ihn ab, bis er fertig ist, und lädst dann die MP4 herunter. Diese Seite beschreibt, was für alle Videomodelle gemeinsam gilt. Für die modellspezifischen Optionen weiter zu Seedance oder MiniMax H3.

Ein asynchroner Workflow

Erstelle den Auftrag mit POST /v1/videos, frage ihn mit GET /v1/videos/{task_id} ab und lade die MP4 aus metadata.url herunter.

Zwei Anfrageformate

Einige Modelle erwarten ein content-Array, andere einen prompt-String. Das falsche Format zu senden gibt 400 zurück.

Verwende diesen Autorisierungs-Header bei jeder Anfrage auf dieser Seite, einschließlich des Downloads:

Authorization: Bearer YOUR_FLATKEY_API_KEY

Ein Videomodell finden

Liste alle Modelle auf und behalte diejenigen, deren type gleich video ist:

curl --fail-with-body -sS https://router.flatkey.ai/v1/models \
  -H "Authorization: Bearer YOUR_FLATKEY_API_KEY" \
  | jq '.data[] | select(.type == "video") | .id'

"grok-imagine-video"
"grok-imagine-video-1.5"
"MiniMax-H3"
"seedance-2.5"
"veo-3.1-fast-generate-preview"
"veo-3.1-generate-preview"

/v1/models ignoriert Query-Parameter. Die Filterung erfolgt in deinem eigenen Code, wie im jq-Beispiel oben.

Du kannst dieselbe Liste mit Preisen auch im Modellverzeichnis durchsuchen.

Das richtige Anfrageformat wählen

Der Endpunkt akzeptiert zwei verschiedene Formate, und jedes Modell verwendet genau eines davon.

Modell	Prompt-Feld
`seedance-2.5`	`content`-Array
`seedance-2.0-pro`	`content`-Array
`MiniMax-H3`	`content`-Array
`grok-imagine-video`	`prompt`-String
`grok-imagine-video-1.5`	`prompt`-String
`veo-3.1-generate-preview`	`prompt`-String
`veo-3.1-fast-generate-preview`	`prompt`-String

Ein content-Array an ein prompt-Modell zu senden gibt zurück:

{ "code": "invalid_request", "message": "prompt is required" }

Das `content`-Format

curl --fail-with-body -sS https://router.flatkey.ai/v1/videos \
  -H "Authorization: Bearer YOUR_FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "content": [
      { "type": "text", "text": "a quiet neon-lit street at dusk, slow camera drift" }
    ],
    "duration": 5,
    "resolution": "720p"
  }'

Das Array enthält auch Bilder. Füge einen image_url-Eintrag hinzu, um zwischen Frames zu interpolieren oder eine Referenz bereitzustellen. Feldnamen unterscheiden sich je nach Modell – befolge daher die modellspezifische Anleitung.

Das `prompt`-Format

curl --fail-with-body -sS https://router.flatkey.ai/v1/videos \
  -H "Authorization: Bearer YOUR_FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "a quiet neon-lit street at dusk, slow camera drift",
    "duration": 10
  }'

Auflösungen unterscheiden sich je nach Modell

Es gibt keinen gemeinsamen Satz von Auflösungswerten. Das Senden eines nicht unterstützten Werts gibt 400 zurück, bevor der Auftrag erstellt wird.

Modell	Akzeptierte Werte	Hinweise
`seedance-2.5`	`480p`, `720p`	`1080p` gibt `unsupported resolution` zurück
`MiniMax-H3`	`768P`, `2K`	Großes `P`. Andere Werte geben `resolution must be 768P or 2K` zurück
`grok-imagine-video`	`720p`	Ausgabe ist `848x480`, unabhängig davon
`veo-3.1-*`	`720p`

Prüfe die modellspezifische Anleitung, bevor du eine Auflösung wählst. 1080p wird von seedance-2.5 abgelehnt, und 720p wird von MiniMax-H3 abgelehnt.

Anfrageparameter

Parameter	Typ	Erforderlich	Beschreibung
`model`	string	Ja	Modell-ID aus `/v1/models`
`content`	array	Bedingt	Prompt und Medien für `content`-Format-Modelle
`prompt`	string	Bedingt	Prompt für `prompt`-Format-Modelle
`duration`	integer	Nein	Länge in Sekunden. `MiniMax-H3` akzeptiert `4` bis `15`
`resolution`	string	Nein	Siehe Tabelle oben

aspect_ratio und seed werden ohne Fehler akzeptiert, ändern aber die Ausgabe nicht bei jedem Modell. Bei grok-imagine-video gibt die Angabe von 9:16 immer noch einen 848x480-Querformat-Clip zurück, und derselbe seed erzeugt jedes Mal eine andere Datei. Wo ein Modell Ausrichtung unterstützt, ist dies auf der modellspezifischen Seite dokumentiert. Verlasse dich bei modellübergreifendem Verhalten nicht auf diese zwei Felder.

Den Auftrag abfragen

Eine erfolgreiche Einreichung gibt sofort einen Auftrag zurück:

{
  "id": "task_aaaaaaaaaaaaaaaa",
  "task_id": "task_aaaaaaaaaaaaaaaa",
  "object": "video",
  "model": "seedance-2.5",
  "status": "queued",
  "progress": 0,
  "created_at": 1787110914
}

Frage mit der Auftrags-ID ab, bis der Status einen Endwert erreicht:

curl --fail-with-body -sS https://router.flatkey.ai/v1/videos/task_aaaaaaaaaaaaaaaa \
  -H "Authorization: Bearer YOUR_FLATKEY_API_KEY"

{
  "id": "task_aaaaaaaaaaaaaaaa",
  "status": "completed",
  "progress": 100,
  "completed_at": 1787111135,
  "metadata": {
    "url": "https://router.flatkey.ai/v1/videos/task_aaaaaaaaaaaaaaaa/content"
  }
}

Status	Bedeutung
`queued`	Akzeptiert und wartend
`in_progress`	Wird generiert
`completed`	Bereit zum Herunterladen aus `metadata.url`
`failed`	Generierung fehlgeschlagen. Fehlerfeld lesen

Frage etwa alle 15 Sekunden ab. Ein fünf Sekunden langer Clip ist normalerweise in zwei bis vier Minuten fertig.

Die MP4 herunterladen

Die Download-URL erscheint in metadata.url und benötigt denselben Autorisierungs-Header:

curl -L "https://router.flatkey.ai/v1/videos/task_aaaaaaaaaaaaaaaa/content" \
  -H "Authorization: Bearer YOUR_FLATKEY_API_KEY" \
  -o output.mp4

Vollständiges Beispiel

import os, time, requests

BASE = "https://router.flatkey.ai/v1"
HEAD = {"Authorization": f"Bearer {os.environ['FLATKEY_API_KEY']}",
        "Content-Type": "application/json"}

task = requests.post(f"{BASE}/videos", headers=HEAD, json={
    "model": "seedance-2.5",
    "content": [{"type": "text", "text": "a quiet neon-lit street at dusk"}],
    "duration": 5,
    "resolution": "720p",
}).json()

task_id = task["task_id"]

while True:
    time.sleep(15)
    state = requests.get(f"{BASE}/videos/{task_id}", headers=HEAD).json()
    if state["status"] == "completed":
        mp4 = requests.get(state["metadata"]["url"], headers=HEAD).content
        open("output.mp4", "wb").write(mp4)
        break
    if state["status"] == "failed":
        raise RuntimeError(state)

Fehlerbehebung

prompt is required Du hast ein content-Array an ein Modell gesendet, das prompt erwartet. Prüfe die Tabelle unter Das richtige Anfrageformat wählen. unsupported resolution oder resolution must be 768P or 2K Der Wert ist für ein anderes Modell gültig. Siehe Auflösungen unterscheiden sich je nach Modell. No available channel for model ... Das Modell ist momentan nicht routbar. Wähle stattdessen ein anderes Videomodell – dieser Fehler löst sich nicht von selbst. Prüfe das Modellverzeichnis für aktuelle Verfügbarkeit. duration must be between 4 and 15 MiniMax-H3 erfordert einen duration-Wert in diesem Bereich. Sende einen explizit mit. Der Auftrag bleibt auf queued Die Videogenerierung dauert Minuten, nicht Sekunden. Fahre mit einem 15-Sekunden-Intervall fort, bevor du ihn als hängengeblieben behandelst.

Modellanleitungen

Seedance

Text-zu-Video plus die Bibliothek virtueller und realer Personen-Assets.

MiniMax H3

Steuerung von erstem und letztem Frame, Referenzmedien und Auftragseinstellungen.

Schnellstart

Code

Gängige KI-Tools

Medienerzeugung

Beliebte Modelle

Dashboard

Referenz

Video mit Flatkey generieren

Ein asynchroner Workflow

Zwei Anfrageformate

Ein Videomodell finden

Das richtige Anfrageformat wählen

Das `content`-Format

Das `prompt`-Format

Auflösungen unterscheiden sich je nach Modell

Anfrageparameter

Den Auftrag abfragen

Die MP4 herunterladen

Vollständiges Beispiel

Fehlerbehebung

Modellanleitungen

Seedance

MiniMax H3

Ein asynchroner Workflow

Zwei Anfrageformate

​Ein Videomodell finden

​Das richtige Anfrageformat wählen

​Das content-Format

​Das prompt-Format

​Auflösungen unterscheiden sich je nach Modell

​Anfrageparameter

​Den Auftrag abfragen

​Die MP4 herunterladen

​Vollständiges Beispiel

​Fehlerbehebung

​Modellanleitungen

Seedance

MiniMax H3

Ein Videomodell finden

Das richtige Anfrageformat wählen

Das `content`-Format

Das `prompt`-Format

Auflösungen unterscheiden sich je nach Modell

Anfrageparameter

Den Auftrag abfragen

Die MP4 herunterladen

Vollständiges Beispiel

Fehlerbehebung

Modellanleitungen