Seedance 2.0 Mini API

Vollständige API-Referenz für die Seedance 2.0 Mini-Videogenerierungsmodelle von ByteDance.

Modellvarianten

Diese API unterstützt drei Modellvarianten:

Modell	ID	Beschreibung
Seedance 2.0 Mini Text to Video	`seedance-v2.0-mini-text-to-video`	Kostengünstige Videogenerierung aus Text
Seedance 2.0 Mini Image to Video	`seedance-v2.0-mini-image-to-video`	Kostengünstige Bildanimation mit Bewegungssteuerung
Seedance 2.0 Mini Reference to Video	`seedance-v2.0-mini-reference-to-video`	Kostengünstige Videogenerierung anhand von Referenzbildern, -videos und -audio

Schnellvergleich

Funktion	Wert
Dauer	4–15 Sekunden
Auflösungen	480p, 720p
Seitenverhältnisse	21:9, 16:9, 9:16, 1:1, 4:3, 3:4
Audiounterstützung	Ja (standardmäßig aktiviert)
Referenzmedien	Bilder, Videos und Audio für referenzbasierte Videogenerierung
Seed-Steuerung	Von keinem Seedance 2.0 Mini-Modell unterstützt

Unterstützte Seitenverhältnisse

21:9, 16:9, 9:16, 1:1, 4:3, 3:4

Auflösungen

Auflösung	Beschreibung
`480p`	Standardauflösung, schnellere Verarbeitung
`720p`	Hohe Auflösung

Seedance 2.0 Mini Text to Video

Endpunkt

POST /api/v1/video/task

Anfrageparameter

Erforderlich

Parameter	Typ	Beschreibung
`model_name`	string	Muss `"seedance-v2.0-mini-text-to-video"` sein
`prompt`	string	Prompt für die Videogenerierung
`duration`	integer	Videodauer in ganzen Sekunden (4–15), in Schritten von 1
`resolution`	string	Ausgabeauflösung: `"480p"` oder `"720p"`
`aspect_ratio`	string	Seitenverhältnis des Videos: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` oder `"3:4"`

Optional

Parameter	Typ	Beschreibung
`sound`	boolean	Ob Umgebungsgeräusche erzeugt werden sollen (Standard: `true`)

Beispielanfrage

javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Seedance 2.0 Mini Image to Video

Anfrageparameter

Erforderlich

Parameter	Typ	Beschreibung
`model_name`	string	Muss `"seedance-v2.0-mini-image-to-video"` sein
`prompt`	string	Prompt für die Videogenerierung
`duration`	integer	Videodauer in ganzen Sekunden (4–15), in Schritten von 1
`resolution`	string	Ausgabeauflösung: `"480p"` oder `"720p"`
`aspect_ratio`	string	Seitenverhältnis des Videos: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` oder `"3:4"`
`image_url`	string	Erstes Einzelbild des Videos

Optional

Parameter	Typ	Beschreibung
`image_end_url`	string	Optionale Bild-URL für das letzte Einzelbild
`sound`	boolean	Ob Umgebungsgeräusche erzeugt werden sollen (Standard: `true`)

Beispielanfrage

javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-image-to-video',
    image_url: 'https://example.com/image.jpg',
    image_end_url: 'https://example.com/end-frame.jpg',
    prompt: 'Camera slowly pulls back to reveal the full landscape',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Seedance 2.0 Mini Reference to Video

Anfrageparameter

Erforderlich

