# Seedance 2.0 API Référence API complète des modèles de génération vidéo Seedance 2.0 de ByteDance. ## Variantes de modèles Cette API prend en charge six variantes : | Modèle | ID | Description | |-------|-----|-------------| | **Seedance 2.0 Text to Video** | `seedance-v2.0-text-to-video` | Génération vidéo de haute qualité à partir de texte | | **Seedance 2.0 Image to Video** | `seedance-v2.0-image-to-video` | Animation d'images avec contrôle du mouvement | | **Seedance 2.0 Reference to Video** | `seedance-v2.0-reference-to-video` | Génération vidéo guidée par une vidéo de référence | | **Seedance 2.0 Fast Text to Video** | `seedance-v2.0-fast-text-to-video` | Génération vidéo plus rapide à partir de texte | | **Seedance 2.0 Fast Image to Video** | `seedance-v2.0-fast-image-to-video` | Génération vidéo plus rapide à partir d'images | | **Seedance 2.0 Fast Reference to Video** | `seedance-v2.0-fast-reference-to-video` | Génération vidéo guidée par des références plus rapide | ## Comparaison rapide | Fonctionnalité | Modèles standard | Modèles Fast | |---------|-----------------|-------------| | Qualité | Qualité supérieure | Optimisés pour la vitesse | | Temps de traitement | 3-8 minutes | 1-4 minutes | | Plage de durée | 4-15 secondes | 4-15 secondes | | Résolutions disponibles | 480p, 720p, 1080p, 4k | 480p, 720p | | Médias de référence | Images, vidéos et audios pour Reference-to-Video | Images, vidéos et audios pour Fast Reference-to-Video | ### Formats d'image 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, équilibre entre qualité et vitesse | | `1080p` | Full HD, disponible pour tous les modèles Seedance 2.0 standard | | `4k` | Ultra HD, disponible pour tous les modèles Seedance 2.0 standard | ## Seedance 2.0 Texte vers vidéo ### 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-text-to-video"` | | `prompt` | string | Prompt de génération vidéo | | `duration` | integer | Durée vidéo en secondes entières (4-15), par pas de 1 | | `resolution` | string | Résolution de sortie : `"480p"`, `"720p"`, `"1080p"` ou `"4k"` | | `aspect_ratio` | string | Format d'image vidéo : `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` ou `"3:4"` | #### Facultatifs | Paramètre | Type | Description | |-----------|------|-------------| | `sound` | boolean | Indique si le son doit être généré. Par défaut : `true` ; sans effet sur le prix | ### 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-text-to-video', prompt: 'A golden retriever running through a sunlit meadow', duration: 6, resolution: '720p', aspect_ratio: '16:9' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Seedance 2.0 Image vers vidéo ### Paramètres de requête #### Obligatoires | Paramètre | Type | Description | |-----------|------|-------------| | `model_name` | string | Doit être `"seedance-v2.0-image-to-video"` | | `prompt` | string | Prompt de génération vidéo | | `duration` | integer | Durée vidéo en secondes entières (4-15), par pas de 1 | | `resolution` | string | Résolution de sortie : `"480p"`, `"720p"`, `"1080p"` ou `"4k"` | | `aspect_ratio` | string | Format d'image 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 de fin | | `sound` | boolean | Indique si le son doit être généré. Par défaut : `true` ; sans effet sur le prix | ### Exemple de requête ```javascript { model_name: 'seedance-v2.0-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' } ``` ## Seedance 2.0 Références vers vidéo ### Paramètres de requête #### Obligatoires | Paramètre | Type | Description | |-----------|------|-------------| | `model_name` | string | Doit être `"seedance-v2.0-reference-to-video"` | | `prompt` | string | Prompt de génération vidéo. Rédigez un prompt standard sans marqueurs, ou utilisez la fonction de référence @ (AT) avec `<<>>`, `<<>>` et `<<>>` pour référencer explicitement les éléments des tableaux de médias correspondants | | `duration` | integer | Durée vidéo en secondes entières (4-15), par pas de 1 | | `resolution` | string | Résolution de sortie : `"480p"`, `"720p"`, `"1080p"` ou `"4k"` | | `aspect_ratio` | string | Format d'image vidéo : `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` ou `"3:4"` | #### Médias de référence Envoyez 1-9 images. Les images ne peuvent être omises que si au moins une vidéo de référence est fournie. | 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 totale maximale de 15 secondes | | `audios` | string[] | Jusqu'à 3 URL d'audios de référence ; chaque extrait doit durer 2-15 secondes, pour un total maximal de 15 secondes ; WAV ou MP3, 15 MB maximum par extrait ; nécessite au moins une image ou une vidéo | #### Marqueurs de référence @ (AT) La fonction @ (AT) relie les médias de référence au prompt via des marqueurs numérotés `<<<...>>>`. La numérotation commence à `1` indépendamment pour chaque type de média et suit l'ordre du tableau correspondant : | Marqueur | Valeur référencée | |-------------|------------------| | `<<>>` | `images[0]` | | `<<>>` | `images[1]` | | `<<>>` | `videos[0]` | | `<<>>` | `audios[0]` | Par exemple, si la première image représente un personnage et la deuxième une scène, utilisez `<<>>` pour le personnage et `<<>>` pour la scène dans `prompt`. Chaque marqueur doit désigner un élément existant dans son tableau. #### Facultatifs | Paramètre | Type | Description | |-----------|------|-------------| | `sound` | boolean | Indique si un son synchronisé doit être généré. Par défaut : `true` | ### Exemple de requête ```javascript { model_name: 'seedance-v2.0-reference-to-video', prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere', duration: 8, resolution: '1080p', aspect_ratio: '16:9', sound: true, images: ['https://example.com/subject-reference.jpg'], videos: ['https://example.com/motion-reference.mp4'], audios: ['https://example.com/atmosphere-reference.mp3'] } ``` ### Exemple de requête Références vers vidéo avec @ (AT) ```javascript { model_name: 'seedance-v2.0-reference-to-video', prompt: 'Place the explorer from <<>> in the environment from <<>>, following the camera movement in <<>> and speaking with the reference voice from <<>>', duration: 8, resolution: '1080p', 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'] } ``` ## Variantes Fast Les variantes Fast privilégient la vitesse de traitement. Tous les modèles Fast prennent uniquement en charge les sorties `"480p"` et `"720p"`. Fast Texte vers vidéo et Fast Image vers vidéo suivent par ailleurs la structure des requêtes standard correspondantes, tandis que Fast Références vers vidéo applique les mêmes limites de médias de référence que le modèle standard. ### Exemple de requête Fast ```javascript { model_name: 'seedance-v2.0-fast-reference-to-video', prompt: 'Use image one for the subject, follow the movement from video one, and use audio one for the atmosphere', duration: 8, resolution: '720p', aspect_ratio: '9:16', sound: true, images: ['https://example.com/subject-reference.jpg'], videos: ['https://example.com/motion-reference.mp4'], audios: ['https://example.com/atmosphere-reference.mp3'] } ``` ### Exemple de requête Fast Références vers vidéo avec @ (AT) ```javascript { model_name: 'seedance-v2.0-fast-reference-to-video', prompt: 'Have the dancer from <<>> perform the movement from <<>> on the stage in <<>>, using the rhythm from <<>>', duration: 8, resolution: '720p', aspect_ratio: '9:16', sound: true, images: [ 'https://example.com/dancer-reference.jpg', 'https://example.com/stage-reference.jpg' ], videos: ['https://example.com/dance-movement-reference.mp4'], audios: ['https://example.com/rhythm-reference.mp3'] } ``` ### Paramètres Seedance 2.0 Fast Références vers vidéo #### Obligatoires | Paramètre | Type | Description | |-----------|------|-------------| | `model_name` | string | Doit être `"seedance-v2.0-fast-reference-to-video"` | | `prompt` | string | Prompt de génération vidéo. Rédigez un prompt standard sans marqueurs, ou utilisez la fonction de référence @ (AT) avec `<<>>`, `<<>>` et `<<>>` pour référencer explicitement les éléments des tableaux de médias correspondants | | `duration` | integer | Durée vidéo en secondes entières (4-15), par pas de 1 | | `resolution` | string | Résolution de sortie : `"480p"` ou `"720p"` | | `aspect_ratio` | string | Format d'image vidéo : `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` ou `"3:4"` | #### Médias de référence | 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 totale maximale de 15 secondes | | `audios` | string[] | Jusqu'à 3 URL d'audios de référence ; chaque extrait doit durer 2-15 secondes, pour un total maximal de 15 secondes ; WAV ou MP3, 15 MB maximum par extrait ; nécessite au moins une image ou une vidéo | La même convention de marqueurs commençant à 1 s'applique au modèle Fast Références vers vidéo. #### Facultatifs | Paramètre | Type | Description | |-----------|------|-------------| | `sound` | boolean | Indique si un son synchronisé doit être généré. Par défaut : `true` | ## Limites des médias Ces limites s'appliquent aux images de début, de fin 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 de 300-6000 px chacune ; rapport largeur/hauteur de 0.4-2.5 | | Vidéos | MP4, MOV | 200 MB maximum chacune ; largeur et hauteur de 300-6000 px chacune ; rapport largeur/hauteur de 0.4-2.5 ; fréquence d'images de 24-60 FPS | | Audio | WAV, MP3 | 15 MB maximum par fichier | | Corps de la requête | — | 64 MB maximum | Les audios et vidéos de référence ont chacun une limite distincte de durée totale 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` reste obligatoire. Le son est activé par défaut (`true`) ; ni ce réglage ni l'audio de référence ne modifient le prix. Références vers vidéo nécessite au moins une image ou une vidéo ; les requêtes uniquement audio ne sont pas prises en charge. L'ajout de 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 d'interrogation Interrogez `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 **Modèles standard** : 3-8 minutes selon la durée et la résolution. **Modèles Fast** : 1-4 minutes pour la plupart des configurations. Vérifiez l'état toutes les 5-10 secondes. ## Bonnes pratiques 1. **Choisir la bonne variante** : utilisez les modèles Fast pour les essais et les modèles standard pour le résultat final 2. **Décrire clairement le mouvement** : incluez des descriptions précises des mouvements dans les prompts 3. **Choix de la résolution** : tous les modèles Seedance 2.0 standard prennent en charge `480p`, `720p`, `1080p` et `4k` ; tous les modèles Fast prennent uniquement en charge `480p` et `720p` 4. **Ordre des références** : ordonnez délibérément `images`, `videos` et `audios`, puis référencez-les de manière cohérente dans le prompt 5. **Requêtes uniquement vidéo** : utilisez un tableau `images` vide uniquement si au moins une vidéo de référence est fournie 6. **Durée des médias** : maintenez chaque audio et vidéo de référence entre 2 et 15 secondes 7. **Utilisation du son** : omettez `sound` pour utiliser sa valeur par défaut `true`, ou définissez-le sur `false` pour désactiver le son généré