> ## 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 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 - **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 **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. ## OpenAPI ````yaml fr/api-manual/video-series/seedance/seedance-2.5-flash/seedance-2.5-flash-reference-to-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: API Seedance 2.5 Flash Reference-to-Video description: >- API Seedance 2.5 Flash Reference-to-Video multimodale, prend en charge la generation mixte a partir de references d'images, de videos et d'audio 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 Reference-to-Video multimodale description: >- - 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 - **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 **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. operationId: createSeedance25FlashReferenceToVideo requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: 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 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' 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 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-reference-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 required: - model - prompt properties: model: type: string description: Nom du modele de generation video enum: - seedance-2.5-flash-reference-to-video default: seedance-2.5-flash-reference-to-video example: seedance-2.5-flash-reference-to-video prompt: type: string description: >- 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" example: >- 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: type: array description: >- 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. items: type: string format: uri maxItems: 10 example: - https://example.com/ref1.jpg - https://example.com/ref2.jpg video_urls: type: array description: >- 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. items: type: string format: uri maxItems: 5 example: - https://example.com/reference.mp4 audio_urls: type: array description: >- 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. items: type: string format: uri maxItems: 5 example: - https://example.com/bgm.mp3 duration: type: integer description: >- 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 default: 5 example: 10 anyOf: - enum: - -1 - minimum: 4 maximum: 30 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: >- 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 enum: - '16:9' - '9:16' - '1:1' - '4:3' - '3:4' - '21:9' - adaptive default: adaptive example: '16:9' generate_audio: type: boolean description: >- 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 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-reference-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.