> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Seedance 2.5 Flash Guide complet des paramètres > Référence complète des paramètres de Seedance 2.5 Flash. Sélectionnez un modèle de ce dossier avec `model`. Les champs obligatoires, les entrées et la facturation sont détaillés pour chaque mode. **Limite du mode brouillon :** Seedance 2.5 Flash ne prend en charge ni `draft: true` ni la conversion d’un brouillon en vidéo finale. **Recherche web en Text-to-Video :** `model_params.web_search: true` et `content_filter: false` sont incompatibles ; les envoyer ensemble renvoie une erreur de paramètre 400. Conservez `content_filter: true` (valeur par défaut) pour la recherche web. | ID du modèle | Mode | Champs obligatoires (hors model) | |---|---|---| | `seedance-2.5-flash-text-to-video` | Text-to-Video | `prompt` | | `seedance-2.5-flash-image-to-video` | Image-to-Video | `prompt`, `image_urls` | | `seedance-2.5-flash-reference-to-video` | Reference-to-Video | `prompt` | | `seedance-2.5-flash-video-edit` | Video Edit | `prompt`, `video_urls` | | `seedance-2.5-flash-video-extend` | Video Extend | `prompt`, `video_urls` | ### Text-to-Video - Generation de videos a partir de prompts textuels, avec recherche web pour ameliorer l'actualite ### Image-to-Video - Entrez 1 image pour generer une video a partir de la premiere image, entrez 2 images pour generer une video avec images de debut et de fin, le modele determine automatiquement ### Reference-to-Video - Générez une vidéo à partir d’un prompt, avec des images (0–10), vidéos (0–5) et segments audio (0–5) de référence facultatifs. Toutes les références peuvent être omises ; une référence audio seule est également acceptée. - Adapte a la creation de nouvelles videos : les images, videos et audios servent de reference de style, de sujet, de mouvement de camera et de musique - **Pour reecrire ou prolonger une video existante, utilisez [Video Edit](/fr/api-manual/video-series/seedance/seedance-2.5-flash/seedance-2.5-flash-video-edit) / [Video Extend](/fr/api-manual/video-series/seedance/seedance-2.5-flash/seedance-2.5-flash-video-extend)** : des que le prompt de ce modele exprime une intention d'edition ou d'extension, les parametres sont valides comme ceux d'une tache d'edition / extension : la requete est acceptee sans erreur et la tache echoue seulement pendant la generation ### Video Edit - Edition d'une video d'entree : remplacer des sujets, ajouter ou supprimer des objets, restyliser ou repeindre des zones - Décrivez directement la modification dans le prompt, par exemple : "Supprimer tous les passants de @video1 et ne garder que le personnage principal" - Fournissez la video a editer (obligatoire) + des images de reference facultatives (0–10) + des videos de reference (5 au maximum au total) + de l'audio de reference (0–5) ### Video Extend - Prolonge une video d'entree vers l'avant ou vers l'arriere - Le prompt doit exprimer l'intention d'extension (par exemple "Prolonger @video1 vers l'arriere, le personnage sort du cadre") - Fournissez la video a prolonger (obligatoire) + des images de reference facultatives (0–10) + des videos de reference (5 au maximum au total) + de l'audio de reference (0–5) - **Prend desormais en charge les contenus humains realistes generes par IA (AIGC)** - Mode de traitement asynchrone, utilisez l'ID de tache retourne pour [consulter le statut](/fr/api-manual/task-management/get-task-detail) - Le lien de la video generee est valide pendant 24 heures, veuillez le sauvegarder rapidement ## OpenAPI ````yaml fr/api-manual/video-series/seedance/seedance-2.5-flash/seedance-2.5-flash-overview.json POST /v1/videos/generations openapi: 3.1.0 info: title: Seedance 2.5 Flash Guide complet des paramètres description: >- Référence unifiée des paramètres des 5 modèles de ce dossier Seedance 2.5 Flash. Choisissez le mode avec model ; les champs requis et les limites sont détaillés ci-dessous. license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Production security: - bearerAuth: [] tags: - name: Generation video description: Interfaces de generation video par IA paths: /v1/videos/generations: post: tags: - Generation video summary: Seedance 2.5 Flash Guide complet des paramètres description: >- Référence complète des paramètres de Seedance 2.5 Flash. Sélectionnez un modèle de ce dossier avec `model`. Les champs obligatoires, les entrées et la facturation sont détaillés pour chaque mode. **Limite du mode brouillon :** Seedance 2.5 Flash ne prend en charge ni `draft: true` ni la conversion d’un brouillon en vidéo finale. **Recherche web en Text-to-Video :** `model_params.web_search: true` et `content_filter: false` sont incompatibles ; les envoyer ensemble renvoie une erreur de paramètre 400. Conservez `content_filter: true` (valeur par défaut) pour la recherche web. | ID du modèle | Mode | Champs obligatoires (hors model) | |---|---|---| | `seedance-2.5-flash-text-to-video` | Text-to-Video | `prompt` | | `seedance-2.5-flash-image-to-video` | Image-to-Video | `prompt`, `image_urls` | | `seedance-2.5-flash-reference-to-video` | Reference-to-Video | `prompt` | | `seedance-2.5-flash-video-edit` | Video Edit | `prompt`, `video_urls` | | `seedance-2.5-flash-video-extend` | Video Extend | `prompt`, `video_urls` | ### Text-to-Video - Generation de videos a partir de prompts textuels, avec recherche web pour ameliorer l'actualite ### Image-to-Video - Entrez 1 image pour generer une video a partir de la premiere image, entrez 2 images pour generer une video avec images de debut et de fin, le modele determine automatiquement ### Reference-to-Video - Générez une vidéo à partir d’un prompt, avec des images (0–10), vidéos (0–5) et segments audio (0–5) de référence facultatifs. Toutes les références peuvent être omises ; une référence audio seule est également acceptée. - Adapte a la creation de nouvelles videos : les images, videos et audios servent de reference de style, de sujet, de mouvement de camera et de musique - **Pour reecrire ou prolonger une video existante, utilisez [Video Edit](/fr/api-manual/video-series/seedance/seedance-2.5-flash/seedance-2.5-flash-video-edit) / [Video Extend](/fr/api-manual/video-series/seedance/seedance-2.5-flash/seedance-2.5-flash-video-extend)** : des que le prompt de ce modele exprime une intention d'edition ou d'extension, les parametres sont valides comme ceux d'une tache d'edition / extension : la requete est acceptee sans erreur et la tache echoue seulement pendant la generation ### Video Edit - Edition d'une video d'entree : remplacer des sujets, ajouter ou supprimer des objets, restyliser ou repeindre des zones - Décrivez directement la modification dans le prompt, par exemple : "Supprimer tous les passants de @video1 et ne garder que le personnage principal" - Fournissez la video a editer (obligatoire) + des images de reference facultatives (0–10) + des videos de reference (5 au maximum au total) + de l'audio de reference (0–5) ### Video Extend - Prolonge une video d'entree vers l'avant ou vers l'arriere - Le prompt doit exprimer l'intention d'extension (par exemple "Prolonger @video1 vers l'arriere, le personnage sort du cadre") - Fournissez la video a prolonger (obligatoire) + des images de reference facultatives (0–10) + des videos de reference (5 au maximum au total) + de l'audio de reference (0–5) - **Prend desormais en charge les contenus humains realistes generes par IA (AIGC)** - Mode de traitement asynchrone, utilisez l'ID de tache retourne pour [consulter le statut](/fr/api-manual/task-management/get-task-detail) - Le lien de la video generee est valide pendant 24 heures, veuillez le sauvegarder rapidement operationId: createSeedance25FlashVideoGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: text_to_video_basic: summary: Text-to-Video basique value: model: seedance-2.5-flash-text-to-video prompt: >- A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically. duration: 8 quality: 720p aspect_ratio: '16:9' generate_audio: true content_filter: true text_to_video_web_search: summary: Text-to-Video avec recherche web value: model: seedance-2.5-flash-text-to-video prompt: >- Today's New York weather forecast, with city skyline animation and temperature overlay display duration: 8 quality: 720p aspect_ratio: '16:9' model_params: web_search: true content_filter: true image_to_video_first_frame: summary: Video a partir de la premiere image value: model: seedance-2.5-flash-image-to-video prompt: >- The camera slowly zooms in, the scene gradually comes to life image_urls: - https://example.com/first-frame.jpg duration: 5 quality: 720p aspect_ratio: adaptive image_to_video_first_last_frame: summary: Video avec images de debut et de fin value: model: seedance-2.5-flash-image-to-video prompt: A smooth transition between two scenes image_urls: - https://example.com/first.jpg - https://example.com/last.jpg duration: 6 quality: 720p aspect_ratio: adaptive reference_to_video_multimodal: summary: Reference multimodale (image + video + audio) value: model: seedance-2.5-flash-reference-to-video prompt: >- Use the first-person perspective framing of @video1 throughout, and use @audio1 as background music throughout. First-person perspective fruit tea promotional video... image_urls: - https://example.com/ref1.jpg - https://example.com/ref2.jpg video_urls: - https://example.com/reference.mp4 audio_urls: - https://example.com/bgm.mp3 duration: 10 quality: 720p aspect_ratio: '16:9' generate_audio: true content_filter: true reference_to_video_subject_reference: summary: Reference image + video (sujet + mouvement de camera) value: model: seedance-2.5-flash-reference-to-video prompt: >- Make the face cream in @image1 the hero product, and follow the camera rhythm and lighting mood of @video1 to generate a clean product commercial image_urls: - https://example.com/cream.jpg video_urls: - https://example.com/reference.mp4 duration: 5 quality: 720p aspect_ratio: '16:9' reference_to_video_multi_video: summary: Reference multi-videos (narration en plusieurs plans) value: model: seedance-2.5-flash-reference-to-video prompt: >- The arched window in @video1 opens into the art gallery interior, continuing with @video2; then the camera enters the painting, continuing with @video3 video_urls: - https://example.com/part1.mp4 - https://example.com/part2.mp4 - https://example.com/part3.mp4 duration: 8 quality: 720p aspect_ratio: '16:9' generate_audio: true content_filter: true video_edit_remove_objects: summary: Editer la video (supprimer des objets) value: model: seedance-2.5-flash-video-edit prompt: >- Editer la video : supprimer tous les passants de @video1 et ne garder que le personnage principal video_urls: - https://example.com/original.mp4 quality: 720p generate_audio: true content_filter: true video_edit_replace_subject: summary: >- Editer la video (remplacer un element a partir d'une image de reference) value: model: seedance-2.5-flash-video-edit prompt: >- Editer la video : remplacer le parfum du coffret cadeau de @video1 par la creme visage de @image1, sans modifier le mouvement de camera image_urls: - https://example.com/cream.jpg video_urls: - https://example.com/original.mp4 duration: -1 quality: 720p video_extend_extend_backward: summary: Prolonger la video vers l'arriere (duree personnalisee) value: model: seedance-2.5-flash-video-extend prompt: >- Prolonger @video1 vers l'arriere : le personnage sort du cadre et la camera recule lentement pour reveler la rue vide video_urls: - https://example.com/original.mp4 duration: 12 quality: 720p generate_audio: true content_filter: true video_extend_extend_forward: summary: Prolonger la video vers l'avant (duree automatique) value: model: seedance-2.5-flash-video-extend prompt: >- Prolonger @video1 vers l'avant : le personnage continue de marcher vers le coucher de soleil tandis que la lumiere faiblit video_urls: - https://example.com/original.mp4 duration: -1 quality: 720p responses: '200': description: Tache de generation video creee avec succes content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: Erreur de parametres de requete content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_parameter message: Invalid request parameters type: invalid_request_error '401': description: Non authentifie, token invalide ou expire content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Quota insuffisant, rechargement necessaire content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Acces non autorise content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: >- Token does not have access to model: seedance-2.5-flash-text-to-video type: invalid_request_error '429': description: Limite de frequence de requetes depassee content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Erreur interne du serveur content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error '503': description: Service temporairement indisponible ; réessayez plus tard. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: VideoGenerationRequest: type: object description: >- Cette page regroupe les paramètres des différents modes. Les champs obligatoires, valeurs acceptées et valeurs par défaut dépendent du model choisi ; les différences sont détaillées par mode ci-dessous. required: - model - prompt properties: model: type: string description: >- Nom du modele de generation video | ID du modèle | Mode | Champs obligatoires (hors model) | |---|---|---| | `seedance-2.5-flash-text-to-video` | Text-to-Video | `prompt` | | `seedance-2.5-flash-image-to-video` | Image-to-Video | `prompt`, `image_urls` | | `seedance-2.5-flash-reference-to-video` | Reference-to-Video | `prompt` | | `seedance-2.5-flash-video-edit` | Video Edit | `prompt`, `video_urls` | | `seedance-2.5-flash-video-extend` | Video Extend | `prompt`, `video_urls` | enum: - seedance-2.5-flash-text-to-video - seedance-2.5-flash-image-to-video - seedance-2.5-flash-reference-to-video - seedance-2.5-flash-video-edit - seedance-2.5-flash-video-extend example: seedance-2.5-flash-text-to-video prompt: type: string description: >- **Text-to-Video** Prompt textuel decrivant la video souhaitee. Prend en charge le chinois et l'anglais, il est recommande de ne pas depasser 500 caracteres en chinois ou 1000 mots en anglais. Longueur maximale du prompt : 10000 tokens **Remarque :** - Ce modele est exclusivement text-to-video et ne prend pas en charge les entrees `image_urls`, `video_urls`, `audio_urls` **Image-to-Video** Prompt textuel decrivant la video souhaitee. Prend en charge le chinois et l'anglais, il est recommande de ne pas depasser 500 caracteres en chinois ou 1000 mots en anglais. Longueur maximale du prompt : 10000 tokens **Remarque :** - Ce modele ne prend pas en charge les entrees `video_urls`, `audio_urls` **Reference-to-Video** Prompt textuel decrivant la video souhaitee. Prend en charge le chinois et l'anglais, il est recommande de ne pas depasser 500 caracteres en chinois. Longueur maximale du prompt : 10000 tokens **Details :** - Pour faire reference aux ressources d'entree dans le prompt, utilisez de preference des balises explicites comme `@image1`, `@video1` et `@audio1`, plutot que de vous fier uniquement a des references en langage naturel telles que « image 1 », « video 1 » ou « audio 1 » - La numerotation des balises suit l'ordre du tableau d'URL correspondant et commence a 1 : le premier element de `image_urls` est `@image1`, le premier de `video_urls` est `@video1` et le premier de `audio_urls` est `@audio1` - La numerotation en langage naturel peut encore etre comprise, mais les balises explicites associent plus clairement chaque ressource a son usage **Eviter que la tache soit classee comme edition / extension :** - Le type de tache est deduit de l'intention du prompt : des formulations comme "editer la video", "ajouter", "supprimer / enlever", "modifier / remplacer" sont interpretees comme une edition video ; des formulations comme "prolonger vers l'avant / vers l'arriere" ou "continuer" sont interpretees comme une extension video - Une fois classee ainsi, `aspect_ratio` doit valoir `adaptive` et, pour l'edition video, `duration` doit valoir `-1` ; sinon la requete est acceptee sans erreur et la tache passe ensuite en `failed` (code d'erreur `InvalidParameter.TaskTypeConstraint`). Le quota preleve est rembourse, mais le temps d'attente est perdu - Si vous avez reellement besoin d'editer ou de prolonger, utilisez directement `seedance-2.5-flash-video-edit` ou `seedance-2.5-flash-video-extend` : les parametres sont valides a l'envoi, une valeur invalide renvoie donc une erreur synchrone immediate - Pour une generation par reference pure, reformulez les mots comme "remplacer" ou "enlever" de maniere descriptive, par exemple "la scene fait apparaitre ..." ou "rendu dans le style de @image1" **Video Edit** Prompt textuel decrivant l'edition souhaitee. Prend en charge le chinois et l'anglais ; 500 caracteres maximum recommandes en chinois. Longueur maximale du prompt : 10000 tokens **Details :** - Le prompt doit exprimer l'intention d'edition, par exemple : "Editer la video : supprimer la musique de fond de @video1" - Vous pouvez preciser en langage naturel le role de chaque element, par exemple : "remplacer le personnage de @video1 par celui de @image1" - Le modele comprend automatiquement la correspondance entre les numeros des elements et leur usage **Video Extend** Prompt textuel decrivant l'extension souhaitee. Prend en charge le chinois et l'anglais ; 500 caracteres maximum recommandes en chinois. Longueur maximale du prompt : 10000 tokens **Details :** - Le prompt doit exprimer l'intention d'extension, par exemple : "Prolonger @video1 vers l'arriere, le personnage sort du cadre" - Vous pouvez preciser en langage naturel le role de chaque element, par exemple : "prolonger @video1 vers l'avant en suivant le style de @image1" - Le modele comprend automatiquement la correspondance entre les numeros des elements et leur usage example: >- A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically. image_urls: type: array description: >- S’applique uniquement à : **Image-to-Video**, **Reference-to-Video**, **Video Edit**, **Video Extend** **Image-to-Video** Tableau d'URLs d'images, **1 a 2 images** **Nombre d'images et comportement :** | Nombre d'images | Comportement | Role | |:--------:|------|------| | 1 image | Video a partir de la premiere image | Automatiquement defini comme `first_frame` | | 2 images | Video avec images de debut et de fin | 1ere image → `first_frame`, 2eme image → `last_frame` | **Exigences pour les images :** - Formats pris en charge : `.jpeg`, `.png`, `.webp` - Rapport d'aspect (largeur/hauteur) : `0.4` a `2.5` - Dimensions en pixels : `300` a `6000` px - Taille maximale par image : `30 Mo` - Taille totale du corps de requete ne depassant pas `64 Mo` - Lors de l'envoi d'images de debut et de fin, les deux images peuvent etre identiques. En cas de rapport d'aspect different, la premiere image prevaut et la derniere image est automatiquement recadree - Les URLs d'images doivent etre directement accessibles par le serveur **Adresses des médias :** les URL HTTP(S) publiques et les identifiants `asset://` accessibles au compte amont sélectionné sont pris en charge. **Reference-to-Video** Tableau d'URLs d'images de reference, **facultatif ; 1 a 10 images si fourni** **Références facultatives :** `image_urls`, `video_urls` et `audio_urls` peuvent tous être omis. Fournir uniquement `audio_urls` est également accepté. **Description des roles :** | Type de media | Role | Utilisation typique | |---------|------|----------| | Image | `reference_image` | Reference de style, image produit, premiere/derniere image (specifiee via le prompt) | **Exigences pour les images :** - Formats pris en charge : `.jpeg`, `.png`, `.webp` - Rapport d'aspect (largeur/hauteur) : `0.4` a `2.5` - Dimensions en pixels : `300` a `6000` px - Taille maximale par image : `30 Mo` - Taille totale du corps de requete ne depassant pas `64 Mo`, ne pas utiliser l'encodage Base64 - Les URLs d'images doivent etre directement accessibles par le serveur **Adresses des médias :** les URL HTTP(S) publiques et les identifiants `asset://` accessibles au compte amont sélectionné sont pris en charge. **Video Edit** Tableau d'URLs d'images de reference, **facultatif ; 1 a 10 images si fourni** **Condition :** `video_urls` est obligatoire pour ce modele ; les images sont des references complementaires facultatives. **Description des roles :** | Type de media | Role | Utilisation typique | |---------|------|----------| | Image | `reference_image` | Reference de style, visuel produit, sujet de remplacement (indique dans le prompt) | **Exigences pour les images :** - Formats pris en charge : `.jpeg`, `.png`, `.webp` - Rapport d'aspect (largeur/hauteur) : `0.4` a `2.5` - Dimensions en pixels : `300` a `6000` px - Taille maximale par image : `30 Mo` - Taille totale du corps de requete ne depassant pas `64 Mo`, ne pas utiliser l'encodage Base64 - Les URLs d'images doivent etre directement accessibles par le serveur **Adresses des médias :** les URL HTTP(S) publiques et les identifiants `asset://` accessibles au compte amont sélectionné sont pris en charge. **Video Extend** Tableau d'URLs d'images de reference, **facultatif ; 1 a 10 images si fourni** **Condition :** `video_urls` est obligatoire pour ce modele ; les images sont des references complementaires facultatives. **Description des roles :** | Type de media | Role | Utilisation typique | |---------|------|----------| | Image | `reference_image` | Reference de style, visuel produit, reference de scene (indique dans le prompt) | **Exigences pour les images :** - Formats pris en charge : `.jpeg`, `.png`, `.webp` - Rapport d'aspect (largeur/hauteur) : `0.4` a `2.5` - Dimensions en pixels : `300` a `6000` px - Taille maximale par image : `30 Mo` - Taille totale du corps de requete ne depassant pas `64 Mo`, ne pas utiliser l'encodage Base64 - Les URLs d'images doivent etre directement accessibles par le serveur **Adresses des médias :** les URL HTTP(S) publiques et les identifiants `asset://` accessibles au compte amont sélectionné sont pris en charge. items: type: string format: uri maxItems: 10 example: - https://example.com/first-frame.jpg video_urls: type: array description: >- S’applique uniquement à : **Reference-to-Video**, **Video Edit**, **Video Extend** **Reference-to-Video** Tableau d'URLs de videos de reference, **facultatif ; 1 a 5 videos si fourni** **Références facultatives :** `image_urls`, `video_urls` et `audio_urls` peuvent tous être omis. Fournir uniquement `audio_urls` est également accepté. **Description des roles :** | Type de media | Role | Utilisation typique | |---------|------|----------| | Video | `reference_video` | Reference de mouvement de camera, reference d'action, video originale a editer/etendre | **Exigences pour les videos :** - Formats pris en charge : `.mp4`, `.mov` - Resolution : 480p, 720p, 1080p, 4K - Duree par video : `2` a `30` secondes, maximum 5 videos, duree totale de toutes les videos ≤ `30` secondes - Rapport d'aspect (largeur/hauteur) : `0.4` a `2.5` - Dimensions en pixels : `300` a `6000` px - Pixels d'image (largeur x hauteur) : `409 600` a `8 295 044` (ex. 640×640 a 3326×2494) - Taille maximale par video : `200 Mo` - Frequence d'images : `24` a `60` FPS - Taille totale du corps de requete ne depassant pas `64 Mo`, ne pas utiliser l'encodage Base64 - La validite du codec, de la resolution et des autres caracteristiques du contenu est verifiee en plus par le modele - L'utilisation de references video entraine des frais supplementaires (la duree de la video d'entree est comptabilisee dans la facturation) - Les URLs de videos doivent etre directement accessibles par le serveur **Adresses des médias :** les URL HTTP(S) publiques et les identifiants `asset://` accessibles au compte amont sélectionné sont pris en charge. **Video Edit** Tableau d'URL de videos d'entree, **obligatoire ; de 1 a 5 videos** **Condition :** au moins 1 video est requise, celle a editer. La premiere video est l'objet de l'edition ; les suivantes servent de reference. **Description des roles :** | Type de media | Role | Utilisation typique | |---------|------|----------| | Video | `reference_video` | La video a editer (la premiere), reference de mouvement de camera ou d'action (les suivantes) | **Exigences pour les videos :** - Formats pris en charge : `.mp4`, `.mov` - Resolution : 480p, 720p, 1080p, 4K - Duree par video : `4` a `30` secondes (la premiere video est l'objet de l'edition), maximum 5 videos, duree totale de toutes les videos ≤ `30` secondes - Rapport d'aspect (largeur/hauteur) : `0.4` a `2.5` - Dimensions en pixels : `300` a `6000` px - Pixels d'image (largeur x hauteur) : `409 600` a `8 295 044` (ex. 640×640 a 3326×2494) - Taille maximale par video : `200 Mo` - Frequence d'images : `24` a `60` FPS - Taille totale du corps de requete ne depassant pas `64 Mo`, ne pas utiliser l'encodage Base64 - La validite du codec, de la resolution et des autres caracteristiques du contenu est verifiee en plus par le modele - L'utilisation de references video entraine des frais supplementaires (la duree de la video d'entree est comptabilisee dans la facturation) - Les URLs de videos doivent etre directement accessibles par le serveur **Adresses des médias :** les URL HTTP(S) publiques et les identifiants `asset://` accessibles au compte amont sélectionné sont pris en charge. **Video Extend** Tableau d'URL de videos d'entree, **obligatoire ; de 1 a 5 videos** **Condition :** au moins 1 video est requise, celle a prolonger. La premiere video est l'objet de l'extension ; les suivantes servent de reference. **Description des roles :** | Type de media | Role | Utilisation typique | |---------|------|----------| | Video | `reference_video` | La video a prolonger (la premiere), reference de mouvement de camera ou d'action (les suivantes) | **Exigences pour les videos :** - Formats pris en charge : `.mp4`, `.mov` - Resolution : 480p, 720p, 1080p, 4K - Duree par video : `2` a `30` secondes, maximum 5 videos, duree totale de toutes les videos ≤ `30` secondes - Rapport d'aspect (largeur/hauteur) : `0.4` a `2.5` - Dimensions en pixels : `300` a `6000` px - Pixels d'image (largeur x hauteur) : `409 600` a `8 295 044` (ex. 640×640 a 3326×2494) - Taille maximale par video : `200 Mo` - Frequence d'images : `24` a `60` FPS - Taille totale du corps de requete ne depassant pas `64 Mo`, ne pas utiliser l'encodage Base64 - La validite du codec, de la resolution et des autres caracteristiques du contenu est verifiee en plus par le modele - L'utilisation de references video entraine des frais supplementaires (la duree de la video d'entree est comptabilisee dans la facturation) - Les URLs de videos doivent etre directement accessibles par le serveur **Adresses des médias :** les URL HTTP(S) publiques et les identifiants `asset://` accessibles au compte amont sélectionné sont pris en charge. items: type: string format: uri maxItems: 5 example: - https://example.com/reference.mp4 audio_urls: type: array description: >- S’applique uniquement à : **Reference-to-Video**, **Video Edit**, **Video Extend** **Reference-to-Video** Tableau d'URLs d'audios de reference, **facultatif ; 1 a 5 segments si fourni** **Références facultatives :** `image_urls`, `video_urls` et `audio_urls` peuvent tous être omis. Fournir uniquement `audio_urls` est également accepté. **Description des roles :** | Type de media | Role | Utilisation typique | |---------|------|----------| | Audio | `reference_audio` | Musique de fond, effets sonores, reference vocale/dialogue | **Exigences pour les audios :** - Formats pris en charge : `.wav`, `.mp3` - Duree par segment audio : `2` a `30` secondes, maximum 5 segments, duree totale de tous les audios ≤ `30` secondes - Taille maximale par segment : `15 Mo` - Taille totale du corps de requete ne depassant pas `64 Mo`, ne pas utiliser l'encodage Base64 - Les URLs d'audios doivent etre directement accessibles par le serveur **Adresses des médias :** les URL HTTP(S) publiques et les identifiants `asset://` accessibles au compte amont sélectionné sont pris en charge. **Video Edit / Video Extend** Tableau d'URLs d'audios de reference, **facultatif ; 1 a 5 segments si fourni** **Condition :** `video_urls` est obligatoire pour ce modele ; l'audio est une reference complementaire facultative. **Description des roles :** | Type de media | Role | Utilisation typique | |---------|------|----------| | Audio | `reference_audio` | Musique de fond, effets sonores, reference vocale/dialogue | **Exigences pour les audios :** - Formats pris en charge : `.wav`, `.mp3` - Duree par segment audio : `2` a `30` secondes, maximum 5 segments, duree totale de tous les audios ≤ `30` secondes - Taille maximale par segment : `15 Mo` - Taille totale du corps de requete ne depassant pas `64 Mo`, ne pas utiliser l'encodage Base64 - Les URLs d'audios doivent etre directement accessibles par le serveur **Adresses des médias :** les URL HTTP(S) publiques et les identifiants `asset://` accessibles au compte amont sélectionné sont pris en charge. items: type: string format: uri maxItems: 5 example: - https://example.com/bgm.mp3 duration: type: integer description: >- **Text-to-Video / Image-to-Video** Duree de la video (secondes), par defaut `5` secondes **Details :** - Prend en charge toute valeur entiere entre `4` et `30` secondes - `-1` : duree automatique, le modele choisit une duree entre `4` et `30` secondes et la facturation suit la duree reellement produite - La duree est directement liee a la facturation **Reference-to-Video** Duree de la video de sortie (secondes), par defaut `5` secondes **Details :** - Prend en charge toute valeur entiere entre `4` et `30` secondes - `-1` : duree automatique, le modele choisit une duree entre `4` et `30` secondes et la facturation suit la duree reellement produite - La duree est directement liee a la facturation Si le prompt est classe comme tache d'edition video, seul `-1` est accepte ; un nombre de secondes explicite fait echouer la tache plus tard, sans erreur a l'envoi **Video Edit** Duree de la video de sortie (secondes), par defaut `-1` **Details :** - Seule la valeur `-1` est prise en charge : la duree de sortie suit la video d'entree (elle peut etre plus courte de 0,4 s au maximum) - Les durees personnalisees sont refusees - La duree influe directement sur la facturation **Video Extend** Duree de la video de sortie (secondes), par defaut `5` secondes **Details :** - Prend en charge toute valeur entiere comprise entre `4` et `30` secondes - `-1` : duree automatique, facturee selon la duree reellement produite - La duree influe directement sur la facturation anyOf: - enum: - -1 - minimum: 4 maximum: 30 example: 8 quality: type: string description: |- Resolution video, par defaut `720p` **Valeurs possibles :** - `480p` : resolution inferieure, prix reduit - `720p` : resolution standard, valeur par defaut enum: - 480p - 720p default: 720p example: 720p aspect_ratio: type: string description: >- **Text-to-Video** Rapport d'aspect de la video, par defaut `adaptive` **Valeurs possibles :** - `16:9` (paysage), `9:16` (portrait), `1:1` (carre), `4:3`, `3:4`, `21:9` (ultra-large) - `adaptive` : le modele choisit intelligemment le meilleur rapport d'aspect en fonction du prompt **Pixels correspondants par resolution :** | Rapport d'aspect | 480p | 720p | | :------: | :----: | :----: | | 16:9 | 854×480 | 1280×720 | | 4:3 | 752×560 | 1112×834 | | 1:1 | 640×640 | 960×960 | | 3:4 | 560×752 | 834×1112 | | 9:16 | 480×854 | 720×1280 | | 21:9 | 992×432 | 1470×630 | **Image-to-Video** Rapport d'aspect de la video, Image-to-Video prend uniquement en charge `adaptive` **Valeurs possibles :** - `adaptive` : selectionne automatiquement le rapport d'aspect le plus proche en fonction de la premiere image ; c'est la seule valeur acceptee par ce modele - Les rapports fixes comme `16:9` ou `9:16` ne peuvent pas etre specifies pour ce modele **Reference-to-Video** Rapport d'aspect de la video, par defaut `adaptive` **Valeurs possibles :** - `16:9` (paysage), `9:16` (portrait), `1:1` (carre), `4:3`, `3:4`, `21:9` (ultra-large) - `adaptive` : determine en fonction de l'intention du prompt, priorite : video > image > prompt **Pixels correspondants par resolution :** | Rapport d'aspect | 480p | 720p | | :------: | :----: | :----: | | 16:9 | 854×480 | 1280×720 | | 4:3 | 752×560 | 1112×834 | | 1:1 | 640×640 | 960×960 | | 3:4 | 560×752 | 834×1112 | | 9:16 | 480×854 | 720×1280 | | 21:9 | 992×432 | 1470×630 | Si le prompt est classe comme tache d'edition / extension video, seul `adaptive` est accepte ; un rapport fixe fait echouer la tache plus tard, sans erreur a l'envoi **Video Edit / Video Extend** Rapport d'aspect de la video, par defaut `adaptive` **Valeurs possibles :** - `adaptive` : le rapport de sortie suit la premiere video d'entree ; c'est la seule valeur acceptee par ce modele - Les rapports fixes comme `16:9` ou `9:16` sont refuses enum: - '16:9' - '9:16' - '1:1' - '4:3' - '3:4' - '21:9' - adaptive default: adaptive example: '16:9' generate_audio: type: boolean description: >- **Text-to-Video** Generer ou non un audio synchronise, par defaut `true` **Valeurs possibles :** - `true` : la video inclut un audio synchronise (voix, effets sonores, musique de fond), sans frais supplementaires. Il est recommande de placer les dialogues entre guillemets pour optimiser la generation audio - `false` : video muette en sortie **Image-to-Video / Reference-to-Video / Video Edit / Video Extend** Generer ou non un audio synchronise, par defaut `true` **Valeurs possibles :** - `true` : la video inclut un audio synchronise, sans frais supplementaires - `false` : video muette en sortie default: true example: true content_filter: type: boolean description: >- Filtre de contenu, par defaut `true` **Valeurs possibles :** - `true` : verification standard de securite du contenu, c'est la valeur par defaut - `false` : assouplit les restrictions de contenu, facture avec +10% (`1.1x`). Les contenus illegaux et interdits sont toujours appliques independamment de ce parametre **Incompatible avec la recherche web :** - `content_filter: false` et `model_params.web_search: true` ne peuvent pas etre utilises ensemble ; les envoyer ensemble renvoie une erreur de parametre 400 - Conservez `content_filter: true` (valeur par defaut) si la recherche web est necessaire default: true example: true output_format: type: string description: >- Format de conteneur de sortie, par defaut `mp4` **Valeurs possibles :** - `mp4` : encodage H.264, meilleure compatibilite et precision colorimetrique standard ; c'est la valeur par defaut - `mov` : H.264 + echantillonnage chroma yuv444p + audio PCM, fidelite colorimetrique superieure, recommande pour l'etalonnage, l'incrustation et le compositing. La lecture dans le navigateur peut ne pas fonctionner ; telechargez le fichier et lisez-le avec VLC / mpv / ffplay. Sans frais supplementaires enum: - mp4 - mov default: mp4 example: mp4 model_params: type: object description: |- S’applique uniquement à : **Text-to-Video** Parametres etendus du modele properties: web_search: type: boolean description: >- Recherche web, par defaut `false` **Details :** - Une fois active, le modele decide de maniere autonome s'il doit rechercher du contenu sur Internet (produits, meteo, etc.) en fonction du prompt, ce qui peut ameliorer l'actualite - Peut augmenter la latence - Les frais ne sont generes que lorsque la recherche est effectivement declenchee, et peut etre appelee plusieurs fois apres activation **Incompatible avec le filtre de contenu :** - Conservez `content_filter: true` lorsque la recherche web est activee ; l'utiliser avec `content_filter: false` renvoie une erreur de parametre 400 default: false example: false callback_url: type: string description: >- URL de rappel HTTPS apres l'achevement de la tache **Declenchement du rappel :** - Déclenché lorsque la tâche est terminée (completed) ou a échoué (failed) - Envoye apres la confirmation de la facturation **Restrictions de securite :** - Seul le protocole HTTPS est pris en charge - Les rappels vers les adresses IP privees sont interdits (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.) - La longueur de l'URL ne doit pas depasser `2048` caracteres **Mecanisme de rappel :** - Delai d'expiration : `10` secondes - Jusqu'a `3` tentatives apres un echec (respectivement `1`/`2`/`4` secondes apres l'echec) - Le format du corps de reponse du rappel est identique a celui de l'interface de consultation de tache - Un code de statut 2xx est considere comme un succes, les autres codes declenchent une nouvelle tentative format: uri example: https://your-domain.com/webhooks/video-task-completed VideoGenerationResponse: type: object properties: created: type: integer description: Horodatage de creation de la tache example: 1761313744 id: type: string description: ID de la tache example: task-unified-1774857405-abc123 model: type: string description: Nom du modele effectivement utilise example: seedance-2.5-flash-text-to-video object: type: string enum: - video.generation.task description: Type specifique de la tache progress: type: integer description: Pourcentage de progression de la tache (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Statut de la tache enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: Informations detaillees de la tache video type: type: string enum: - text - image - audio - video description: Type de sortie de la tache example: video usage: $ref: '#/components/schemas/VideoUsage' description: Informations d'utilisation et de facturation ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Identifiant du code d'erreur message: type: string description: Description de l'erreur type: type: string description: Type d'erreur VideoTaskInfo: type: object properties: can_cancel: type: boolean description: >- Indique si la tâche peut être annulée. Seedance 2.5 Flash ne permet pas aux utilisateurs d’annuler une tâche ; ce champ renvoie toujours `false`. example: false estimated_time: type: integer description: Temps estime d'achevement (secondes) minimum: 0 example: 165 video_duration: type: integer description: Duree de la video (secondes) example: 8 VideoUsage: type: object description: Informations d'utilisation et de facturation properties: billing_rule: type: string description: Regle de facturation enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: Nombre de credits estimes consommes minimum: 0 example: 50 user_group: type: string description: Categorie du groupe utilisateur example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ## Toutes les interfaces necessitent une authentification par Bearer Token ## **Obtenir une cle API :** Visitez la [Page de gestion des cles API](https://evolink.ai/dashboard/keys) pour obtenir votre cle API **Ajoutez dans l'en-tete de la requete :** ``` Authorization: Bearer YOUR_API_KEY ``` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.