Parameter	Typ	Beschreibung
`model_name`	string	Muss `"seedance-v2.0-mini-reference-to-video"` sein
`prompt`	string	Prompt für die Videogenerierung. Verwenden Sie einen normalen Prompt ohne Platzhalter oder optional die @ (AT)-Referenzfunktion mit `<<<image_N>>>`, `<<<video_N>>>` und `<<<audio_N>>>`, um explizit auf Elemente der jeweiligen Medienarrays zu verweisen
`duration`	integer	Videodauer in ganzen Sekunden (4–15), in Schritten von 1
`resolution`	string	Ausgabeauflösung: `"480p"` oder `"720p"`
`aspect_ratio`	string	Seitenverhältnis des Videos: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` oder `"3:4"`

Referenzmedien

Jede Anfrage muss mindestens ein Bild oder ein Video enthalten. Übermitteln Sie bei Bildreferenzen 1–9 Bilder. Das Array images darf nur dann fehlen oder leer sein, wenn das Array videos mindestens ein Referenzvideo enthält. Reine Audioanfragen werden nicht unterstützt.

Parameter	Typ	Beschreibung
`images`	string[]	1–9 Referenzbild-URLs oder ein leeres Array, wenn `videos` nicht leer ist
`videos`	string[]	Bis zu 3 Referenzvideo-URLs; jedes Video muss 2–15 Sekunden lang sein, bei einer Gesamtdauer von höchstens 15 Sekunden
`audios`	string[]	Bis zu 3 Referenzaudio-URLs; jeder Clip muss 2–15 Sekunden lang sein, bei einer Gesamtdauer von höchstens 15 Sekunden; WAV oder MP3, höchstens 15 MB je Clip; mindestens ein Bild oder Video erforderlich

@ (AT)-Referenzplatzhalter

Die @ (AT)-Referenzfunktion verknüpft Referenzmedien über nummerierte <<<...>>>-Platzhalter mit dem Prompt. Die Nummerierung beginnt für jeden Medientyp unabhängig bei 1 und folgt der Reihenfolge des jeweiligen Arrays:

Platzhalter	Referenzierter Wert
`<<<image_1>>>`	`images[0]`
`<<<image_2>>>`	`images[1]`
`<<<video_1>>>`	`videos[0]`
`<<<audio_1>>>`	`audios[0]`

Jeder Platzhalter muss auf ein vorhandenes Element im zugehörigen Array verweisen.

Optional

Parameter	Typ	Beschreibung
`sound`	boolean	Ob synchronisierter Ton erzeugt werden soll. Standardwert: `true`

Preise für Referenzvideos

Seedance V2.0 Mini Reference-to-Video verwendet dieselbe auflösungsabhängige Abrechnung pro Sekunde wie die anderen Seedance 2.0-Referenzvarianten. Wenn das Array videos mindestens ein Referenzvideo enthält, werden die gesamten Generierungskosten mit 2 multipliziert. Dieser Faktor wird einmal angewendet, unabhängig von Anzahl und Dauer der hochgeladenen Referenzvideos.

Beispielanfrage

javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-reference-to-video',
    prompt: 'Place the explorer from <<<image_1>>> in the environment from <<<image_2>>>, following the camera movement in <<<video_1>>> and speaking with the reference voice from <<<audio_1>>>',
    duration: 8,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true,
    images: [
      'https://example.com/explorer-reference.jpg',
      'https://example.com/environment-reference.jpg'
    ],
    videos: ['https://example.com/camera-movement-reference.mp4'],
    audios: ['https://example.com/voice-reference.mp3']
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Medienlimits

Diese Limits gelten für die ersten und letzten Einzelbilder sowie die Referenzmedien der Modelle auf dieser Seite.

Medium	Formate	Limits
Bilder	JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF	Jedes Bild muss kleiner als 30 MB sein; Breite und Höhe müssen jeweils 300–6000 px betragen; das Verhältnis von Breite zu Höhe muss 0,4–2,5 betragen
Videos	MP4, MOV	Höchstens 200 MB je Video; Breite und Höhe jeweils 300–6000 px; Verhältnis von Breite zu Höhe 0,4–2,5; Bildrate 24–60 FPS
Audio	WAV, MP3	Höchstens 15 MB je Datei
Anfragekörper	—	Höchstens 64 MB

Referenzaudio und Referenzvideos haben jeweils ein separates Limit von 15 Sekunden Gesamtdauer. Ihre Anzahlen sind unabhängig: bis zu 9 Bilder, 3 Videos und 3 Audioclips. Das Hinzufügen von Videos reduziert die erlaubte Anzahl an Bildern nicht.

Alle Modelle verwenden standardmäßig 720p; resolution muss dennoch angegeben werden. Der Tonschalter steht standardmäßig auf true; weder dieser Schalter noch Referenzaudio ändern den Preis. Referenzbasierte Videogenerierung erfordert mindestens ein Bild oder Video; reine Audioanfragen werden nicht unterstützt. Das Hochladen von Referenzvideos verdoppelt die Generierungskosten, unabhängig von Anzahl und Dauer.

Antwortformat

Erste Antwort

Alle Modelle geben eine task_id für wiederholte Statusabfragen zurück:

json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Antwort auf Statusabfragen

Fragen Sie GET /api/v1/video/{taskId} wiederholt ab, um den Status zu prüfen:

json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.2,
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Statuswerte

submitted: Aufgabe angenommen und wartet auf Verarbeitung
processing: Videogenerierung läuft
succeed: Videogenerierung abgeschlossen
failed: Videogenerierung fehlgeschlagen

Verarbeitungszeit

Die typische Verarbeitungszeit beträgt je nach Dauer und Auflösung 2–6 Minuten.

Fragen Sie den Status alle 5–10 Sekunden ab.

Bewährte Vorgehensweisen

Bewegungen klar beschreiben: Nehmen Sie konkrete Bewegungsbeschreibungen in die Prompts auf
Auflösung wählen: Verwenden Sie 480p für schnellere Verarbeitung und 720p für höhere Qualität
Audio nutzen: Lassen Sie sound für ein intensiveres Videoerlebnis aktiviert
Bild zu Video: Übermitteln Sie über image_url ein klares erstes Einzelbild; verwenden Sie image_end_url, um Anfangs- und Endbild gezielt festzulegen
Referenzmedien: Nutzen Sie unterstützte Bild-, Video- und Audioreferenzen und geben Sie mindestens ein Bild oder Video an
Preise für Referenzvideos: Jede Anfrage zur referenzbasierten Videogenerierung mit mindestens einem Referenzvideo wird zum doppelten Preis abgerechnet, unabhängig von Anzahl und Dauer der hochgeladenen Videos
Seed-Parameter: Senden Sie kein seed; Seedance 2.0 Mini-Modelle unterstützen diesen Parameter nicht

Seedance 2.0 Mini API

Vollständige API-Referenz für die Seedance 2.0 Mini-Videogenerierungsmodelle von ByteDance.

Modellvarianten

Diese API unterstützt drei Modellvarianten:

Modell	ID	Beschreibung
Seedance 2.0 Mini Text to Video	`seedance-v2.0-mini-text-to-video`	Kostengünstige Videogenerierung aus Text
Seedance 2.0 Mini Image to Video	`seedance-v2.0-mini-image-to-video`	Kostengünstige Bildanimation mit Bewegungssteuerung
Seedance 2.0 Mini Reference to Video	`seedance-v2.0-mini-reference-to-video`	Kostengünstige Videogenerierung anhand von Referenzbildern, -videos und -audio

Schnellvergleich

Funktion	Wert
Dauer	4–15 Sekunden
Auflösungen	480p, 720p
Seitenverhältnisse	21:9, 16:9, 9:16, 1:1, 4:3, 3:4
Audiounterstützung	Ja (standardmäßig aktiviert)
Referenzmedien	Bilder, Videos und Audio für referenzbasierte Videogenerierung
Seed-Steuerung	Von keinem Seedance 2.0 Mini-Modell unterstützt

Unterstützte Seitenverhältnisse

21:9, 16:9, 9:16, 1:1, 4:3, 3:4

Auflösungen

Auflösung	Beschreibung
`480p`	Standardauflösung, schnellere Verarbeitung
`720p`	Hohe Auflösung

Seedance 2.0 Mini Text to Video

Endpunkt

POST /api/v1/video/task

Anfrageparameter

Erforderlich

Parameter	Typ	Beschreibung
`model_name`	string	Muss `"seedance-v2.0-mini-text-to-video"` sein
`prompt`	string	Prompt für die Videogenerierung
`duration`	integer	Videodauer in ganzen Sekunden (4–15), in Schritten von 1
`resolution`	string	Ausgabeauflösung: `"480p"` oder `"720p"`
`aspect_ratio`	string	Seitenverhältnis des Videos: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` oder `"3:4"`

