Documentation Seedance 2.0 API

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

API v1.0 Base URL: https://seedanceapi.org/v1

Démarrage rapide

bash

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

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

Authorization: Bearer YOUR_API_KEY

Tarification

480p

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

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

POST/v1/generateGénérer une nouvelle vidéo

Cré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

Parameter	Type	Requis	Description
`prompt`	string	Requis	Description textuelle de la vidéo à générer (max 2000 caractères)
`aspect_ratio`	string	Optionnel	Ratio d'aspect de sortie. Supportés : 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21 (Par défaut : 1:1)
`resolution`	string	Optionnel	Résolution vidéo : "480p" ou "720p" (Par défaut : 720p)
`duration`	string	Optionnel	Durée de la vidéo en secondes : "4", "8" ou "12" (Par défaut : 8)
`generate_audio`	boolean	Optionnel	Activer la génération audio IA pour la vidéo (Par défaut : false)
`fixed_lens`	boolean	Optionnel	Fixer la caméra pour réduire le flou de mouvement (Par défaut : false)
`image_urls`	string[]	Optionnel	Tableau d'URLs d'images de référence pour image-vers-vidéo (max 1)
`callback_url`	string	Optionnel	URL webhook pour les notifications de statut asynchrones. Doit être accessible publiquement.

Texte vers vidéo

json

{
  "prompt": "A majestic eagle soaring through golden sunset clouds over ocean waves",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "8"
}

Image vers vidéo

json

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

Avec génération audio

json

{
  "prompt": "A peaceful river flowing through a forest with birds singing",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "8",
  "generate_audio": true,
  "fixed_lens": true
}

Réponses

Task created successfully

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "seed15abc123def456pro",
    "status": "IN_PROGRESS"
  }
}

GET/v1/statusObtenir le statut de la tâche

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

Parameter	Type	Requis	Description
`task_id`	string	Requis	L'ID unique de tâche retourné par l'endpoint generate

Exemple de requête

bash

curl -X GET 'https://seedanceapi.org/v1/status?task_id=seed15abc123def456pro' \
  -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

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

Réponses

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "seed15abc123def456pro",
    "status": "SUCCESS",
    "consumed_credits": 28,
    "created_at": "2026-02-07T10:30:00Z",
    "request": {
      "prompt": "A majestic eagle soaring through golden sunset clouds",
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "duration": "8"
    },
    "response": [
      "https://cdn.example.com/videos/seed15abc123def456pro.mp4"
    ],
    "error_message": null
  }
}

Bac à sable API

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

Aire de jeux APIPOST

URL de base

Point de terminaison

En-têtes

Corps de la requête

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