label llms.txt open_chatgpt

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.

API v3 · 2.5 / 2.5 Flash Base URL: https://seedanceapi.org/v3

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

bash
1curl -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

http
1Authorization: Bearer YOUR_API_KEY

Modes de génération

ModeChamps à envoyer
Texte en vidéoprompt + 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 imageprompt + first_frame_url (+ last_frame_url)
Montage vidéoprompt + 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.

2.5

Seedance 2.5

Qualité maximale, prend en charge 480p, 720p et le 4K natif.

RésolutionEntréeTarifExemple
480pTexte / images / audio28 crédits / s10 s de sortie = 280 crédits
480pAvec vidéo de référence17 crédits / s5 s de référence + 10 s de sortie = 255 crédits
720pTexte / images / audio63 crédits / s10 s de sortie = 630 crédits
720pAvec vidéo de référence38 crédits / s5 s de référence + 10 s de sortie = 570 crédits
4kTexte / images / audio251 crédits / s10 s de sortie = 2510 crédits
4kAvec vidéo de référence155 crédits / s5 s de référence + 10 s de sortie = 2325 crédits
Flash

Seedance 2.5 Flash

Plus rapide et moins cher, prend en charge 480p et 720p.

RésolutionEntréeTarifExemple
480pTexte / images / audio18.5 crédits / s10 s de sortie = 185 crédits
480pAvec vidéo de référence11.5 crédits / s5 s de référence + 10 s de sortie = 173 crédits
720pTexte / images / audio41 crédits / s10 s de sortie = 410 crédits
720pAvec vidéo de référence25.5 crédits / s5 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

POST/v3/generate

Lancez 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

Body ParametersJSON
prompt:string

Prompt texte (obligatoire, jusqu'à 5000 caractères).

model:optional string

seedance-2.5 (par défaut) ou seedance-2.5-flash. Defaults to seedance-2.5.

duration:optional number

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.

resolution:optional string

Seedance 2.5 : 480p, 720p ou 4k. Seedance 2.5 Flash : 480p ou 720p. 1080p n'est pas disponible. Defaults to 720p.

aspect_ratio:optional string

16:9, 9:16, 4:3, 3:4 ou adaptive. Le montage vidéo exige adaptive. Defaults to 16:9.

image_urls:optional string[]

Jusqu'à 4 URL d'images de référence (http/https). Décrivez dans le prompt comment chaque image doit être utilisée.

first_frame_url:optional string

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.

last_frame_url:optional string

URL d'image facultative utilisée comme dernière image. Nécessite first_frame_url.

reference_video_urls:optional string[]

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.

reference_audio_urls:optional string[]

Jusqu'à 3 URL d'audio de référence, par exemple de la musique ou une piste vocale.

generate_audio:optional boolean

Génère une bande-son en même temps que la vidéo. Defaults to true.

web_search:optional boolean

Permet au modèle de rechercher sur le web les sujets du prompt. Defaults to false.

callback_url:optional string

Webhook facultatif appelé à la fin de la tâche (URL publique ; localhost n'est pas autorisé).

public:optional boolean

Facultatif : autoriser l'affichage du résultat dans la galerie publique.

Texte en vidéo

json
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

json
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)

json
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

json
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

json
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}
GET/v3/status

Interrogez 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

Body ParametersJSON
task_id:string

Identifiant de tâche renvoyé par POST /v3/generate (se termine par sd25).

Exemple de requête

bash
1curl -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.

javascript
1const 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é.

Aire de jeux APIPOST

Codes d'erreur

StatusQuand cela se produit
400 Mauvaise requêteUn 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 IntrouvableLa tâche n'existe pas ou n'a pas été créée avec /v3/generate.
500 Erreur interne du serveurErreur serveur. Réessayez plus tard ; les tâches échouées sont remboursées automatiquement.