label llms.txt open_chatgpt

Documentation Seedance 2.0 Mini API

Guide complet pour intégrer l'API de génération vidéo Seedance 2.0 Mini dans vos applications.

API v1 · 2.0 Mini Base URL: https://seedanceapi.org/v1

Démarrage rapide

bash
1curl -X POST 'https://seedanceapi.org/v1/generate' \
2 -H 'Authorization: Bearer YOUR_API_KEY' \
3 -H 'Content-Type: application/json' \
4 -d '{
5 "prompt": "A cinematic shot of mountains at sunrise with flowing clouds",
6 "aspect_ratio": "16:9",
7 "resolution": "720p",
8 "duration": "8"
9 }'

Authentification

Toutes les requêtes API nécessitent une authentification avec un jeton Bearer dans l'en-tête Authorization.

Important: Vous pouvez obtenir votre clé API depuis la page API Keys dans votre tableau de bord. → Obtenir votre clé API

http
1Authorization: Bearer YOUR_API_KEY

Tarification

480p

480p Résolution

14,25 crédits par seconde, arrondi supérieur par requête

DuréeCrédits
4s57 credits
5s72 credits
8s114 credits
10s143 credits
12s171 credits
15s214 credits
720p

720p Résolution

30,75 crédits par seconde, arrondi supérieur par requête

DuréeCrédits
4s123 credits
5s154 credits
8s246 credits
10s308 credits
12s369 credits
15s462 credits

Points de terminaison API

POST/v1/generate

Créer une nouvelle tâche de génération vidéo avec le modèle Seedance 2.0 Mini. Supporte texte-vers-vidéo et image-vers-vidéo.

Corps de la requête

Body ParametersJSON
prompt:string

Description textuelle de la vidéo à générer (max 2000 caractères)

aspect_ratio:optional string

Format d'image. Pris en charge : 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, adaptive Defaults to 1:1.

resolution:optional string

Résolution vidéo : 480p ou 720p Defaults to 720p.

duration:optional string

Durée de la vidéo en secondes : entier 4–15 Defaults to 8.

generate_audio:optional boolean

Activer la génération audio IA (n'affecte pas le prix) Defaults to false.

fixed_lens:optional boolean

Déprécié — accepté pour compatibilité, ignoré par Seedance 2.0 Mini Defaults to false.

image_urls:optional string[]

Tableau d'URLs d'images de référence pour image-vers-vidéo (max 1)

callback_url:optional string

URL webhook pour les notifications de statut asynchrones. Doit être accessible publiquement.

Texte vers vidéo

json
1{
2 "prompt": "A majestic eagle soaring through golden sunset clouds over ocean waves",
3 "aspect_ratio": "16:9",
4 "resolution": "720p",
5 "duration": "8"
6}

Image vers vidéo

json
1{
2 "prompt": "The character slowly turns and smiles at the camera",
3 "image_urls": [
4 "https://example.com/my-image.jpg"
5 ],
6 "aspect_ratio": "16:9",
7 "resolution": "720p",
8 "duration": "4"
9}

Avec génération audio

json
1{
2 "prompt": "A peaceful river flowing through a forest with birds singing",
3 "aspect_ratio": "16:9",
4 "resolution": "720p",
5 "duration": "8",
6 "generate_audio": true
7}

Réponses

Task created successfully

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n90abc123def456_seedance",
6 "status": "IN_PROGRESS"
7 }
8}
GET/v1/status

Vérifier le statut d'une tâche de génération vidéo et récupérer le résultat une fois terminée.

Paramètres de requête

Body ParametersJSON
task_id:string

L'ID unique de tâche retourné par l'endpoint generate

Exemple de requête

bash
1curl -X GET 'https://seedanceapi.org/v1/status?task_id=n90abc123def456_seedance' \
2 -H 'Authorization: Bearer YOUR_API_KEY'

💡 Tip: Le champ response dans l'API de statut est un tableau d'URLs vidéo. Accédez directement à data.response[0] pour obtenir l'URL vidéo.

javascript
1// Extract video URL from response
2const videoUrl = data.response[0];

Réponses

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n90abc123def456_seedance",
6 "status": "SUCCESS",
7 "consumed_credits": 246,
8 "created_at": "2026-02-07T10:30:00Z",
9 "request": {
10 "prompt": "A majestic eagle soaring through golden sunset clouds",
11 "aspect_ratio": "16:9",
12 "resolution": "720p",
13 "duration": "8"
14 },
15 "response": [
16 "https://cdn.example.com/videos/n90abc123def456_seedance.mp4"
17 ],
18 "error_message": null
19 }
20}

Bac à sable API

Testez l'API directement depuis votre navigateur. Remplacez YOUR_API_KEY par votre véritable clé API.

Aire de jeux APIPOST

Codes d'erreur

StatusCodeDescription
400 Mauvaise requêteINVALID_PROMPTLe prompt est invalide ou vide
400 Mauvaise requêteINVALID_ASPECT_RATIORatio d'aspect non supporté
400 Mauvaise requêteINVALID_RESOLUTIONLa résolution doit être 480p ou 720p
400 Mauvaise requêteINVALID_DURATIONLa durée doit être 4, 8 ou 12 secondes
400 Mauvaise requêteTOO_MANY_IMAGESMaximum 1 URL d'image autorisée dans le tableau image_urls
401 Non autoriséINVALID_API_KEYClé API manquante ou invalide
402 INSUFFICIENT_CREDITSCrédits insuffisants pour cette opération
404 IntrouvableTASK_NOT_FOUNDID de tâche introuvable ou n'appartient pas à votre compte
500 Erreur interne du serveurINTERNAL_ERRORErreur serveur, veuillez réessayer plus tard