> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedance 2.5 Flash Videogenerierung

> Erstellen Sie bis zu 30 Sekunden lange Videos in 480p / 720p aus Text, multimodalen Referenzen, durch Bearbeitung, Verlängerung oder Start- und Endbilder.

```bash cURL theme={null}
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2-5-flash",
  "prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
  "resolution": "720p",
  "size": "16:9",
  "duration": 8,
  "generate_audio": true,
  "nsfw_check": true,
  "return_last_frame": true
}'
```

```python Python theme={null}
import requests

payload = {
  "model": "seedance-2-5-flash",
  "prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
  "resolution": "720p",
  "size": "16:9",
  "duration": 8,
  "generate_audio": True,
  "nsfw_check": True,
  "return_last_frame": True
}
response = requests.post(
    "https://api.apimart.ai/v1/videos/generations",
    headers={"Authorization": "Bearer <token>"},
    json=payload,
    timeout=60,
)
response.raise_for_status()
print(response.json())
```

```javascript JavaScript theme={null}
const payload = {
  "model": "seedance-2-5-flash",
  "prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
  "resolution": "720p",
  "size": "16:9",
  "duration": 8,
  "generate_audio": true,
  "nsfw_check": true,
  "return_last_frame": true
};
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
```

```json 200 theme={null}
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_example_seedance25flash"
    }
  ]
}
```

Senden Sie `POST /v1/videos/generations`, lesen Sie `data[0].task_id` und fragen Sie anschließend `GET /v1/tasks/{task_id}` ab.

**Authorization** `string` *required*

Verwenden Sie `Authorization: Bearer <token>`. `<token>` ist Ihr APIMart-API-Schlüssel.

## Anfrageparameter

**model** `string` *required*

Verwenden Sie `seedance-2-5-flash`. Auch `doubao-seedance-2-5-flash` wird akzeptiert. Der Name mit Punkt `seedance-2.5-flash` wird nicht unterstützt.

**nsfw\_check** `boolean` (default: false)

Legt fest, ob der Inhalt vor dem Absenden des Videoauftrags moderiert wird.

* `true`: Prompts und Eingabebilder mit `omni-moderation-latest` prüfen
* `false` oder nicht angegeben: keine Moderationsanfrage und damit keine zusätzlichen Moderationskosten oder Verzögerung (Standard)

Ein Treffer liefert HTTP 400 (`nsfw_content_detected`), ohne Aufgabe oder Generierungskosten. Referenzvideos und Audio werden nicht geprüft. Bei Ausfall der Moderation kann die Anfrage fortgesetzt werden.

**prompt** `string` *required*

Erforderlicher Prompt. Referenzieren Sie Medien mit `@图片1` / `@视频1` / `@音频1`. Die Indizes beginnen bei 1 und folgen der Reihenfolge im jeweiligen Medienarray.

**resolution** `string` (default: 720p)

Nur `480p` / `720p`; Standard: `720p`. Werte wie `1080p`, `2k` oder `4k` führen beim Senden zu HTTP 400.

**size** `string` (default: adaptive)

`16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive` (Standard). Alias: `aspect_ratio`. Start-/Endbild-, Bearbeitungs- und Verlängerungsaufgaben erfordern `adaptive`.

**duration** `integer`

Ganze Sekunden `4`–`30`; normale Anfragen verwenden ohne Angabe `5`. `-1` bedeutet automatisch. Explizites `edit` erlaubt nur `-1` oder keine Angabe; Letzteres wird zu `-1`, die Dauer folgt dem Quellvideo. Automatische Dauer reserviert 30 Sekunden und wird nach tatsächlichen Tokens abgerechnet.

**generate\_audio** `boolean` (default: true)

Ton erzeugen, standardmäßig `true`. Alias: `audio`. Steuert den Ausgabeton unabhängig von den Eingabereferenzen `audio_urls`.

**watermark** `boolean` (default: false)

KI-Wasserzeichen hinzufügen; Standard `false`.

**seed** `integer`

Optionaler Zufallsseed. Derselbe Seed garantiert kein identisches Ergebnis.

**output\_format** `string` (default: mp4)

Ausgabecontainer: `mp4` (Standard) oder `mov`.

**omni\_reference\_task\_type** `string` (default: auto)

`auto` (Standard), `reference`, `edit` oder `extend`, nur mit Referenzmedien. Explizite Typen aktivieren die unten beschriebenen Prüfungen beim Senden.

**image\_urls** `string[]`

Referenzbilder, alle als `reference_image` behandelt. Zusammen mit `image_with_roles` maximal 10 Bilder. Für Start- und Endbilder verwenden Sie `image_with_roles`.

**image\_with\_roles** `object[]`

Jedes Element enthält `url` und `role`. Rollen: `reference_image`, `first_frame` (maximal 1), `last_frame` (maximal 1, mit Startbild). Zusammen mit `image_urls` maximal 10 Bilder; vermeiden Sie widersprüchliche Rollen. Bei `video_urls` / `audio_urls` werden Start-/Endbilder als multimodale Referenzbilder behandelt.

