Clés API Bearer
Envoyez `Authorization: Bearer sk_seedancee2_live_xxxxx` avec chaque requête.
Basée sur le modèle sous-jacent Seedance 2.0, notre API unifie et encapsule les capacités des fournisseurs en amont afin de les exposer sous forme d’API publique standardisée.
Intégrez une seule fois `pro`, `fast` et `mini`, pendant que nous gardons les changements de fournisseurs en amont derrière le même contrat public.
Exécutez la génération vidéo à partir d'un prompt ou d'une image via une seule surface API, sans exposer aux clients les différences propres aux fournisseurs en amont.
Envoyez une demande de génération, interrogez le statut de la tâche ou recevez un webhook lorsque la vidéo est prête, avec une réponse SeeDanceE2 claire.
L'API publique masque les fournisseurs en amont. Les développeurs intègrent trois noms de modèles publics, un seul schéma d'authentification et un seul cycle de vie de tâche asynchrone.
Envoyez `Authorization: Bearer sk_seedancee2_live_xxxxx` avec chaque requête.
Créez une tâche de génération asynchrone, interrogez-la par ID ou recevez des callbacks de fin.
Les réponses exposent les crédits réservés, facturés et remboursés pour que la facturation reste auditable.
Pour les clips destinés aux clients et les travaux de production standard.
Pour les workflows de prévisualisation et les expérimentations de prompts répétées.
Pour les brouillons légers et les générations à budget serré.
Créez une clé API dans votre espace de travail et envoyez-la comme jeton porteur : Authorization: Bearer sk_seedancee2_live_xxxxx à chaque requête.
La génération est asynchrone. Vous soumettez une tâche, recevez un ID de tâche, puis interrogez l'endpoint de statut ou enregistrez un webhook pour être notifié lorsque la vidéo est prête.
Uniquement les niveaux publics pro, fast et mini. La plateforme route chaque requête vers le meilleur modèle vidéo sous-jacent disponible, afin que votre intégration ne casse pas lorsque les fournisseurs changent.
L'utilisation de l'API puise dans le même solde de crédits que l'application web. Les réponses exposent credits_reserved, credits_charged et credits_refunded afin que chaque appel reste auditable.
Oui. Envoyez un prompt texte pour le texte-vers-vidéo, ou joignez l'URL d'une image de référence pour l'image-vers-vidéo ; la composition de l'image est préservée et seul le mouvement décrit est généré.
SeeDanceE2 expose une API publique stable pour la génération de vidéos. Les intégrations doivent utiliser uniquement les noms de modèles publics pro, fast et mini ; les détails des fournisseurs en amont restent derrière le contrat SeeDanceE2.
https://api.SeeDanceE2.aiExemple minimal en curl :
curl -X POST "https://api.SeeDanceE2.ai/v1/videos/generations" \
-H "Authorization: Bearer sk_seedancee2_live_xxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "mini",
"input": {
"prompt": "A cinematic drone shot of waves breaking against black volcanic rocks",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
},
"metadata": {
"customer_job_id": "job_123"
}
}'Exemple minimal en JavaScript :
const response = await fetch("https://api.SeeDanceE2.ai/v1/videos/generations", {
method: "POST",
headers: {
Authorization: "Bearer sk_seedancee2_live_xxxxx",
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "mini",
input: {
prompt: "A cinematic drone shot of waves breaking against black volcanic rocks",
duration: 5,
resolution: "720p",
aspect_ratio: "16:9",
},
metadata: {
customer_job_id: "job_123",
},
}),
});
const result = await response.json();
console.log(result);Exemple minimal en Python :
import requests
response = requests.post(
"https://api.SeeDanceE2.ai/v1/videos/generations",
headers={
"Authorization": "Bearer sk_seedancee2_live_xxxxx",
"Content-Type": "application/json",
},
json={
"model": "mini",
"input": {
"prompt": "A cinematic drone shot of waves breaking against black volcanic rocks",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
},
"metadata": {
"customer_job_id": "job_123",
},
},
timeout=60,
)
print(response.json())Toutes les requêtes utilisent une authentification par jeton porteur.
Authorization: Bearer sk_seedancee2_live_xxxxx
Content-Type: application/jsonVous pouvez également transmettre la clé via x-api-key, mais Authorization: Bearer ... reste la méthode recommandée.
pro, fast et mini.Si vous disposez déjà d'une clé API SeeDanceE2 valide, changer de modèle consiste uniquement à modifier le champ model de la requête. Exemple :
{
"model": "mini"
}devient :
{
"model": "fast"
}ou :
{
"model": "pro"
}Voici les noms de modèles publics à utiliser dans votre intégration.
| Modèle | Positionnement | Durée | Résolution |
|---|---|---|---|
pro | Génération de production en qualité standard | 4-15 s | 480p, 720p, 1080p |
fast | Itérations rapides et workflows de prévisualisation | 4-15 s | 480p, 720p |
mini | Génération à moindre coût | 4-15 s | 480p, 720p |
Les nouvelles intégrations doivent utiliser pro, fast et mini.
Formats d'image pris en charge :
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveLes crédits de l'API publique suivent les mêmes règles de déduction que celles visibles dans le produit SeeDanceE2.
Formule :
credits = duration_seconds * per_second_rate * number_of_outputsLes images, vidéos et audios de référence n'entraînent actuellement aucun surcoût côté client. Les valeurs de crédits réservés et facturés renvoyées par l'API font foi pour chaque tâche.
Tarifs à la seconde actuellement alignés sur les règles de facturation du produit SeeDanceE2 :
| Modèle | 480p | 720p | 1080p |
|---|---|---|---|
pro | 10 crédits/s | 20 crédits/s | 50 crédits/s |
fast | 8 crédits/s | 16 crédits/s | Non pris en charge |
mini | 5 crédits/s | 10 crédits/s | Non pris en charge |
Exemples :
| Scénario | Crédits |
|---|---|
mini, 5 s, 720p | 50 |
pro, 4 s, 480p | 40 |
fast, 10 s, 720p | 160 |
pro, 5 s, 720p, 2 images de référence | 100 |
Si une tâche échoue et ouvre droit à un remboursement, la charge utile de statut renvoyée indique les crédits remboursés.
Statuts de tâche renvoyés par l'API publique :
| Statut | Signification |
|---|---|
pending | Acceptée, en attente de démarrage |
processing | En cours d'exécution |
completed | Terminée avec succès |
failed | Terminée sans résultat exploitable |
POST /v1/videos/generationsChamps de premier niveau de la requête :
| Champ | Type | Requis | Description |
|---|---|---|---|
model | string | Oui | Nom du modèle public : pro, fast ou mini |
input | object | Oui | Paramètres de génération |
callback_url | string | Non | URL de webhook publique pour les callbacks de succès ou d'échec |
metadata | object | Non | Métadonnées définies par le client, renvoyées dans les réponses de polling et de webhook |
Champs d'entrée :
| Champ | Type | Requis | Description |
|---|---|---|---|
prompt | string | Oui | Prompt texte |
generation_type | string | Non | omni_reference ou first_and_last_frames ; par défaut omni_reference |
image_urls | string[] | Non | URL des images de référence |
video_url | string | Non | URL d'une vidéo de référence unique |
video_urls | string[] | Non | URL des vidéos de référence. À ne pas envoyer avec video_url |
audio_urls | string[] | Non | URL des audios de référence |
start_image_url | string | Non | Image de première frame pour first_and_last_frames |
end_image_url | string | Non | Image de dernière frame pour first_and_last_frames |
duration | integer | Non | Durée de sortie en secondes, 4-15 ; par défaut 5 |
resolution | string | Non | 480p, 720p ou 1080p ; les résolutions disponibles dépendent du modèle choisi |
aspect_ratio | string | Non | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 ou adaptive |
generate_audio | boolean | Non | Génère un audio synchronisé lorsque c'est pris en charge |
watermark | boolean | Non | Demande une sortie filigranée |
seed | integer | Non | Graine déterministe |
return_last_frame | boolean | Non | Inclut l'image de la dernière frame dans la charge utile de sortie |
Exemple complet :
curl -X POST "https://api.SeeDanceE2.ai/v1/videos/generations" \
-H "Authorization: Bearer sk_seedancee2_live_xxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "pro",
"callback_url": "https://example.com/webhooks/seedancee2",
"input": {
"prompt": "A cinematic tracking shot through a rain-soaked neon market at night",
"image_urls": [
"https://example-cdn.com/reference-1.png",
"https://example-cdn.com/reference-2.png"
],
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"return_last_frame": true
},
"metadata": {
"customer_job_id": "job_123",
"campaign": "launch_week"
}
}'Réponse en cas de succès :
{
"data": {
"id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
"status": "pending",
"model": "pro",
"credits_reserved": 100,
"created_at": "2026-06-29T10:00:00.000Z"
}
}GET /v1/videos/generations/{id}Exemple de polling :
const response = await fetch(
"https://api.SeeDanceE2.ai/v1/videos/generations/vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
{
headers: {
Authorization: "Bearer sk_seedancee2_live_xxxxx",
},
}
);
const result = await response.json();
console.log(result);Réponse pendant le traitement :
{
"data": {
"id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
"status": "processing",
"model": "pro",
"created_at": "2026-06-29T10:00:00.000Z",
"metadata": {
"customer_job_id": "job_123",
"campaign": "launch_week"
}
}
}Réponse à la fin :
{
"data": {
"id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
"status": "completed",
"model": "pro",
"created_at": "2026-06-29T10:00:00.000Z",
"completed_at": "2026-06-29T10:06:20.000Z",
"credits_charged": 100,
"output": {
"video_url": "https://media.SeeDanceE2.ai/videos/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.mp4",
"thumbnail_url": "https://media.SeeDanceE2.ai/video-posters/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.jpg",
"last_frame_url": "https://media.SeeDanceE2.ai/video-posters/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.jpg"
},
"metadata": {
"customer_job_id": "job_123",
"campaign": "launch_week"
}
}
}Réponse en cas d'échec :
{
"data": {
"id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
"status": "failed",
"model": "pro",
"created_at": "2026-06-29T10:00:00.000Z",
"credits_charged": 0,
"credits_refunded": 100,
"error": {
"code": "generation_failed",
"message": "The video could not be generated. Please try again with a different prompt.",
"type": "generation_error"
},
"metadata": {
"customer_job_id": "job_123",
"campaign": "launch_week"
}
}
}GET /v1/videos/generationsParamètres de requête pris en charge :
| Champ | Type | Description |
|---|---|---|
status | string | Filtre par pending, processing, completed ou failed |
limit | integer | Nombre maximal de résultats. Par défaut 20, maximum 100 |
Exemple :
curl "https://api.SeeDanceE2.ai/v1/videos/generations?status=completed&limit=10" \
-H "Authorization: Bearer sk_seedancee2_live_xxxxx"GET /v1/modelsExemple de réponse :
{
"data": [
{
"id": "pro",
"status": "active",
"resolutions": ["480p", "720p", "1080p"],
"duration": {
"min": 4,
"max": 15
}
}
]
}GET /v1/usageParamètres de requête pris en charge :
| Champ | Type | Description |
|---|---|---|
start | string | Filtre facultatif sur la date de début au format ISO 8601 |
end | string | Filtre facultatif sur la date de fin au format ISO 8601 |
limit | integer | Nombre maximal de lignes de la chronologie quotidienne. Par défaut 30, maximum 365 |
Exemple :
curl "https://api.SeeDanceE2.ai/v1/usage?start=2026-07-01T00:00:00.000Z&end=2026-07-31T23:59:59.999Z&limit=7" \
-H "Authorization: Bearer sk_seedancee2_live_xxxxx"Exemple de réponse :
{
"data": {
"range": {
"start": "2026-07-01T00:00:00.000Z",
"end": "2026-07-31T23:59:59.999Z"
},
"summary": {
"total_jobs": 12,
"pending_jobs": 1,
"processing_jobs": 2,
"completed_jobs": 8,
"failed_jobs": 1,
"credits_charged": 280,
"credits_refunded": 40,
"net_credits": 240
},
"by_model": [
{
"model": "mini",
"total_jobs": 7,
"pending_jobs": 0,
"processing_jobs": 1,
"completed_jobs": 5,
"failed_jobs": 1,
"credits_charged": 120,
"credits_refunded": 20,
"net_credits": 100
},
{
"model": "pro",
"total_jobs": 5,
"pending_jobs": 1,
"processing_jobs": 1,
"completed_jobs": 3,
"failed_jobs": 0,
"credits_charged": 160,
"credits_refunded": 20,
"net_credits": 140
}
],
"timeline": [
{
"date": "2026-07-01",
"total_jobs": 4,
"pending_jobs": 0,
"processing_jobs": 1,
"completed_jobs": 3,
"failed_jobs": 0,
"credits_charged": 100,
"credits_refunded": 0,
"net_credits": 100
}
]
}
}Si callback_url est fourni, SeeDanceE2 envoie une requête POST lorsque la tâche atteint completed ou failed.
En-têtes recommandés à vérifier :
X-Seedancee2-Event: video.generation.completed
X-Seedancee2-Signature: t=1770000000,v1=...Si la signature de webhook est activée sur votre compte, le corps est signé ainsi :
payload_to_sign = "{timestamp}.{raw_json_body}"
signature = hex(hmac_sha256(webhook_secret, payload_to_sign))Charge utile de webhook à la fin :
{
"data": {
"id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
"status": "completed",
"model": "pro",
"created_at": "2026-06-29T10:00:00.000Z",
"completed_at": "2026-06-29T10:06:20.000Z",
"credits_charged": 100,
"output": {
"video_url": "https://media.SeeDanceE2.ai/videos/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.mp4",
"thumbnail_url": "https://media.SeeDanceE2.ai/video-posters/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.jpg"
},
"metadata": {
"customer_job_id": "job_123",
"campaign": "launch_week"
}
}
}Charge utile de webhook en cas d'échec :
{
"data": {
"id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
"status": "failed",
"model": "pro",
"created_at": "2026-06-29T10:00:00.000Z",
"credits_charged": 0,
"credits_refunded": 100,
"error": {
"code": "generation_failed",
"message": "The video could not be generated. Please try again with a different prompt.",
"type": "generation_error"
},
"metadata": {
"customer_job_id": "job_123",
"campaign": "launch_week"
}
}
}Images :
| Exigence | Valeur |
|---|---|
| Formats | JPEG, PNG, WebP, BMP, TIFF, GIF |
| Nombre | Jusqu'à 9 images de référence |
first_and_last_frames | Exactement 2 images |
Vidéos :
| Exigence | Valeur |
|---|---|
video_url | 1 |
video_urls | Jusqu'à 3 |
Audios :
| Exigence | Valeur |
|---|---|
audio_urls | Jusqu'à 3 |
Format d'erreur :
{
"error": {
"code": "insufficient_credits",
"message": "Your credit balance is too low. Please top up.",
"type": "billing_error"
}
}Codes d'erreur publics actuels :
| Statut HTTP | Code | Type | Description |
|---|---|---|---|
| 400 | invalid_request | invalid_request_error | Paramètres manquants ou invalides |
| 401 | invalid_api_key | authentication_error | Clé API absente, invalide ou désactivée |
| 402 | insufficient_credits | billing_error | Solde de crédits insuffisant |
| 404 | model_not_found | invalid_request_error | Le modèle n'existe pas ou est inactif |
| 404 | task_not_found | invalid_request_error | L'identifiant de tâche n'existe pas |
| 500 | internal_error | api_error | Erreur serveur inattendue |
pro, fast et mini.metadata afin de rattacher les callbacks et les résultats de polling à vos dossiers métier.