# 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

1. **Bewegungen klar beschreiben**: Nehmen Sie konkrete Bewegungsbeschreibungen in die Prompts auf
2. **Auflösung wählen**: Verwenden Sie `480p` für schnellere Verarbeitung und `720p` für höhere Qualität
3. **Audio nutzen**: Lassen Sie `sound` für ein intensiveres Videoerlebnis aktiviert
4. **Bild zu Video**: Übermitteln Sie über `image_url` ein klares erstes Einzelbild; verwenden Sie `image_end_url`, um Anfangs- und Endbild gezielt festzulegen
5. **Referenzmedien**: Nutzen Sie unterstützte Bild-, Video- und Audioreferenzen und geben Sie mindestens ein Bild oder Video an
6. **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
7. **Seed-Parameter**: Senden Sie kein `seed`; Seedance 2.0 Mini-Modelle unterstützen diesen Parameter nicht