# Seedance 2.5 Flash API Documentation complète de l’API des modèles de génération vidéo Seedance 2.5 Flash de ByteDance. ## Variantes du modèle Cette API prend en charge trois variantes du modèle : | Modèle | Identifiant | Description | |-------|----|-------------| | **Seedance 2.5 Flash Text to Video** | `seedance-v2.5-flash-text-to-video` | Génération de vidéos de haute qualité à partir de texte | | **Seedance 2.5 Flash Image to Video** | `seedance-v2.5-flash-image-to-video` | Génération vidéo à partir de la première image ou des première et dernière images | | **Seedance 2.5 Flash Reference to Video** | `seedance-v2.5-flash-reference-to-video` | Génération vidéo guidée par des images, des vidéos et des extraits audio de référence | ## Comparaison rapide | Fonctionnalité | Texte vers vidéo | Image vers vidéo | Références vers vidéo | |---------|---------------|----------------|--------------------| | Durée | 4 à 30 secondes | 4 à 30 secondes | 4 à 30 secondes | | Résolutions disponibles | 480p, 720p | 480p, 720p | 480p, 720p | | Rapport largeur/hauteur | Facultatif (par défaut : 16:9) | Non pris en charge | Facultatif (par défaut : 16:9) | | Médias requis | Aucun | Première image | Aucun | | Médias facultatifs | Aucun | Dernière image | Images, vidéos et extraits audio | ### Rapports largeur/hauteur pris en charge Les variantes de génération à partir de texte et de références acceptent les rapports suivants : `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` La variante de génération à partir d’une image ne prend pas en charge le paramètre `aspect_ratio`. ### Résolutions disponibles | Résolution | Description | |------------|-------------| | `480p` | Définition standard | | `720p` | Haute définition | ## Seedance 2.5 Flash Text to Video ### Point de terminaison ``` POST /api/v1/video/task ``` ### Paramètres de la requête #### Paramètres obligatoires | Paramètre | Type | Description | |-----------|------|-------------| | `model_name` | string | Doit valoir `"seedance-v2.5-flash-text-to-video"` | | `prompt` | string | Instruction de génération vidéo de 5 000 caractères maximum | | `resolution` | string | Résolution de sortie : `"480p"` ou `"720p"`. Aucune valeur par défaut | | `duration` | integer | Durée de la vidéo en secondes entières, de 4 à 30 par pas de 1. Aucune valeur par défaut | #### Paramètres facultatifs | Paramètre | Type | Description | |-----------|------|-------------| | `aspect_ratio` | string | Rapport largeur/hauteur de la vidéo : `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` ou `"3:4"`. Valeur par défaut : `"16:9"` | | `sound` | boolean | Indique s’il faut générer du son. La valeur par défaut est `true`. Avec `false`, la vidéo est muette | ### 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.5-flash-text-to-video', prompt: 'A golden retriever running through a sunlit meadow', resolution: '720p', duration: 8, aspect_ratio: '16:9', sound: true }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Seedance 2.5 Flash Image to Video ### Paramètres de la requête #### Paramètres obligatoires | Paramètre | Type | Description | |-----------|------|-------------| | `model_name` | string | Doit valoir `"seedance-v2.5-flash-image-to-video"` | | `prompt` | string | Instruction de génération vidéo de 5 000 caractères maximum | | `resolution` | string | Résolution de sortie : `"480p"` ou `"720p"`. Aucune valeur par défaut | | `duration` | integer | Durée de la vidéo en secondes entières, de 4 à 30 par pas de 1. Aucune valeur par défaut | | `image_url` | string | URL de la première image. Le rapport largeur/hauteur de la vidéo reprend celui de cette image. Voir « Limites des médias » ci-dessous | #### Paramètres facultatifs | Paramètre | Type | Description | |-----------|------|-------------| | `image_end_url` | string | URL facultative de la dernière image. Il est recommandé d’utiliser le même rapport largeur/hauteur que pour la première image. Voir « Limites des médias » ci-dessous | | `sound` | boolean | Indique s’il faut générer du son. La valeur par défaut est `true`. Avec `false`, la vidéo est muette | > N’incluez pas `aspect_ratio` dans les requêtes de génération vidéo à partir d’une image. Ce modèle ne prend pas en charge ce paramètre. ### Exemple de requête ```javascript { model_name: 'seedance-v2.5-flash-image-to-video', image_url: 'https://example.com/first-frame.jpg', image_end_url: 'https://example.com/last-frame.jpg', prompt: 'Camera slowly pulls back to reveal the full landscape', resolution: '720p', duration: 8, sound: true } ``` ## Seedance 2.5 Flash Reference to Video ### Paramètres de la requête #### Paramètres obligatoires | Paramètre | Type | Description | |-----------|------|-------------| | `model_name` | string | Doit valoir `"seedance-v2.5-flash-reference-to-video"` | | `prompt` | string | Instruction de génération vidéo de 5 000 caractères maximum. Rédigez une instruction classique sans marqueurs, ou utilisez la fonction de référence @ (AT) avec `<<>>`, `<<>>` et `<<>>` pour désigner explicitement des éléments des tableaux de médias correspondants | | `resolution` | string | Résolution de sortie : `"480p"` ou `"720p"`. Aucune valeur par défaut | | `duration` | integer | Durée de la vidéo en secondes entières, de 4 à 30 par pas de 1. Aucune valeur par défaut | #### Médias de référence Tous les médias de référence sont facultatifs. Les requêtes peuvent contenir uniquement des images, des vidéos ou des extraits audio, ou aucun média de référence. Pour générer une vidéo sans référence, la variante Text to Video est recommandée. | Paramètre | Type | Description | |-----------|------|-------------| | `images` | string[] | De 0 à 10 URL d’images de référence, référencées dans l’ordre du tableau. Voir « Limites des médias » ci-dessous | | `videos` | string[] | De 0 à 5 URL de vidéos de référence au format MP4 ou MOV. Chaque vidéo doit durer de 2 à 30 secondes, pour un total de 30 secondes maximum. Voir « Limites des médias » ci-dessous. Pour la facturation, la durée totale des vidéos de référence est arrondie à la seconde la plus proche (les demi-secondes sont arrondies à la seconde supérieure), puis ajoutée à la durée de la vidéo générée | | `audios` | string[] | De 0 à 5 URL d’extraits audio de référence au format WAV ou MP3. Chaque extrait doit durer de 2 à 30 secondes et peser au maximum 15 Mo. La durée totale ne doit pas dépasser 30 secondes | #### Marqueurs de référence @ (AT) La fonction de référence @ (AT) associe les médias de référence à l’instruction au moyen de marqueurs numérotés `<<<...>>>`. Pour chaque type de média, la numérotation commence à `1` 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 seconde un décor, utilisez `<<>>` pour le personnage et `<<>>` pour le décor dans `prompt`. Chaque marqueur doit désigner un élément présent dans le tableau correspondant. #### Paramètres facultatifs | Paramètre | Type | Description | |-----------|------|-------------| | `aspect_ratio` | string | Rapport largeur/hauteur de la vidéo : `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` ou `"3:4"`. Valeur par défaut : `"16:9"` | | `sound` | boolean | Indique s’il faut générer du son. La valeur par défaut est `true`. Avec `false`, la vidéo est muette | ### Exemple de requête ```javascript { model_name: 'seedance-v2.5-flash-reference-to-video', prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere', resolution: '720p', duration: 8, 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 de génération vidéo avec des références @ (AT) ```javascript { model_name: 'seedance-v2.5-flash-reference-to-video', prompt: 'Place the explorer from <<>> in the environment from <<>>, following the camera movement in <<>> and speaking with the reference voice from <<>>', resolution: '720p', duration: 10, aspect_ratio: '16:9', sound: true, images: [ 'https://example.com/explorer-reference.jpg', 'https://example.com/environment-reference.png' ], videos: ['https://example.com/camera-movement-reference.mp4'], audios: ['https://example.com/voice-reference.mp3'] } ``` ## Limites des médias Ces limites s’appliquent aux premières et dernières images ainsi qu’aux médias de référence des modèles présentés sur cette page. | Média | Formats | Limites | |-------|---------|--------| | Images | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | Moins de 30 Mo par image. La largeur et la hauteur doivent chacune être comprises entre 300 et 6 000 px. Le rapport largeur/hauteur doit être compris entre 0,4 et 2,5 | | Vidéos | MP4, MOV | Au maximum 200 Mo par vidéo. La largeur et la hauteur doivent chacune être comprises entre 300 et 6 000 px, le rapport largeur/hauteur entre 0,4 et 2,5, la cadence entre 24 et 60 images/s et le nombre total de pixels entre 407 696 et 8 295 044 | | Audio | WAV, MP3 | Au maximum 15 Mo par fichier | La durée cumulée des extraits audio de référence et celle des vidéos de référence sont limitées séparément à 30 secondes chacune. Les quantités maximales sont indépendantes : 10 images, 5 vidéos et 5 extraits audio. Tous les modèles exigent `resolution` et `duration`, sans valeur par défaut. Les variantes de génération à partir de texte et de références utilisent `16:9` par défaut si `aspect_ratio` est omis. Le son est activé par défaut (`true`). Utilisez `false` pour obtenir une vidéo muette. ## Format de la réponse ### Réponse initiale Tous les modèles renvoient un `task_id` qui permet d’interroger l’état de la tâche : ```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 aux requêtes de suivi Interrogez `GET /api/v1/video/{taskId}` pour vérifier l’état de la tâche : ```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 et 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 temps de traitement varie selon la durée, la résolution et l’état de la file d’attente. Vérifiez l’état de la tâche toutes les 5 à 10 secondes. ## Bonnes pratiques 1. **Paramètres obligatoires** : fournissez toujours `prompt`, `resolution` et `duration`. Pour les variantes de génération à partir de texte et de références, `aspect_ratio` est facultatif et vaut `16:9` par défaut 2. **Rapport largeur/hauteur pour la génération à partir d’une image** : n’envoyez pas `aspect_ratio` dans ces requêtes 3. **Vidéos de référence** : les vidéos sont facultatives. Leur durée individuelle et leur durée cumulée doivent respecter les limites indiquées 4. **Images de référence** : les images sont facultatives, indépendamment des vidéos et des extraits audio. Vous pouvez fournir jusqu’à 10 URL d’images dans les formats pris en charge 5. **Audio de référence** : chaque extrait doit durer de 2 à 30 secondes et peser au maximum 15 Mo, pour une durée cumulée de 30 secondes maximum 6. **Ordre des références** : placez les éléments de `images`, `videos` et `audios` dans l’ordre souhaité et respectez cet ordre lorsque vous les mentionnez dans l’instruction 7. **Son** : omettez `sound` pour utiliser sa valeur par défaut `true`, ou réglez-le sur `false` pour désactiver la génération du son