**video\_urls** `string[]`

Maximal 5 Referenzvideos, jeweils 2–30 Sekunden, insgesamt höchstens 30 Sekunden. Quellvideos zur Bearbeitung müssen 4–30 Sekunden lang sein.

**audio\_urls** `string[]`

Maximal 5 Audioreferenzen, jeweils 2–30 Sekunden, insgesamt höchstens 30 Sekunden. Reine Audioreferenzen ohne Bild oder Video werden unterstützt.

**return\_last\_frame** `boolean` (default: false)

Mit `true` wird nach Erfolg ein Endbild unter `data.result.videos[].last_frame_url` zurückgegeben.

**web\_search** `boolean` (default: false)

Dem Modell bei Bedarf Websuche erlauben; Standard `false`.

**tools** `object[]`

Optionale Werkzeuge, z. B. `[{"type":"web_search"}]` für Websuche.

> [!WARNING]
>
> `draft` / `draft_task_id` werden nicht unterstützt. Entfernen Sie diese Felder, sonst wird beim Senden HTTP 400 zurückgegeben. Für Entwürfe verwenden Sie [Seedance 2.5](https://docs.apimart.ai/de/api-reference/videos/seedance-2-5/generation.md).

## Medienanforderungen

Verwenden Sie öffentlich erreichbare `http(s)`-URLs oder freigegebene `asset://`-IDs. Ausgabeauflösung und Pixelgrenzen der Eingabevideos werden getrennt geprüft.

| Medium | Grenzen |
| - | - |
| Bilder | Zusammen ≤10 in beiden Bildfeldern; JPEG / PNG / WebP / BMP / TIFF / GIF / HEIC / HEIF; Breite und Höhe jeweils 300–6000 px; Verhältnis 0.4–2.5; jeweils `<30 MB`. |
| Videos | ≤5; MP4 / MOV mit H.264 / H.265 und AAC / MP3; jeweils 2–30 Sekunden, insgesamt ≤30 Sekunden; jeweils ≤200 MB; Breite und Höhe 300–6000 px, Verhältnis 0.4–2.5, Breite × Höhe 409,600–8,295,044 Pixel, 24–60 FPS. |
| Audio | ≤5; WAV / MP3; jeweils 2–30 Sekunden, insgesamt ≤30 Sekunden; jeweils ≤15 MB. |

## Aufgabentypen und Einschränkungen

| Modus | Verwendung und Einschränkungen |
| - | - |
| Text zu Video | `prompt` ohne Referenzmedien; `omni_reference_task_type` weglassen. |
| Referenzen zu Video | Referenzmedien angeben; `reference` ist optional. Normale Dauer- und Formatgrenzen gelten weiterhin. |
| Start-/Endbilder | `image_with_roles` verwenden; `size` / `aspect_ratio` muss `adaptive` sein. |
| Videobearbeitung | `edit`; mindestens 1 Quellvideo mit 4–30 Sekunden; Verhältnis `adaptive`, `duration` nur `-1` oder weglassen. |
| Videoverlängerung | `extend`; mindestens 1 Referenzvideo; Verhältnis `adaptive`. |

Verletzungen expliziter Typgrenzen führen vor Aufgabenerstellung und Abrechnung zu HTTP 400. Bei `auto` bestimmt das Modell den Typ anhand von Medien und Prompt; Einschränkungen können daher erst während der Generierung zum Fehler führen. Auch ein expliziter Typ kann bei widersprüchlichem Prompt mit `InvalidParameter.TaskTypeMismatch` scheitern.

## Anfragebeispiele

### Multimodale Referenz

```json theme={null}
{
  "model": "seedance-2-5-flash",
  "prompt": "Use the composition of @视频1, the subject in @图片1, and @音频1 as background music",
  "image_urls": [
    "https://example.com/reference.jpg"
  ],
  "video_urls": [
    "https://example.com/reference_8s.mp4"
  ],
  "audio_urls": [
    "https://example.com/music_5s.mp3"
  ],
  "omni_reference_task_type": "reference",
  "duration": 8,
  "size": "16:9"
}
```

### Start- und Endbilder

```json theme={null}
{
  "model": "seedance-2-5-flash",
  "prompt": "Smoothly transition from the first frame to the last frame",
  "image_with_roles": [
    {
      "url": "https://example.com/first.jpg",
      "role": "first_frame"
    },
    {
      "url": "https://example.com/last.jpg",
      "role": "last_frame"
    }
  ],
  "size": "adaptive",
  "duration": 5
}
```

### Videobearbeitung

```json theme={null}
{
  "model": "seedance-2-5-flash",
  "prompt": "Edit @视频1: replace the cloudy sky with a clear sunset while preserving the camera movement",
  "video_urls": [
    "https://example.com/source_10s.mp4"
  ],
  "omni_reference_task_type": "edit",
  "size": "adaptive",
  "duration": -1,
  "output_format": "mov"
}
```

### Videoverlängerung

```json theme={null}
{
  "model": "seedance-2-5-flash",
  "prompt": "Extend @视频1 forward: continue the camera movement as the subject walks into the forest",
  "video_urls": [
    "https://example.com/source_10s.mp4"
  ],
  "omni_reference_task_type": "extend",
  "size": "adaptive",
  "duration": 5
}
```

## Private Medien

Bilder oder Videos mit echten Gesichtern müssen zuerst in der Medienbibliothek freigegeben werden; danach verwenden Sie `asset://`. Setzen Sie auch beim Upload `model` auf `seedance-2-5-flash`. Siehe [Medienbibliothek-API](https://docs.apimart.ai/de/api-reference/videos/seedance-2-0/private-avatar.md); verwenden Sie den Flash-Namen im folgenden Beispiel.

```bash theme={null}
curl --request POST \
  --url https://api.apimart.ai/v1/seedance2/private-avatar/assets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2-5-flash",
  "group": {
    "name": "flash-assets"
  },
  "asset_type": "Image",
  "assets": [
    {
      "url": "https://example.com/reference.jpg",
      "name": "reference"
    }
  ]
}'
```

Fragen Sie die Medienprüfung über die einheitliche Aufgaben-API ab. Nach Freigabe erhalten Sie die `asset://`-ID aus der Medienliste und verwenden sie in `image_urls`, `image_with_roles[].url`, `video_urls` oder `audio_urls`.

## Aufgabenstatus und Ergebnisse

Fragen Sie die [Status-API](https://docs.apimart.ai/de/api-reference/tasks/status.md) ab. `pending` / `processing`: läuft; `completed`: erfolgreich; `failed`: fehlgeschlagen. Lesen Sie `data.result.videos[0].url[0]`; `url` ist ein Array.

```bash theme={null}
curl --request GET \
  --url 'https://api.apimart.ai/v1/tasks/task_example_seedance25flash' \
  --header 'Authorization: Bearer <token>'
```

```json theme={null}
{
  "code": 200,
  "data": {
    "id": "task_example_seedance25flash",
    "status": "completed",
    "progress": 100,
    "cost": 0.3104,
    "credits_cost": 3.104,
    "usage": {
      "completion_tokens": 38800
    },
    "result": {
      "videos": [
        {
          "url": [
            "https://example.com/generated-video.mp4"
          ],
          "last_frame_url": "https://example.com/generated-last-frame.png"
        }
      ]
    }
  }
}
```

| Feld | Bedeutung |
| - | - |
| `data.usage.completion_tokens` | Tokens für die endgültige Abrechnung. Kann nach Abschluss einige Sekunden fehlen; erneut abfragen. |
| `data.cost` | Tatsächlicher Betrag in USD nach Kontorabatten. Maßgeblich ist der Rückgabewert. |
| `data.credits_cost` | Tatsächlich abgezogene Credits. |
| `data.result.videos[].url` | Video-URL-Array; zeitnah herunterladen und speichern. |
| `data.result.videos[].last_frame_url` | Endbild-URL, nur nach Erfolg mit angefordertem `return_last_frame: true`. |
| `data.error.message` | Fehlergrund. Fehlgeschlagene Aufgaben haben `data.cost: 0`; die Reservierung wird erstattet. |

## Abrechnung

* Beim Senden wird anhand des Sekundenpreises der Auflösung reserviert. Mit Referenzvideo gilt der Eingabetarif für Ausgabedauer plus gesamte Referenzvideodauer.
* Normale Anfragen ohne `duration` reservieren 5 Ausgabesekunden. `duration: -1` oder `edit` ohne Dauer reserviert 30 Ausgabesekunden.
* Nach Erfolg: `data.usage.completion_tokens` ÷ 1,000,000 × passender Preis je Million Tokens, mit Kontorabatten. Die Differenz wird erstattet oder nachberechnet. Je nach Referenzvideo gilt `token` oder `token-input`; der endgültige Betrag steht in `data.cost`.
* Abgewiesene Anfragen verursachen keine Generierungskosten. Bei Generierungsfehlern wird die Reservierung erstattet. Preise und Rabatte siehe [Preisseite](https://apimart.ai/pricing).

## Häufige Fehler

| Situation | Maßnahme |
| - | - |
| HTTP 400: Auflösung nicht unterstützt | Nur `480p` / `720p`, nicht `1080p`. |
| HTTP 400: zu viele Referenzen | Maximal 10 Bilder insgesamt, 5 Videos und 5 Audioclips; auch Dauer prüfen. |
| HTTP 400: Entwurf nicht unterstützt | `draft` / `draft_task_id` entfernen. |
| HTTP 400: Typ, Dauer oder Verhältnis | Kombination von `omni_reference_task_type`, `duration`, `size` / `aspect_ratio` prüfen. |
| HTTP 400: `nsfw_content_detected` | Als Moderationsablehnung behandeln, `error.message` lesen und Inhalt ändern. |
| Modell nicht gefunden | `seedance-2-5-flash` statt `seedance-2.5-flash` verwenden. |
| Aufgabe `failed` | `data.error.message` lesen; Medien und Prompt auf den Typ abstimmen. Die Reservierung wird erstattet. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.