Seedance 2.5.
Au cœur de votre produit.

Votre première vidéo en quelques requêtes.

Enregistrez votre clé sous SEADANCE_API_KEY sur votre serveur. Attribuez à SEADANCE_REQUEST_KEY une valeur unique pour cette vidéo (par exemple avec uuidgen) et conservez cette valeur pour les nouvelles tentatives. Vérifiez que votre compte dispose de suffisamment de crédits. Cet exemple réserve 350 crédits pour une vidéo de 5 secondes en 720p. Copiez l’id renvoyé pour consulter son état.

export SEADANCE_API_KEY="sd_live_your_key"
# Keep this value for retries; choose a new value for a new video.
export SEADANCE_REQUEST_KEY="${SEADANCE_REQUEST_KEY:-$(uuidgen)}"

curl --fail-with-body "https://seedance3ai.dev/api/v1/videos" \
  -H "Authorization: Bearer $SEADANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SEADANCE_REQUEST_KEY" \
  --data '{
  "model": "seedance-2.5",
  "mode": "text-to-video",
  "prompt": "A paper boat floating through a sunlit stream, gentle camera movement",
  "aspectRatio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

Cette documentation ne lance jamais de génération automatiquement. L’envoi d’une requête de création consomme vos crédits.

Authentifiez-vous depuis votre serveur.

Chaque appel API utilise Authorization: Bearer sd_live_…. Ne placez pas les clés dans les navigateurs, les applications mobiles, les dépôts publics ou le code côté client. La clé complète n’est affichée qu’une fois ; vous pouvez la révoquer dans le tableau de bord de l’API.

Autorisations par défaut des clés : videos:write pour les imports et la génération ; videos:read pour les modèles et l’état des tâches ; account:read pour les crédits. L’accès et les limites du compte s’appliquent à toutes les clés.

Créez une tâche vidéo.

Utilisez Content-Type: application/json et un Idempotency-Key unique pour chaque génération prévue. Le serveur peut mettre du temps à obtenir l’acceptation de la tâche par le fournisseur. Si votre connexion expire, renvoyez le même corps avec la même clé. HTTP 202 signifie que la tâche est acceptée, pas terminée. Idempotency-Key accepte de 1 à 128 caractères ASCII imprimables sans espaces.

Ces champs permettent à Seedance 2.5 de prendre en charge le texte, les premières et dernières images, les références multimodales, le montage et la prolongation vidéo. GET /models est la référence à jour pour les fonctionnalités et les tarifs disponibles.

{
  "model": "seedance-2.5",
  "mode": "image-to-video",
  "prompt": "A paper boat floating through a sunlit stream, gentle camera movement",
  "aspectRatio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "firstFrameUrl": "YOUR_UPLOADED_PUBLIC_OBJECT_URL"
}

{
  "model": "seedance-2.5",
  "mode": "reference-to-video",
  "prompt": "A paper boat floating through a sunlit stream, gentle camera movement",
  "aspectRatio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "referenceImageUrls": [
    "YOUR_UPLOADED_IMAGE_URL"
  ],
  "referenceVideoUrls": [
    "YOUR_UPLOADED_VIDEO_URL"
  ]
}

Importez une fois. Référencez par URL.

Envoyez POST /uploads avec fileName, contentType, size (en octets) et kind (image, video ou audio). Avant expiresAt, envoyez les octets bruts du fichier vers uploadUrl avec PUT et les en-têtes requiredHeaders. Une fois l’import réussi, utilisez publicObjectUrl dans la requête de génération. Les références doivent appartenir au même compte ; les URL externes arbitraires et les entrées en base64 ne sont pas acceptées.

// Node.js 20+ · upload once, then use publicObjectUrl
import { readFile } from "node:fs/promises";

const bytes = await readFile("./first-frame.jpg");
const signed = await fetch("https://seedance3ai.dev/api/v1/uploads", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SEADANCE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    fileName: "first-frame.jpg", contentType: "image/jpeg",
    size: bytes.length, kind: "image",
  }),
});
const upload = await signed.json();
if (!signed.ok) throw new Error(JSON.stringify(upload));
const stored = await fetch(upload.uploadUrl, {
  method: "PUT", headers: upload.requiredHeaders, body: bytes,
});
if (!stored.ok) throw new Error("Upload failed");
console.log(upload.publicObjectUrl);
// Use this URL as firstFrameUrl in an image-to-video request.

