Kendi araçlarınızdan video ve görseller üretin

Hızlı Başlangıç

1. 1

   Anahtar Oluştur

   Panonuzda bir API anahtarı oluşturun. Yalnızca bir kez gösterilir, bu yüzden güvenli bir yerde saklayın.

   Anahtarları Yönet
2. 2

   API'yi çağır

   POST isteğinizi, Bearer anahtarınız ve bir Idempotency-Key başlığı ile gönderin.

   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

   Sonucu sorgula

   Görev durumu tamamlanana veya başarısız olana kadar durum uç noktasını yoklayın, ardından çıktıyı okuyun.

   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

Kimlik Doğrulama

Her istek, Authorization başlığındaki bir Bearer API anahtarı ile doğrulanır.

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

Hata kodları

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 ile Kullan

Copy for AI kullanarak API'nin tamamını temiz bir Markdown olarak dışa aktarın, Claude Code veya Codex'e yapıştırın ve entegrasyonu agent'ın kurmasını sağlayın. Ya da agent'ı doğrudan ham metin endpoint'ine yönlendirin.

Skill

Seedance becerisini Claude Code, Codex veya herhangi bir ajana yükleyin — size sinematik promptlar yazar ve bunları API üzerinden render eder.

# 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

SSS

API'yi kimler kullanabilir?

Kredisi olan herkes. Plan engeli yoktur — kredisi olan her hesap bir anahtar oluşturup API'yi çağırabilir.

Kredileri nasıl alabilirim?

Fiyatlandırma sayfasından bakiye yükleyin veya abone olun. Krediler anında bakiyenize eklenir.

Web sitesi ve API kredileri paylaşılıyor mu?

Evet — kişisel kredi bakiyeniz hem web üretiminiz hem de API çağrılarınız için kullanılır. Bir ekipte, API çağrıları her üyenin kendi kişisel bakiyesini kullanır, ortak ekip havuzunu değil.

Nasıl başlarım?

Kontrol panelinizde bir API anahtarı oluşturun, ardından uç noktaları bir Bearer token ile çağırın (yukarıdaki Hızlı Başlangıç'a bakın).

Bir çağrı insufficient_credits döndürürse ne olur?

Bakiyeniz boş — fiyatlandırma sayfasından yükleyip tekrar deneyin.