switch_heading
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.
Démarrage rapide
| 1 | curl -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
| 1 | Authorization: Bearer YOUR_API_KEY |
Tarification
480p Résolution
14,25 crédits par seconde, arrondi supérieur par requête
| Durée | Crédits |
|---|---|
| 4s | 57 credits |
| 5s | 72 credits |
| 8s | 114 credits |
| 10s | 143 credits |
| 12s | 171 credits |
| 15s | 214 credits |
720p Résolution
30,75 crédits par seconde, arrondi supérieur par requête
| Durée | Crédits |
|---|---|
| 4s | 123 credits |
| 5s | 154 credits |
| 8s | 246 credits |
| 10s | 308 credits |
| 12s | 369 credits |
| 15s | 462 credits |
Points de terminaison API
/v1/generateCré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
Description textuelle de la vidéo à générer (max 2000 caractères)
Format d'image. Pris en charge : 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, adaptive Defaults to 1:1.
Résolution vidéo : 480p ou 720p Defaults to 720p.
Durée de la vidéo en secondes : entier 4–15 Defaults to 8.
Activer la génération audio IA (n'affecte pas le prix) Defaults to false.
Déprécié — accepté pour compatibilité, ignoré par Seedance 2.0 Mini Defaults to false.
Tableau d'URLs d'images de référence pour image-vers-vidéo (max 1)
URL webhook pour les notifications de statut asynchrones. Doit être accessible publiquement.
Texte vers vidéo
| 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
| 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
| 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 | } |
/v1/statusVé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
L'ID unique de tâche retourné par l'endpoint generate
Exemple de requête
| 1 | curl -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.
| 1 | // Extract video URL from response |
| 2 | const 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.
Codes d'erreur
| Status | Code | Description |
|---|---|---|
| 400 Mauvaise requête | INVALID_PROMPT | Le prompt est invalide ou vide |
| 400 Mauvaise requête | INVALID_ASPECT_RATIO | Ratio d'aspect non supporté |
| 400 Mauvaise requête | INVALID_RESOLUTION | La résolution doit être 480p ou 720p |
| 400 Mauvaise requête | INVALID_DURATION | La durée doit être 4, 8 ou 12 secondes |
| 400 Mauvaise requête | TOO_MANY_IMAGES | Maximum 1 URL d'image autorisée dans le tableau image_urls |
| 401 Non autorisé | INVALID_API_KEY | Clé API manquante ou invalide |
| 402 | INSUFFICIENT_CREDITS | Crédits insuffisants pour cette opération |
| 404 Introuvable | TASK_NOT_FOUND | ID de tâche introuvable ou n'appartient pas à votre compte |
| 500 Erreur interne du serveur | INTERNAL_ERROR | Erreur serveur, veuillez réessayer plus tard |