La taille et le type de contenu déclarés doivent correspondre au fichier importé. Les URL d’import expirent ; demandez-en une autre si nécessaire. La durée, les dimensions et le format des médias sont validés avant la génération.

Suivez la tâche jusqu’à son terme.

GET /videos/:id renvoie la tâche actuelle. Interrogez-la toutes les 5–10 secondes, arrêtez-vous à succeeded ou failed et respectez le délai indiqué par Retry-After s’il est présent. Les requêtes sont limitées aux tâches API de votre compte. L’intégration actuelle utilise des interrogations périodiques.

curl --fail-with-body "https://seedance3ai.dev/api/v1/videos/TASK_ID" \
  -H "Authorization: Bearer $SEADANCE_API_KEY"

{
  "id": "a1b2c3d4-1234-4567-8901-abcdef123456",
  "status": "succeeded",
  "credits_reserved": 350,
  "created_at": "2026-10-27T00:00:00.000Z",
  "output": {
    "url": "https://your-result-host.example/video.mp4"
  },
  "error": null,
  "refund_status": "not_applicable"
}

output vaut null tant qu’aucune vidéo n’est disponible. Une tâche échouée inclut une erreur ; consultez refund_status pour connaître l’état du remboursement des crédits. Téléchargez rapidement les résultats réussis. Supprimer une vidéo ne réinitialise pas sa requête : réutiliser cet Idempotency-Key renvoie 410 video_deleted et ne peut pas la recréer.

Comprenez le coût en crédits avant d’intégrer.

La génération via l’API utilise les mêmes crédits du compte et les mêmes tarifs Seedance 2.5 que le site. Les crédits sont réservés lorsqu’une requête est acceptée. Si la génération échoue, ces crédits sont reversés au solde de crédits hors abonnement. Un échec de validation avant la création de la tâche ne produit pas de vidéo facturable.

Coût = durée de sortie × tarif de sortie, plus la durée des éventuelles vidéos de référence × tarif de référence. La durée des vidéos de référence est mesurée sur le serveur ; le total est arrondi à la seconde entière inférieure pour la facturation. Le son natif est inclus. Par exemple, 5 secondes en 720p coûtent 350 crédits, ou 600 crédits avec une vidéo de référence de 5 secondes.

curl --fail-with-body "https://seedance3ai.dev/api/v1/models" \
  -H "Authorization: Bearer $SEADANCE_API_KEY"

curl --fail-with-body "https://seedance3ai.dev/api/v1/credits" \
  -H "Authorization: Bearer $SEADANCE_API_KEY"

Consultez les crédits disponibles, l’historique des requêtes et les limites du compte dans le tableau de bord de l’API. Ajoutez des crédits via la page des tarifs du site avec le même compte ; il n’existe ni solde distinct ni point de terminaison de recharge pour l’API. Aucun abonnement actif n’est nécessaire si vos crédits disponibles sont suffisants. Les règles d’expiration de l’abonnement et des crédits hors abonnement sont les mêmes que sur le site.

Ajouter des crédits n’augmente pas les limites de fréquence, de simultanéité ou d’utilisation quotidienne de l’API et ne réactive pas un compte désactivé. La limite quotidienne comptabilise tous les crédits réservés, y compris ceux des échecs remboursés, et se réinitialise à 00:00 UTC. Contactez l’assistance si votre application a besoin de limites plus élevées.

Réessayez en toute sécurité. Évitez les doubles débits.

Utilisez un Idempotency-Key par vidéo prévue et conservez-le avec le corps exact de la requête jusqu’à connaître le résultat. Les nouvelles clés représentent de nouvelles générations. Une réponse d’erreur contient error.code, error.message et request_id ; indiquez l’ID de la requête lorsque vous contactez l’assistance.