# Seedance 2.0 Mini API

Référence API complète des modèles de génération vidéo Seedance 2.0 Mini de ByteDance.

## Variantes du modèle

Cette API prend en charge trois variantes :

| Modèle | ID | Description |
|-------|-----|-------------|
| **Seedance 2.0 Mini Text to Video** | `seedance-v2.0-mini-text-to-video` | Génération vidéo économique à partir de texte |
| **Seedance 2.0 Mini Image to Video** | `seedance-v2.0-mini-image-to-video` | Animation d’image économique avec contrôle des mouvements |
| **Seedance 2.0 Mini Reference to Video** | `seedance-v2.0-mini-reference-to-video` | Génération vidéo économique guidée par des images, vidéos et fichiers audio de référence |

## Comparaison rapide

| Fonctionnalité | Valeur |
|---------|-------|
| Durées disponibles | 4 à 15 secondes |
| Résolutions disponibles | 480p, 720p |
| Rapports d’aspect disponibles | 21:9, 16:9, 9:16, 1:1, 4:3, 3:4 |
| Prise en charge audio | Oui (activée par défaut) |
| Médias de référence | Images, vidéos et fichiers audio pour la génération à partir de références |
| Contrôle de la graine | Aucun modèle Seedance 2.0 Mini ne le prend en charge |

### Rapports d’aspect pris en charge

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

### Résolutions disponibles

| Résolution | Description |
|------------|-------------|
| `480p` | Définition standard, traitement plus rapide |
| `720p` | Haute définition |

## Seedance 2.0 Mini Text to Video

### Point de terminaison

```
POST /api/v1/video/task
```

### Paramètres de requête

#### Obligatoires

| Paramètre | Type | Description |
|-----------|------|-------------|
| `model_name` | string | Doit être `"seedance-v2.0-mini-text-to-video"` |
| `prompt` | string | Invite de génération vidéo |
| `duration` | integer | Durée de la vidéo en secondes entières (4 à 15), par pas de 1 |
| `resolution` | string | Résolution de sortie : `"480p"` ou `"720p"` |
| `aspect_ratio` | string | Rapport d’aspect de la vidéo : `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` ou `"3:4"` |

#### Facultatifs

| Paramètre | Type | Description |
|-----------|------|-------------|
| `sound` | boolean | Générer ou non des sons ambiants (par défaut : `true`) |

### Exemple de requête

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

### Paramètres de requête

#### Obligatoires

| Paramètre | Type | Description |
|-----------|------|-------------|
| `model_name` | string | Doit être `"seedance-v2.0-mini-image-to-video"` |
| `prompt` | string | Invite de génération vidéo |
| `duration` | integer | Durée de la vidéo en secondes entières (4 à 15), par pas de 1 |
| `resolution` | string | Résolution de sortie : `"480p"` ou `"720p"` |
| `aspect_ratio` | string | Rapport d’aspect de la vidéo : `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` ou `"3:4"` |
| `image_url` | string | Première image de la vidéo |

#### Facultatifs

| Paramètre | Type | Description |
|-----------|------|-------------|
| `image_end_url` | string | URL facultative de l’image finale |
| `sound` | boolean | Générer ou non des sons ambiants (par défaut : `true`) |

### Exemple de requête

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

### Paramètres de requête

#### Obligatoires

| Paramètre | Type | Description |
|-----------|------|-------------|
| `model_name` | string | Doit être `"seedance-v2.0-mini-reference-to-video"` |
| `prompt` | string | Invite de génération vidéo. Rédigez une invite classique sans marqueurs, ou utilisez la fonction de référence @ (AT) avec `<<<image_N>>>`, `<<<video_N>>>` et `<<<audio_N>>>` pour désigner explicitement des éléments des tableaux de médias correspondants |
| `duration` | integer | Durée de la vidéo en secondes entières (4 à 15), par pas de 1 |
| `resolution` | string | Résolution de sortie : `"480p"` ou `"720p"` |
| `aspect_ratio` | string | Rapport d’aspect de la vidéo : `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` ou `"3:4"` |

#### Médias de référence

Chaque requête doit inclure au moins une image ou une vidéo. Fournissez 1 à 9 images si vous utilisez des références d’images. Le tableau `images` ne peut être omis ou vide que si le tableau `videos` contient au moins une vidéo de référence. Les requêtes contenant uniquement de l’audio ne sont pas prises en charge.

