API développeur

Construisez avec SeeDanceE2.ai.

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.

model: promodel: fastmodel: mini
Contrat API stable

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.

Workflows texte et image

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.

Tâches asynchrones, polling, webhooks

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.

Contrat public

Une seule surface d'API pour la génération vidéo

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.

Authentification

Clés API Bearer

Envoyez `Authorization: Bearer sk_seedancee2_live_xxxxx` avec chaque requête.

Cycle de vie des tâches

Envoi, polling, webhook

Créez une tâche de génération asynchrone, interrogez-la par ID ou recevez des callbacks de fin.

Utilisation et crédits

Réservés et facturés

Les réponses exposent les crédits réservés, facturés et remboursés pour que la facturation reste auditable.

Noms de modèles publics

Utilisez uniquement `pro`, `fast` et `mini`

pro

Qualité de production

Pour les clips destinés aux clients et les travaux de production standard.

480p, 720p, 1080p
fast

Itération plus rapide

Pour les workflows de prévisualisation et les expérimentations de prompts répétées.

480p, 720p
mini

Tests à moindre coût

Pour les brouillons légers et les générations à budget serré.

480p, 720p
Questions sur l'API

Questions fréquentes

Comment authentifier les requêtes vers l'API de génération vidéo ?

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.

L'API est-elle synchrone ou asynchrone ?

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.

Quels noms de modèles puis-je demander ?

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.

Comment fonctionne la facturation de l'API ?

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.

L'API gère-t-elle l'image-vers-vidéo comme le texte-vers-vidéo ?

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

API vidéo publique SeeDanceE2

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.

URL de base

https://api.SeeDanceE2.ai

Démarrage rapide

  1. Obtenez une clé API auprès de l'équipe SeeDanceE2.
  2. Créez une tâche de génération vidéo.
  3. Interrogez la tâche ou recevez un webhook à la fin.

Exemple 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())

Authentification

Toutes les requêtes utilisent une authentification par jeton porteur.

Authorization: Bearer sk_seedancee2_live_xxxxx
Content-Type: application/json

Vous pouvez également transmettre la clé via x-api-key, mais Authorization: Bearer ... reste la méthode recommandée.

Clés API et accès aux modèles

  • Votre clé API SeeDanceE2 est émise par l'équipe SeeDanceE2 ou depuis votre profil.
  • La même clé API SeeDanceE2 fonctionne avec tous les modèles publics : pro, fast et mini.
  • Vous n'avez pas besoin de clés API distinctes pour Mini, Fast ou Pro.
  • Les identifiants des fournisseurs en amont sont gérés par SeeDanceE2 et ne sont jamais requis dans les requêtes client.

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"
}

Modèles publics

Voici les noms de modèles publics à utiliser dans votre intégration.

ModèlePositionnementDuréeRésolution
proGénération de production en qualité standard4-15 s480p, 720p, 1080p
fastItérations rapides et workflows de prévisualisation4-15 s480p, 720p
miniGénération à moindre coût4-15 s480p, 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, adaptive

Crédits

Les 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_outputs

Les 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èle480p720p1080p
pro10 crédits/s20 crédits/s50 crédits/s
fast8 crédits/s16 crédits/sNon pris en charge
mini5 crédits/s10 crédits/sNon pris en charge

Exemples :

ScénarioCrédits
mini, 5 s, 720p50
pro, 4 s, 480p40
fast, 10 s, 720p160
pro, 5 s, 720p, 2 images de référence100

Si une tâche échoue et ouvre droit à un remboursement, la charge utile de statut renvoyée indique les crédits remboursés.

Cycle de vie des tâches

Statuts de tâche renvoyés par l'API publique :

StatutSignification
pendingAcceptée, en attente de démarrage
processingEn cours d'exécution
completedTerminée avec succès
failedTerminée sans résultat exploitable

Créer une tâche vidéo

POST /v1/videos/generations

Champs de premier niveau de la requête :

ChampTypeRequisDescription
modelstringOuiNom du modèle public : pro, fast ou mini
inputobjectOuiParamètres de génération
callback_urlstringNonURL de webhook publique pour les callbacks de succès ou d'échec
metadataobjectNonMétadonnées définies par le client, renvoyées dans les réponses de polling et de webhook

Champs d'entrée :

ChampTypeRequisDescription
promptstringOuiPrompt texte
generation_typestringNonomni_reference ou first_and_last_frames ; par défaut omni_reference
image_urlsstring[]NonURL des images de référence
video_urlstringNonURL d'une vidéo de référence unique
video_urlsstring[]NonURL des vidéos de référence. À ne pas envoyer avec video_url
audio_urlsstring[]NonURL des audios de référence
start_image_urlstringNonImage de première frame pour first_and_last_frames
end_image_urlstringNonImage de dernière frame pour first_and_last_frames
durationintegerNonDurée de sortie en secondes, 4-15 ; par défaut 5
resolutionstringNon480p, 720p ou 1080p ; les résolutions disponibles dépendent du modèle choisi
aspect_ratiostringNon16:9, 4:3, 1:1, 3:4, 9:16, 21:9 ou adaptive
generate_audiobooleanNonGénère un audio synchronisé lorsque c'est pris en charge
watermarkbooleanNonDemande une sortie filigranée
seedintegerNonGraine déterministe
return_last_framebooleanNonInclut 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"
  }
}

Récupérer une tâche vidéo

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"
    }
  }
}

Lister les tâches vidéo

GET /v1/videos/generations

Paramètres de requête pris en charge :

ChampTypeDescription
statusstringFiltre par pending, processing, completed ou failed
limitintegerNombre 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"

Lister les modèles

GET /v1/models

Exemple de réponse :

{
  "data": [
    {
      "id": "pro",
      "status": "active",
      "resolutions": ["480p", "720p", "1080p"],
      "duration": {
        "min": 4,
        "max": 15
      }
    }
  ]
}

Résumé d'utilisation

GET /v1/usage

Paramètres de requête pris en charge :

ChampTypeDescription
startstringFiltre facultatif sur la date de début au format ISO 8601
endstringFiltre facultatif sur la date de fin au format ISO 8601
limitintegerNombre 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
      }
    ]
  }
}

Webhooks

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"
    }
  }
}

Règles sur les entrées

Images :

ExigenceValeur
FormatsJPEG, PNG, WebP, BMP, TIFF, GIF
NombreJusqu'à 9 images de référence
first_and_last_framesExactement 2 images

Vidéos :

ExigenceValeur
video_url1
video_urlsJusqu'à 3

Audios :

ExigenceValeur
audio_urlsJusqu'à 3

Erreurs

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 HTTPCodeTypeDescription
400invalid_requestinvalid_request_errorParamètres manquants ou invalides
401invalid_api_keyauthentication_errorClé API absente, invalide ou désactivée
402insufficient_creditsbilling_errorSolde de crédits insuffisant
404model_not_foundinvalid_request_errorLe modèle n'existe pas ou est inactif
404task_not_foundinvalid_request_errorL'identifiant de tâche n'existe pas
500internal_errorapi_errorErreur serveur inattendue

Notes d'intégration

  • Utilisez uniquement les noms de modèles publics tels que pro, fast et mini.
  • Ne construisez pas de logique reposant sur des noms de fournisseurs internes, des identifiants de tâche internes ou des hôtes média internes.
  • Stockez vos propres metadata afin de rattacher les callbacks et les résultats de polling à vos dossiers métier.
  • En production, privilégiez les webhooks pour la notification de fin et conservez le polling comme solution de repli.