Optional

Parameter	Typ	Beschreibung
`sound`	boolean	Ob Umgebungsgeräusche erzeugt werden sollen (Standard: `true`)

Beispielanfrage

javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Seedance 2.0 Mini Image to Video

Anfrageparameter

Erforderlich

Parameter	Typ	Beschreibung
`model_name`	string	Muss `"seedance-v2.0-mini-image-to-video"` sein
`prompt`	string	Prompt für die Videogenerierung
`duration`	integer	Videodauer in ganzen Sekunden (4–15), in Schritten von 1
`resolution`	string	Ausgabeauflösung: `"480p"` oder `"720p"`
`aspect_ratio`	string	Seitenverhältnis des Videos: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` oder `"3:4"`
`image_url`	string	Erstes Einzelbild des Videos

Optional

Parameter	Typ	Beschreibung
`image_end_url`	string	Optionale Bild-URL für das letzte Einzelbild
`sound`	boolean	Ob Umgebungsgeräusche erzeugt werden sollen (Standard: `true`)

Beispielanfrage

javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-image-to-video',
    image_url: 'https://example.com/image.jpg',
    image_end_url: 'https://example.com/end-frame.jpg',
    prompt: 'Camera slowly pulls back to reveal the full landscape',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Seedance 2.0 Mini Reference to Video

Anfrageparameter

Erforderlich

Parameter	Typ	Beschreibung
`model_name`	string	Muss `"seedance-v2.0-mini-reference-to-video"` sein
`prompt`	string	Prompt für die Videogenerierung. Verwenden Sie einen normalen Prompt ohne Platzhalter oder optional die @ (AT)-Referenzfunktion mit `<<<image_N>>>`, `<<<video_N>>>` und `<<<audio_N>>>`, um explizit auf Elemente der jeweiligen Medienarrays zu verweisen
`duration`	integer	Videodauer in ganzen Sekunden (4–15), in Schritten von 1
`resolution`	string	Ausgabeauflösung: `"480p"` oder `"720p"`
`aspect_ratio`	string	Seitenverhältnis des Videos: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` oder `"3:4"`

