Створюйте відео та зображення з власних інструментів

Швидкий старт

1. 1

   Створити ключ

   Створіть API-ключ у вашому дашборді. Він показується лише один раз, тому збережіть його у безпечному місці.

   Управління ключами
2. 2

   Виклик API

   Надішліть POST-запит із вашим Bearer-ключем та заголовком 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

   Опитати результат

   Опитуйте кінцеву точку статусу завдання, доки статус не стане «завершено» або «помилка», потім зчитайте результат.

   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

Автентифікація

Кожен запит автентифікується за допомогою ключа API Bearer у заголовку 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_"
    }
  ]
}

Коди помилок

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.

Використовуйте з Claude Code

Скористайтеся Copy for AI, щоб експортувати повний API як чистий Markdown, вставте його в Claude Code або Codex, і агент сам підключить інтеграцію. Або одразу вкажіть агенту на endpoint із сирим текстом.

Skill

Встановіть навичку Seedance у Claude Code, Codex або будь-якого агента — вона пише кінематографічні промпти та рендерить їх через API за вас.

# 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

Поширені запитання

Хто може використовувати API?

Будь-хто з кредитами. Немає обмежень за тарифом — будь-який акаунт із кредитами може створити ключ і викликати API.

Як отримати кредити?

Поповніть рахунок або підпишіться на сторінці цін. Кредити додаються на ваш баланс миттєво.

Чи поділяються кредити між вебсайтом та API?

Так — ваш особистий кредитний баланс забезпечує як генерацію у веб-інтерфейсі, так і API-запити. У команді API-запити використовують особистий баланс кожного учасника, а не спільний командний пул.

Як почати?

Створіть ключ API у вашій панелі керування, потім викликайте кінцеві точки з токеном Bearer (див. Quickstart вище).

Що робити, якщо виклик повертає insufficient_credits?

Ваш баланс порожній — поповніть на сторінці цін і повторіть спробу.