Generuj filmy i obrazy z własnych narzędzi

Szybki start

1. 1

   Utwórz klucz

   Wygeneruj klucz API w swoim panelu. Jest wyświetlany tylko raz, więc przechowaj go w bezpiecznym miejscu.

   Zarządzaj kluczami
2. 2

   Wywołaj API

   Wyślij żądanie POST z kluczem Bearer i nagłówkiem 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

   Głosowanie na wynik

   Odpytywaj punkt końcowy stanu zadania, aż status zmieni się na „zakończony” lub „nieudany”, a następnie odczytaj wynik.

   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

Uwierzytelnianie

Każde żądanie jest uwierzytelniane za pomocą klucza API typu Bearer w nagłówku 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_"
    }
  ]
}

Kody błędów

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.

Użyj z Claude Code

Skorzystaj z funkcji Copy for AI, aby wyeksportować całe API jako czysty Markdown, wklej go do Claude Code lub Codex i pozwól agentowi podpiąć integrację. Możesz też skierować agenta bezpośrednio na surowy endpoint tekstowy.

Skill

Zainstaluj umiejętność Seedance w Claude Code, Codex lub dowolnym agencie — tworzy kinowe prompty i renderuje je przez API za Ciebie.

# 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

Kto może korzystać z API?

Każdy, kto ma kredyty. Nie ma ograniczenia planu — każde konto z kredytami może utworzyć klucz i wywołać API.

Jak zdobyć kredyty?

Doładuj lub subskrybuj na stronie z cenami. Kredyty są dodawane do salda natychmiast.

Czy kredyty są współdzielone między stroną internetową a API?

Tak — Twoje osobiste saldo kredytów zasila zarówno generowanie w przeglądarce, jak i wywołania API. W zespole wywołania API korzystają z osobistego salda każdego członka, a nie ze wspólnej puli zespołu.

Jak zacząć?

Utwórz klucz API w swoim panelu, a następnie wywołaj endpointy z tokenem Bearer (zobacz Quickstart powyżej).

Co jeśli wywołanie zwraca insufficient_credits?

Twoje saldo jest puste — doładuj na stronie cennika i spróbuj ponownie.