> ## Documentation Index > Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt > Use this file to discover all available pages before exploring further. # Seedance 2.0 Reference-to-Video > - Entrez des images de reference (0-9) + des videos de reference (0-3) + des audios de reference (0-3) + un prompt textuel pour generer une video - Prend en charge la creation, l'edition et l'extension de videos, ainsi que divers scenarios creatifs - **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/seedance2.0/seedance-2.0-reference-to-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: API Seedance 2.0 Reference-to-Video description: >- API Seedance 2.0 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.0 Reference-to-Video multimodale description: >- - Entrez des images de reference (0-9) + des videos de reference (0-3) + des audios de reference (0-3) + un prompt textuel pour generer une video - Prend en charge la creation, l'edition et l'extension de videos, ainsi que divers scenarios creatifs - **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: createSeedance20ReferenceToVideo requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: multimodal: summary: Reference multimodale (image + video + audio) value: model: seedance-2.0-reference-to-video prompt: >- Use the first-person perspective framing of video 1 throughout, use audio 1 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 video_edit: summary: Edition video (remplacement d'elements) value: model: seedance-2.0-reference-to-video prompt: >- Replace the perfume in the gift box in video 1 with the face cream in image 1, keep the camera movement unchanged image_urls: - https://example.com/cream.jpg video_urls: - https://example.com/original.mp4 duration: 5 aspect_ratio: '16:9' video_extend: summary: Extension video (concatenation de segments) value: model: seedance-2.0-reference-to-video prompt: >- The arched window in video 1 opens, entering the art gallery interior, continuing with video 2, then the camera enters the painting, continuing with video 3 video_urls: - https://example.com/part1.mp4 - https://example.com/part2.mp4 - https://example.com/part3.mp4 duration: 8 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_request 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.0-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 components: schemas: VideoGenerationRequest: type: object required: - model - prompt properties: model: type: string description: Nom du modele de generation video enum: - seedance-2.0-reference-to-video default: seedance-2.0-reference-to-video example: seedance-2.0-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 :** - Vous pouvez specifier l'utilisation de chaque ressource en langage naturel, par exemple `premiere image = image 1`, `utiliser le mouvement de camera de la video 1 tout au long`, `audio 1 comme musique de fond` - Le modele comprend automatiquement la correspondance entre les numeros de ressources et leurs usages example: >- Use the first-person perspective framing of video 1 throughout, use audio 1 as background music throughout. First-person perspective fruit tea promotional video... image_urls: type: array description: >- Tableau d'URLs d'images de reference, **0 a 9 images** **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 **Remarque :** Il n'est pas possible de fournir uniquement `audio_urls`, vous devez inclure au moins 1 image (`image_urls`) ou 1 video (`video_urls`) items: type: string format: uri maxItems: 9 example: - https://example.com/ref1.jpg - https://example.com/ref2.jpg video_urls: type: array description: >- Tableau d'URLs de videos de reference, **0 a 3 videos** **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 - Duree par video : `2` a `15` secondes, maximum 3 videos, duree totale de toutes les videos ≤ `15` 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 `2 086 876` (ex. 640×640 a 834×1112) - Taille maximale par video : `50 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 - 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 **Remarque :** Il n'est pas possible de fournir uniquement `audio_urls`, vous devez inclure au moins 1 image (`image_urls`) ou 1 video (`video_urls`) items: type: string format: uri maxItems: 3 example: - https://example.com/reference.mp4 audio_urls: type: array description: >- Tableau d'URLs d'audios de reference, **0 a 3 segments** **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 `15` secondes, maximum 3 segments, duree totale de tous les audios ≤ `15` 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 **Remarque :** L'audio ne peut pas etre fourni seul, il doit inclure au moins 1 video ou image de reference items: type: string format: uri maxItems: 3 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 `15` secondes - La duree est directement liee a la facturation default: 5 minimum: 4 maximum: 15 example: 10 quality: type: string description: |- Resolution video, par defaut `720p` **Valeurs possibles :** - `480p` : resolution inferieure, prix reduit - `720p` : resolution standard, valeur par defaut - `1080p` : resolution Ultra HD - `4k` : resolution 4K Ultra HD enum: - 480p - 720p - 1080p - 4k default: 720p example: 720p aspect_ratio: type: string description: >- Rapport d'aspect de la video, par defaut `16:9` **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 | 1080p | 4K | |:------:|:----:|:----:|:-----:|:----:| | 16:9 | 864×496 | 1280×720 | 1920×1080 | 3840×2160 | | 4:3 | 752×560 | 1112×834 | 1664×1248 | 3326×2494 | | 1:1 | 640×640 | 960×960 | 1440×1440 | 2880×2880 | | 3:4 | 560×752 | 834×1112 | 1248×1664 | 2494×3326 | | 9:16 | 496×864 | 720×1280 | 1080×1920 | 2160×3840 | | 21:9 | 992×432 | 1470×630 | 2206×946 | 4398×1886 | enum: - '16:9' - '9:16' - '1:1' - '4:3' - '3:4' - '21:9' - adaptive default: '16:9' 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 default: true example: true callback_url: type: string description: >- URL de rappel HTTPS apres l'achevement de la tache **Declenchement du rappel :** - Declenche lorsque la tache est terminee (completed), echouee (failed) ou annulee (cancelled) - 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.0-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 tache peut etre annulee example: true 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 ``` ````