Genel API

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

Bir anahtar oluşturun, API'yi Bearer auth ile çağırın ve sonucunuz hazır olana kadar görev durumunu yoklayın. Claude Code, Codex ve herhangi bir HTTP istemcisiyle çalışır.

Anahtarları Yönet

Hızlı Başlangıç

Adım 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.

Adım 2

API'yi çağır

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

Adım 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.

Kimlik Doğrulama

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

http

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

Seedance 2 Video

Metin, görsel veya medyadan videoya.

İş Gönder

POST

/api/v1/video/seedance2

Parametreler

Parametre	Tip	Zorunlu	Varsayılan	İzin verilen değerler
`mode` Generation mode.	`string`	İsteğe bağlı	`text-to-video`	`text-to-videoimage-to-videomedia-to-video`
`quality_tier` Quality tier.	`string`	İsteğe bağlı	`standard`	`standardpro`
`channel` Rendering channel.	`string`	İsteğe bağlı	`standard`	`standardrealwild`
`prompt` Text prompt.	`string`	Zorunlu	`—`	`3–10000 chars`
`aspect_ratio` Aspect ratio.	`string`	İsteğe bağlı	`16:9`	`1:121:94:33:416:99:16`
`duration` Clip duration.	`string`	İsteğe bağlı	`5`	`4–15 (seconds)`
`resolution` Output resolution.	`string`	İsteğe bağlı	`720p`	`720p1080p`
`image_url` Start frame — required for image-to-video.	`string (URL)`	İsteğe bağlı	`—`	`public https URL`
`end_image_url` Optional end frame.	`string (URL)`	İsteğe bağlı	`—`	`public https URL`
`media_urls` Required for media-to-video.	`string[] (URL)`	İsteğe bağlı	`—`	`≤ 12 public https URLs`
`generate_audio` Generate an audio track.	`boolean`	İsteğe bağlı	`true`	`truefalse`
`fixed_lens` Lock the camera lens.	`boolean`	İsteğe bağlı	`false`	`truefalse`
`seed` Not supported on the real channel.	`integer`	İsteğe bağlı	`—`	`-1 – 4294967295`

İstek

bash

curl -X POST https://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"
  }'

Yanıt202

json

{
  "id": "sd2_xxxxx",
  "status": "processing",
  "model": "seedance2",
  "quality_tier": "standard",
  "channel": "standard",
  "credits_used": 30
}

Görev Durumunu Kontrol Et

GET

/api/v1/tasks/{id}

İstek

bash

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

Yanıt200

json

{
  "id": "sd2_xxxxx",
  "status": "completed",
  "model": "seedance2",
  "quality_tier": "standard",
  "channel": "standard",
  "credits_used": 30,
  "credits_refunded": 0,
  "output": {
    "video_url": "https://...",
    "last_frame_url": "https://...",
    "seed": 123
  },
  "error": null,
  "created_at": "2026-06-03T10:00:00.000Z",
  "updated_at": "2026-06-03T10:03:12.000Z"
}

status: processing · completed · failed

Hata kodları

All errors share this shape:

json

{ "error": { "code": "invalid_request", "message": "Invalid request body" } }

Kod	HTTP	Anlam
`unauthorized`	`401`	Missing, invalid, or revoked API key.
`invalid_request`	`400`	Bad input or unsupported field.
`insufficient_credits`	`402`	Not enough credits on the balance.
`rate_limited`	`429`	Too many requests — limit is 30 requests per 60 seconds per account. Retry after the Retry-After response header (in seconds).
`idempotency_conflict`	`409`	Same Idempotency-Key reused with a different body, or still running.
`service_busy`	`503`	Temporary upstream or credit-concurrency issue. Retry.
`not_found`	`404`	Task does not exist or does not belong to this key owner.
`internal_error`	`500`	Unexpected server-side failure.

Claude Code ile Kullan

AI için Kopyala'ya tıklayarak API'nin tamamını temiz Markdown olarak alın, Claude Code veya Codex'e yapıştırın ve entegrasyonu ayarlamasına izin verin. Veya aracıyı doğrudan ham metin uç noktasına yönlendirin.

Aç llms.txt

Skill

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

bash

# Clone into Claude Code's skills folder
git clone https://github.com/tkaptop/seedance-skill ~/.claude/skills/seedance

GitHub'da Görüntüle

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.