> ## 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.

# Génération vidéo Seedance 2.5 Flash

> Créez des vidéos 480p / 720p de 30 secondes maximum à partir de texte, de références multimodales, par édition, extension ou images de début et de fin.

```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"
    }
  ]
}
```

Envoyez la requête avec `POST /v1/videos/generations`, récupérez `data[0].task_id`, puis interrogez `GET /v1/tasks/{task_id}`.

**Authorization** `string` *required*

Utilisez `Authorization: Bearer <token>`, où `<token>` est votre clé API APIMart.

## Paramètres de requête

**model** `string` *required*

Utilisez `seedance-2-5-flash`. L’alias `doubao-seedance-2-5-flash` est également accepté. Le nom avec un point `seedance-2.5-flash` n’est pas pris en charge.

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

Indique s'il faut modérer le contenu avant d'envoyer la tâche vidéo.

* `true` : vérifier les prompts et les images d'entrée avec `omni-moderation-latest`
* `false` ou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)

Un contenu signalé renvoie HTTP 400 (`nsfw_content_detected`) sans créer de tâche ni facturer la génération. Les vidéos et sons de référence ne sont pas examinés. La requête peut continuer si le service de modération échoue.

**prompt** `string` *required*

Prompt obligatoire. Référencez les médias avec `@图片1` / `@视频1` / `@音频1` ; les indices commencent à 1 et suivent l’ordre de chaque tableau de médias.

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

Uniquement `480p` / `720p`, avec `720p` par défaut. `1080p`, `2k`, `4k` et les autres valeurs renvoient HTTP 400 dès l’envoi.

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

Valeurs : `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive` (par défaut). Alias : `aspect_ratio`. Les tâches avec images de début/fin, d’édition et d’extension exigent `adaptive`.

**duration** `integer`

Secondes entières `4`–`30` ; par défaut `5` pour une requête ordinaire. `-1` active la durée automatique. Le mode explicite `edit` accepte uniquement `-1` ou l’omission, traitée comme `-1` ; la durée suit la vidéo source. La durée automatique réserve 30 secondes, puis le coût est régularisé selon les tokens utilisés.

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

Générer du son, `true` par défaut. Alias : `audio`. Ce réglage de sortie est distinct des références audio `audio_urls`.

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

Ajouter un filigrane de génération par IA, `false` par défaut.

**seed** `integer`

Graine aléatoire facultative. Une même graine ne garantit pas un résultat identique.

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

Conteneur de sortie : `mp4` (par défaut) ou `mov`.

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

`auto` (par défaut), `reference`, `edit` ou `extend`, uniquement avec des médias de référence. Un type explicite déclenche les contrôles à l’envoi décrits ci-dessous.

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

Tableau d’images, toutes traitées comme `reference_image`. Maximum 10 images au total avec `image_with_roles`. Utilisez ce dernier pour les images de début et de fin.

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

Chaque élément contient `url` et `role`. Rôles : `reference_image`, `first_frame` (1 maximum), `last_frame` (1 maximum, avec une image de début). Maximum 10 images avec `image_urls` ; évitez les rôles contradictoires. Avec `video_urls` / `audio_urls`, les images de début/fin deviennent des images de référence multimodales.

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

Maximum 5 vidéos, de 2–30 secondes chacune, 30 secondes au total. Une vidéo source à éditer doit durer 4–30 secondes.

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

Maximum 5 extraits audio, de 2–30 secondes chacun, 30 secondes au total. Les références audio seules sont autorisées, sans image ni vidéo.

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

Avec `true`, une image de la dernière frame est renvoyée après réussite dans `data.result.videos[].last_frame_url`.

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

Autoriser le modèle à rechercher sur le Web si nécessaire, `false` par défaut.

**tools** `object[]`

Liste facultative d’outils, par exemple `[{"type":"web_search"}]` pour la recherche Web.