Referenzmedien

Parameter	Typ	Beschreibung
`images`	string[]	1–9 Referenzbild-URLs oder ein leeres Array, wenn `videos` nicht leer ist
`videos`	string[]	Bis zu 3 Referenzvideo-URLs; jedes Video muss 2–15 Sekunden lang sein, bei einer Gesamtdauer von höchstens 15 Sekunden
`audios`	string[]	Bis zu 3 Referenzaudio-URLs; jeder Clip muss 2–15 Sekunden lang sein, bei einer Gesamtdauer von höchstens 15 Sekunden; WAV oder MP3, höchstens 15 MB je Clip; mindestens ein Bild oder Video erforderlich

@ (AT)-Referenzplatzhalter

Platzhalter	Referenzierter Wert
`<<<image_1>>>`	`images[0]`
`<<<image_2>>>`	`images[1]`
`<<<video_1>>>`	`videos[0]`
`<<<audio_1>>>`	`audios[0]`

Jeder Platzhalter muss auf ein vorhandenes Element im zugehörigen Array verweisen.

Optional

Parameter	Typ	Beschreibung
`sound`	boolean	Ob synchronisierter Ton erzeugt werden soll. Standardwert: `true`

Preise für Referenzvideos

Beispielanfrage

javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-reference-to-video',
    prompt: 'Place the explorer from <<<image_1>>> in the environment from <<<image_2>>>, following the camera movement in <<<video_1>>> and speaking with the reference voice from <<<audio_1>>>',
    duration: 8,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true,
    images: [
      'https://example.com/explorer-reference.jpg',
      'https://example.com/environment-reference.jpg'
    ],
    videos: ['https://example.com/camera-movement-reference.mp4'],
    audios: ['https://example.com/voice-reference.mp3']
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Medienlimits

Diese Limits gelten für die ersten und letzten Einzelbilder sowie die Referenzmedien der Modelle auf dieser Seite.

Medium	Formate	Limits
Bilder	JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF	Jedes Bild muss kleiner als 30 MB sein; Breite und Höhe müssen jeweils 300–6000 px betragen; das Verhältnis von Breite zu Höhe muss 0,4–2,5 betragen
Videos	MP4, MOV	Höchstens 200 MB je Video; Breite und Höhe jeweils 300–6000 px; Verhältnis von Breite zu Höhe 0,4–2,5; Bildrate 24–60 FPS
Audio	WAV, MP3	Höchstens 15 MB je Datei
Anfragekörper	—	Höchstens 64 MB

Antwortformat

Erste Antwort

Alle Modelle geben eine task_id für wiederholte Statusabfragen zurück:

json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Antwort auf Statusabfragen

Fragen Sie GET /api/v1/video/{taskId} wiederholt ab, um den Status zu prüfen:

json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.2,
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Statuswerte

submitted: Aufgabe angenommen und wartet auf Verarbeitung
processing: Videogenerierung läuft
succeed: Videogenerierung abgeschlossen
failed: Videogenerierung fehlgeschlagen

Verarbeitungszeit

Die typische Verarbeitungszeit beträgt je nach Dauer und Auflösung 2–6 Minuten.

Fragen Sie den Status alle 5–10 Sekunden ab.

Bewährte Vorgehensweisen

Bewegungen klar beschreiben: Nehmen Sie konkrete Bewegungsbeschreibungen in die Prompts auf
Auflösung wählen: Verwenden Sie 480p für schnellere Verarbeitung und 720p für höhere Qualität
Audio nutzen: Lassen Sie sound für ein intensiveres Videoerlebnis aktiviert
Bild zu Video: Übermitteln Sie über image_url ein klares erstes Einzelbild; verwenden Sie image_end_url, um Anfangs- und Endbild gezielt festzulegen
Referenzmedien: Nutzen Sie unterstützte Bild-, Video- und Audioreferenzen und geben Sie mindestens ein Bild oder Video an
Preise für Referenzvideos: Jede Anfrage zur referenzbasierten Videogenerierung mit mindestens einem Referenzvideo wird zum doppelten Preis abgerechnet, unabhängig von Anzahl und Dauer der hochgeladenen Videos
Seed-Parameter: Senden Sie kein seed; Seedance 2.0 Mini-Modelle unterstützen diesen Parameter nicht