switch_heading
Documentation API Seedance 2.5
Générez des vidéos Seedance 2.5 et Seedance 2.5 Flash via l'API v3 : texte en vidéo, images, vidéos et audio de référence, première/dernière image, montage vidéo et sortie 4K.
L'API v3 est un endpoint séparé réservé à Seedance 2.5. Les intégrations /v1 et /v2 existantes continuent de fonctionner exactement comme avant ; passez à /v3 uniquement quand vous voulez Seedance 2.5.
Démarrage rapide
| 1 | curl -X POST 'https://seedanceapi.org/v3/generate' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' \ |
| 3 | -H 'Content-Type: application/json' \ |
| 4 | -d '{ |
| 5 | "model": "seedance-2.5", |
| 6 | "prompt": "A cinematic aerial shot over a coastline at golden hour", |
| 7 | "aspect_ratio": "16:9", |
| 8 | "resolution": "720p", |
| 9 | "duration": 10 |
| 10 | }' |
Authentification
Toutes les requêtes API nécessitent un jeton Bearer dans l'en-tête Authorization.
Important: Récupérez votre clé API sur la page API Keys de votre tableau de bord. Gardez-la sur votre serveur et ne l'incluez jamais dans du code navigateur. → Obtenir votre clé API
| 1 | Authorization: Bearer YOUR_API_KEY |
Modes de génération
| Mode | Champs à envoyer |
|---|---|
| Texte en vidéo | prompt + aspect_ratio |
| Génération par référence (images, vidéo, audio) | prompt + image_urls / reference_video_urls / reference_audio_urls |
| Première / dernière image | prompt + first_frame_url (+ last_frame_url) |
| Montage vidéo | prompt + reference_video_urls (1) + duration: -1 + aspect_ratio: "adaptive" |
Tarifs (crédits)
Les crédits sont facturés à la seconde de vidéo et dépendent du modèle, de la résolution et de l'envoi ou non de vidéos de référence. Le montant est débité à la création de la tâche et remboursé automatiquement en cas d'échec.
Besoin de recharger des crédits ? → Recharger sur la page des tarifs. 1 USD = 100 crédits.
Seedance 2.5
Qualité maximale, prend en charge 480p, 720p et le 4K natif.
| Résolution | Entrée | Tarif | Exemple |
|---|---|---|---|
| 480p | Texte / images / audio | 28 crédits / s | 10 s de sortie = 280 crédits |
| 480p | Avec vidéo de référence | 17 crédits / s | 5 s de référence + 10 s de sortie = 255 crédits |
| 720p | Texte / images / audio | 63 crédits / s | 10 s de sortie = 630 crédits |
| 720p | Avec vidéo de référence | 38 crédits / s | 5 s de référence + 10 s de sortie = 570 crédits |
| 4k | Texte / images / audio | 251 crédits / s | 10 s de sortie = 2510 crédits |
| 4k | Avec vidéo de référence | 155 crédits / s | 5 s de référence + 10 s de sortie = 2325 crédits |
Seedance 2.5 Flash
Plus rapide et moins cher, prend en charge 480p et 720p.
| Résolution | Entrée | Tarif | Exemple |
|---|---|---|---|
| 480p | Texte / images / audio | 18.5 crédits / s | 10 s de sortie = 185 crédits |
| 480p | Avec vidéo de référence | 11.5 crédits / s | 5 s de référence + 10 s de sortie = 173 crédits |
| 720p | Texte / images / audio | 41 crédits / s | 10 s de sortie = 410 crédits |
| 720p | Avec vidéo de référence | 25.5 crédits / s | 5 s de référence + 10 s de sortie = 383 crédits |
Avec reference_video_urls, la facturation applique le tarif d'entrée vidéo plus bas aux secondes de vidéo de référence, en plus des secondes de sortie. Le montage vidéo (duration -1) facture deux fois la longueur de la vidéo d'entrée. Les totaux sont arrondis au crédit supérieur.
Endpoints API
/v3/generateLancez une tâche Seedance 2.5 ou Seedance 2.5 Flash. L'appel renvoie immédiatement un task_id ; interrogez /v3/status ou passez callback_url pour obtenir le résultat.
Corps de la requête
Prompt texte (obligatoire, jusqu'à 5000 caractères).
seedance-2.5 (par défaut) ou seedance-2.5-flash. Defaults to seedance-2.5.
Durée de sortie en secondes : tout entier de 4 à 30. Utilisez -1 pour le montage vidéo, où la sortie conserve la durée de la vidéo d'entrée. Defaults to 5.
Seedance 2.5 : 480p, 720p ou 4k. Seedance 2.5 Flash : 480p ou 720p. 1080p n'est pas disponible. Defaults to 720p.
16:9, 9:16, 4:3, 3:4 ou adaptive. Le montage vidéo exige adaptive. Defaults to 16:9.
Jusqu'à 4 URL d'images de référence (http/https). Décrivez dans le prompt comment chaque image doit être utilisée.
URL d'image utilisée comme première image. Ne peut pas être combinée avec image_urls, reference_video_urls ou reference_audio_urls.
URL d'image facultative utilisée comme dernière image. Nécessite first_frame_url.
Jusqu'à 3 URL de vidéos de référence, 30 secondes au total. Pour le montage vidéo, envoyez exactement une vidéo d'une durée comprise entre 4 et 30 secondes.
Jusqu'à 3 URL d'audio de référence, par exemple de la musique ou une piste vocale.
Génère une bande-son en même temps que la vidéo. Defaults to true.
Permet au modèle de rechercher sur le web les sujets du prompt. Defaults to false.
Webhook facultatif appelé à la fin de la tâche (URL publique ; localhost n'est pas autorisé).
Facultatif : autoriser l'affichage du résultat dans la galerie publique.
Texte en vidéo
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "A slow dolly shot through a neon-lit street in the rain", |
| 4 | "aspect_ratio": "16:9", |
| 5 | "resolution": "720p", |
| 6 | "duration": 10 |
| 7 | } |
Image de référence + audio
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "The woman in the reference image dances to the beat of the reference audio in a sunlit studio", |
| 4 | "image_urls": ["https://example.com/character.jpg"], |
| 5 | "reference_audio_urls": ["https://example.com/beat.mp3"], |
| 6 | "aspect_ratio": "9:16", |
| 7 | "resolution": "720p", |
| 8 | "duration": 8 |
| 9 | } |
Première et dernière image (Flash)
| 1 | { |
| 2 | "model": "seedance-2.5-flash", |
| 3 | "prompt": "The flower bud slowly opens into full bloom", |
| 4 | "first_frame_url": "https://example.com/bud.jpg", |
| 5 | "last_frame_url": "https://example.com/bloom.jpg", |
| 6 | "resolution": "480p", |
| 7 | "duration": 6 |
| 8 | } |
Montage vidéo
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "Change the season to winter with falling snow; keep the camera motion", |
| 4 | "reference_video_urls": ["https://example.com/input-12s.mp4"], |
| 5 | "aspect_ratio": "adaptive", |
| 6 | "duration": -1, |
| 7 | "resolution": "720p" |
| 8 | } |
Sortie 4K
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "Macro shot of morning dew rolling off a green leaf", |
| 4 | "aspect_ratio": "16:9", |
| 5 | "resolution": "4k", |
| 6 | "duration": 5 |
| 7 | } |
Réponses
Task created
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "n90a1b2c3d4e5f6sd25", |
| 6 | "status": "IN_PROGRESS", |
| 7 | "consumed_credits": 630 |
| 8 | } |
| 9 | } |
/v3/statusInterrogez par task_id jusqu'à ce que status soit SUCCESS ou FAILED. Seules les tâches créées avec /v3/generate sont renvoyées ici.
Paramètres de requête
Identifiant de tâche renvoyé par POST /v3/generate (se termine par sd25).
Exemple de requête
| 1 | curl -X GET 'https://seedanceapi.org/v3/status?task_id=n90a1b2c3d4e5f6sd25' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' |
Tip: Quand status est SUCCESS, data.response est un tableau d'URL de vidéos ; utilisez data.response[0] pour la première URL. Téléchargez et conservez le fichier si vous devez le garder.
| 1 | const videoUrl = data.response[0]; |
Réponses
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "n90a1b2c3d4e5f6sd25", |
| 6 | "status": "SUCCESS", |
| 7 | "consumed_credits": 630, |
| 8 | "created_at": "2026-11-19T10:30:00Z", |
| 9 | "type": "seedance-2.5-t2v", |
| 10 | "request": { |
| 11 | "model": "seedance-2.5", |
| 12 | "prompt": "A slow dolly shot…", |
| 13 | "aspect_ratio": "16:9", |
| 14 | "duration": 10 |
| 15 | }, |
| 16 | "response": [ |
| 17 | "https://cdn.example.com/videos/n90a1b2c3d4e5f6sd25.mp4" |
| 18 | ], |
| 19 | "error_message": null |
| 20 | } |
| 21 | } |
Bac à sable API
Testez l'API dans le navigateur. Remplacez YOUR_API_KEY par votre vraie clé. Chaque appel réussi est facturé.
Codes d'erreur
| Status | Quand cela se produit |
|---|---|
| 400 Mauvaise requête | Un paramètre est manquant ou invalide, par exemple un model, resolution, aspect_ratio, duration ou une URL de média non pris en charge. Le message précise lequel. |
| 401 Non autorisé | Clé API manquante ou invalide. |
| 402 | Crédits insuffisants pour cette tâche. |
| 404 Introuvable | La tâche n'existe pas ou n'a pas été créée avec /v3/generate. |
| 500 Erreur interne du serveur | Erreur serveur. Réessayez plus tard ; les tâches échouées sont remboursées automatiquement. |