Générer des vidéos et des images à partir de vos propres outils

Démarrage rapide

1. 1

   Créer une clé

   Générez une clé API dans votre tableau de bord. Elle n'est affichée qu'une seule fois, alors conservez-la dans un endroit sûr.

   Gérer les clés
2. 2

   Appeler l'API

   Envoyez une requête POST avec votre clé Bearer et un en-tête Idempotency-Key.

   cURLJavaScriptPython

   Copy

   curl -X POST https://www.seedance2ai.io/api/v1/video/seedance2 \
     -H "Authorization: Bearer $SEEDANCE_API_KEY" \
     -H "Content-Type: application/json" \
     -H "Idempotency-Key: demo-video-001" \
     -d '{
       "mode": "text-to-video",
       "quality_tier": "standard",
       "prompt": "A cinematic shot of a glass train crossing a snowy mountain bridge",
       "aspect_ratio": "16:9",
       "duration": "5",
       "resolution": "720p"
     }'

3. 3

   Vérifier le résultat

   Interrogez l'endpoint de statut de la tâche jusqu'à ce que le statut soit « terminé » ou « échoué », puis lisez la sortie.

   cURLJavaScriptPython

   Copy

   while true; do
     TASK=$(curl -s https://www.seedance2ai.io/api/v1/tasks/sd2_xxxxx \
       -H "Authorization: Bearer $SEEDANCE_API_KEY")
     STATUS=$(echo "$TASK" | jq -r '.status')
     if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then
       echo "$TASK" | jq
       break
     fi
     sleep 10
   done

Authentification

Chaque requête est authentifiée à l'aide d'une clé API Bearer dans l'en-tête Authorization.

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json
Idempotency-Key: a-unique-id-per-request

Tasks and balance

Read endpoints for building a task history, showing remaining credits, or discovering models at runtime. They share the read rate limit.

curl "https://www.seedance2ai.io/api/v1/tasks?limit=20" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

{
  "data": [
    {
      "id": "sd2_xxxxx",
      "type": "video",
      "status": "completed",
      "model": "seedance2",
      "credits_used": 30,
      "result_urls": ["https://..."]
    }
  ],
  "has_more": false,
  "next_cursor": null
}

curl "https://www.seedance2ai.io/api/v1/balance" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

{
  "credits": 1200,
  "subscription_credits": 1000,
  "subscription_credits_expire_at": "2026-07-01T00:00:00.000Z"
}

curl "https://www.seedance2ai.io/api/v1/models" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

{
  "data": [
    {
      "id": "seedance2",
      "name": "Seedance 2.0",
      "type": "video",
      "method": "POST",
      "endpoint": "/api/v1/video/seedance2",
      "modes": ["text-to-video", "image-to-video", "media-to-video"],
      "task_id_prefix": "sd2_"
    }
  ]
}

Codes d'erreur

Every error has the same shape. Branch on code, and show message to a person. A task that was accepted can still fail later, so also check status when you poll.

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request body: prompt: String must contain at least 3 character(s)"
  }
}

Rate limits

A request over the limit returns HTTP 429 with a Retry-After header in seconds, plus X-RateLimit-Limit and X-RateLimit-Reset. Wait that long, then retry with the same Idempotency-Key.

Submit a job

30 per 60 seconds

Every POST endpoint, counted per account across all of its keys.

Read

120 per 60 seconds

Task status, task list, balance and models. Counted separately, so polling never uses up the submit budget.

Reference media validation

3 per 60 seconds

Seedance requests that include reference media, per account and source IP.

Utiliser avec Claude Code

Utilisez Copy for AI pour exporter l'API complète en Markdown propre, collez-le dans Claude Code ou Codex, et laissez l'agent se charger de l'intégration. Ou pointez l'agent directement vers le endpoint de texte brut.

Skill

Installez la compétence Seedance dans Claude Code, Codex ou tout autre agent — elle rédige des prompts cinématographiques et les génère via l'API pour vous.

# Download the one-file skill from Seedance 2.0 AI
mkdir -p ~/.claude/skills/seedance
curl --fail --location -H "Authorization: Bearer $SEEDANCE_API_KEY" https://www.seedance2ai.io/downloads/seedance-skill.md -o ~/.claude/skills/seedance/SKILL.md.tmp &&
mv ~/.claude/skills/seedance/SKILL.md.tmp ~/.claude/skills/seedance/SKILL.md

FAQ

Qui peut utiliser l'API ?

Tout utilisateur disposant de crédits. Aucune restriction de forfait — n'importe quel compte avec des crédits peut créer une clé et appeler l'API.

Comment obtenir des crédits ?

Rechargez ou abonnez-vous sur la page des tarifs. Les crédits sont ajoutés à votre solde instantanément.

Les crédits sont-ils partagés entre le site web et l'API ?

Oui — votre solde de crédits personnel alimente à la fois vos générations web et vos appels API. Dans une équipe, les appels API utilisent le solde personnel de chaque membre, et non le pool partagé de l'équipe.

Par où commencer ?

Créez une clé API dans votre tableau de bord, puis appelez les endpoints avec un jeton Bearer (voir le Quickstart ci-dessus).

Que faire si un appel renvoie insufficient_credits ?

Votre solde est vide — rechargez sur la page des tarifs et réessayez.