> [!WARNING]
>
> `draft` / `draft_task_id` ne sont pas pris en charge : retirez-les de la requête, sinon HTTP 400 est renvoyé. Utilisez [Seedance 2.5](https://docs.apimart.ai/fr/api-reference/videos/seedance-2-5/generation.md) pour le mode brouillon.

## Exigences des médias

Utilisez des URL `http(s)` accessibles publiquement ou des identifiants `asset://` approuvés. La résolution de sortie et les limites de pixels des vidéos d’entrée sont contrôlées séparément.

| Média | Limites |
| - | - |
| Images | ≤10 au total dans les deux champs ; JPEG / PNG / WebP / BMP / TIFF / GIF / HEIC / HEIF ; largeur et hauteur chacune de 300–6000 px ; ratio 0.4–2.5 ; `<30 MB` chacune. |
| Vidéos | ≤5 ; MP4 / MOV, vidéo H.264 / H.265 et audio AAC / MP3 ; 2–30 secondes chacune, ≤30 secondes au total ; ≤200 MB chacune ; largeur et hauteur de 300–6000 px, ratio 0.4–2.5, largeur × hauteur de 409,600–8,295,044 pixels, 24–60 FPS. |
| Audio | ≤5 ; WAV / MP3 ; 2–30 secondes chacun, ≤30 secondes au total ; ≤15 MB chacun. |

## Types de tâches et contraintes

| Mode | Utilisation et contraintes |
| - | - |
| Texte vers vidéo | Fournissez `prompt` sans média de référence ; omettez `omni_reference_task_type`. |
| Références vers vidéo | Fournissez des références ; `reference` est facultatif. Les limites normales de durée et de ratio s’appliquent. |
| Images de début/fin | Utilisez `image_with_roles` ; `size` / `aspect_ratio` doit être `adaptive`. |
| Édition vidéo | `edit` ; au moins 1 vidéo source de 4–30 secondes ; ratio `adaptive`, `duration` à `-1` ou omis. |
| Extension vidéo | `extend` ; au moins 1 vidéo de référence ; ratio `adaptive`. |

Les contraintes d’un type explicite sont contrôlées avant création et facturation : un échec renvoie HTTP 400. Avec `auto`, le type est déduit des médias et du prompt, et peut échouer pendant la génération. Même un type explicite peut produire `InvalidParameter.TaskTypeMismatch` s’il ne correspond pas au prompt.

## Exemples de requêtes

### Références multimodales

```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"
}
```

### Images de début et de fin

```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
}
```

### Édition vidéo

```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"
}
```

### Extension vidéo

```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
}
```

## Ressources privées

Faites approuver les images ou vidéos contenant des visages réels dans la bibliothèque avant d’utiliser `asset://`. Le champ `model` de l’import doit aussi être `seedance-2-5-flash`. Consultez l’[API de bibliothèque](https://docs.apimart.ai/fr/api-reference/videos/seedance-2-0/private-avatar.md) et utilisez le nom Flash ci-dessous.

```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"
    }
  ]
}'
```

Interrogez la tâche de validation avec l’API unifiée. Après approbation, obtenez l’identifiant `asset://` dans la liste des ressources, puis utilisez-le dans `image_urls`, `image_with_roles[].url`, `video_urls` ou `audio_urls`.

## État et résultats

Interrogez l’[API d’état des tâches](https://docs.apimart.ai/fr/api-reference/tasks/status.md). `pending` / `processing` : en cours ; `completed` : réussite ; `failed` : échec. Lisez `data.result.videos[0].url[0]` : `url` est un tableau.

```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"
        }
      ]
    }
  }
}
```

| Champ | Signification |
| - | - |
| `data.usage.completion_tokens` | Tokens de régularisation finale. Peut être absent pendant quelques secondes après la fin ; interrogez à nouveau. |
| `data.cost` | Montant réellement facturé en USD, après remises du compte. Utilisez la valeur retournée. |
| `data.credits_cost` | Crédits réellement débités. |
| `data.result.videos[].url` | Tableau d’URL vidéo ; téléchargez et sauvegardez rapidement. |
| `data.result.videos[].last_frame_url` | URL de dernière frame, uniquement après réussite avec `return_last_frame: true`. |
| `data.error.message` | Motif d’échec. En cas d’échec, `data.cost` vaut 0 et le montant réservé est remboursé. |

## Facturation

* À l’envoi, un montant est réservé au tarif par seconde de la résolution. Avec une vidéo de référence, le palier avec entrée additionne durée de sortie et durée totale des vidéos de référence.
* Sans `duration`, une requête ordinaire réserve 5 secondes de sortie. `duration: -1`, ou `edit` sans durée, réserve 30 secondes de sortie.
* Après réussite : `data.usage.completion_tokens` ÷ 1,000,000 × tarif applicable par million de tokens, puis remises du compte. La différence est remboursée ou débitée. La présence d’une référence vidéo détermine le palier `token` ou `token-input`. Le montant final est `data.cost`.
* Un envoi rejeté n’est pas facturé pour la génération. Une génération échouée rembourse le montant réservé. Voir la [page des tarifs](https://apimart.ai/pricing).

## Erreurs courantes

| Situation | Action |
| - | - |
| HTTP 400 : résolution non prise en charge | Utilisez `480p` / `720p`, pas `1080p`. |
| HTTP 400 : trop de références | Maximum 10 images au total, 5 vidéos et 5 extraits audio ; vérifiez aussi les durées. |
| HTTP 400 : brouillon non pris en charge | Retirez `draft` / `draft_task_id`. |
| HTTP 400 : type, durée ou ratio | Vérifiez `omni_reference_task_type`, `duration`, `size` / `aspect_ratio`. |
| HTTP 400 : `nsfw_content_detected` | Traitez comme un refus de modération ; lisez `error.message` et modifiez le contenu. |
| Modèle introuvable | Utilisez `seedance-2-5-flash`, pas `seedance-2.5-flash`. |
| Tâche `failed` | Lisez `data.error.message` et adaptez médias et prompt au type de tâche. Le montant réservé est remboursé. |


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