Documentation Seedance 2.0 API
Guide complet pour intégrer l'API de génération vidéo Seedance 2.0 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
Génération rapide, idéale pour les aperçus et brouillons
| Durée | Sans audio | Avec audio |
|---|---|---|
| 4s | 8 credits ($0.04) | 14 credits ($0.07) |
| 8s | 14 credits ($0.07) | 28 credits ($0.14) |
| 12s | 19 credits ($0.095) | 38 credits ($0.19) |
720p Résolution
Sortie haute qualité, recommandée pour la production
| Durée | Sans audio | Avec audio |
|---|---|---|
| 4s | 14 credits ($0.07) | 28 credits ($0.14) |
| 8s | 28 credits ($0.14) | 56 credits ($0.28) |
| 12s | 42 credits ($0.21) | 84 credits ($0.42) |
Points de terminaison API
/v1/generateCréer une nouvelle tâche de génération vidéo avec le modèle Seedance 2.0. 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)
Ratio d'aspect de sortie. Supportés : 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21 Defaults to 1:1.
Résolution vidéo : 480p ou 720p Defaults to 720p.
Durée de la vidéo en secondes : 4, 8 ou 12 Defaults to 8.
Activer la génération audio IA pour la vidéo Defaults to false.
Fixer la caméra pour réduire le flou de mouvement 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 | "fixed_lens": true |
| 8 | } |
Réponses
Task created successfully
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "seed15abc123def456pro", |
| 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=seed15abc123def456pro' \ |
| 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": "seed15abc123def456pro", |
| 6 | "status": "SUCCESS", |
| 7 | "consumed_credits": 28, |
| 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/seed15abc123def456pro.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 |