| Paramètre | Type | Description |
|-----------|------|-------------|
| `images` | string[] | 1 à 9 URL d’images de référence, ou un tableau vide si `videos` n’est pas vide |
| `videos` | string[] | Jusqu’à 3 URL de vidéos de référence ; chaque vidéo doit durer 2 à 15 secondes, pour une durée cumulée maximale de 15 secondes |
| `audios` | string[] | Jusqu’à 3 URL audio de référence ; chaque extrait doit durer 2 à 15 secondes, pour une durée cumulée maximale de 15 secondes ; WAV ou MP3, au plus 15 MB par extrait ; nécessite au moins une image ou une vidéo |

#### Marqueurs de référence @ (AT)

La fonction de référence @ (AT) relie les médias à l’invite à l’aide de marqueurs numérotés `<<<...>>>`. La numérotation commence à `1` séparément pour chaque type de média et suit l’ordre du tableau correspondant :

| Marqueur | Valeur référencée |
|-------------|------------------|
| `<<<image_1>>>` | `images[0]` |
| `<<<image_2>>>` | `images[1]` |
| `<<<video_1>>>` | `videos[0]` |
| `<<<audio_1>>>` | `audios[0]` |

Chaque marqueur doit désigner un élément présent dans le tableau correspondant.

#### Facultatifs

| Paramètre | Type | Description |
|-----------|------|-------------|
| `sound` | boolean | Générer ou non un son synchronisé. Valeur par défaut : `true` |

### Tarification des vidéos de référence

Seedance V2.0 Mini Reference-to-Video utilise la même tarification à la seconde selon la résolution que les autres variantes de référence Seedance 2.0. Lorsque le tableau `videos` contient au moins une vidéo de référence, le coût total de génération est multiplié par 2. Ce multiplicateur ne s’applique qu’une fois, quels que soient le nombre et la durée des vidéos de référence envoyées.

### Exemple de requête

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

## Limites des médias

Ces limites s’appliquent aux images initiales, aux images finales et aux médias de référence des modèles de cette page.

| Média | Formats | Limites |
|-------|---------|--------|
| Images | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | Chaque image doit faire moins de 30 MB ; largeur et hauteur comprises chacune entre 300 et 6000 px ; rapport largeur/hauteur compris entre 0,4 et 2,5 |
| Vidéos | MP4, MOV | Au plus 200 MB chacune ; largeur et hauteur comprises chacune entre 300 et 6000 px ; rapport largeur/hauteur compris entre 0,4 et 2,5 ; fréquence d’images comprise entre 24 et 60 FPS |
| Audio | WAV, MP3 | Au plus 15 MB par fichier |
| Corps de requête | — | Au plus 64 MB |

Les fichiers audio et les vidéos de référence ont chacun une limite distincte de durée cumulée de 15 secondes. Leurs nombres sont indépendants : jusqu’à 9 images, 3 vidéos et 3 extraits audio. Ajouter des vidéos ne réduit pas le nombre d’images autorisé.

Tous les modèles utilisent `720p` par défaut, mais `resolution` doit toujours être fourni. Le commutateur de son vaut `true` par défaut ; ni ce commutateur ni l’audio de référence ne modifient le prix. La génération à partir de références exige au moins une image ou une vidéo ; les requêtes uniquement audio ne sont pas prises en charge. Envoyer des vidéos de référence double le coût de génération, quels que soient leur nombre et leur durée.

## Format de réponse

### Réponse initiale

Tous les modèles renvoient un `task_id` pour l’interrogation périodique :

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

### Réponse à l’interrogation périodique

Interrogez périodiquement `GET /api/v1/video/{taskId}` pour vérifier l’état :

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

### Valeurs d’état

- `submitted` : Tâche acceptée, en attente de traitement
- `processing` : Génération vidéo en cours
- `succeed` : Génération vidéo terminée
- `failed` : Échec de la génération vidéo

## Temps de traitement

Le traitement prend généralement 2 à 6 minutes selon la durée et la résolution.

Interrogez l’état toutes les 5 à 10 secondes.

## Bonnes pratiques

1. **Décrire clairement les mouvements** : Incluez des descriptions précises des mouvements dans les invites
2. **Choisir la résolution** : Utilisez `480p` pour un traitement plus rapide et `720p` pour une meilleure qualité
3. **Enrichir l’audio** : Gardez `sound` activé pour des vidéos plus immersives
4. **Image vers vidéo** : Fournissez une première image nette via `image_url` ; utilisez `image_end_url` pour contrôler les images de début et de fin
5. **Médias de référence** : Utilisez des images, vidéos et fichiers audio compatibles, et incluez au moins une image ou une vidéo
6. **Tarification des vidéos de référence** : Toute requête de génération à partir de références contenant au moins une vidéo de référence est facturée au double, quels que soient le nombre et la durée des vidéos envoyées
7. **Paramètre de graine** : N’envoyez pas `seed` ; les modèles Seedance 2.0 Mini ne le prennent pas en charge