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 Video

Metin, görsel veya medyadan videoya.

POST

/api/v1/video/seedance

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`

İş Gönder

bash

curl -X POST https://seedance2ai.io/api/v1/video/seedance \
  -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"
  }'

GPT Image 2

Yüksek sadakatli görüntü oluşturma.

POST

/api/v1/image/gpt-image-2

Parametreler

Parametre	Tip	Zorunlu	Varsayılan	İzin verilen değerler
`type` Generation type.	`string`	Zorunlu	`—`	`text-to-imageimage-to-image`
`channel` Generation channel. economy is lower-cost with polling-based delivery.	`string`	İsteğe bağlı	`standard`	`standardeconomy`
`prompt` Text prompt.	`string`	Zorunlu	`—`	`3–20000 chars`
`resolution` Output resolution. auto only supports 1K; 1:1 cannot use 4K on the standard channel.	`string`	Zorunlu	`—`	`1K2K4K`
`aspectRatio` Aspect ratio.	`string`	Zorunlu	`—`	`auto1:15:49:1621:916:94:33:24:53:42:32:11:23:11:39:21`
`batchCount` Number of images.	`integer`	İsteğe bağlı	`1`	`1–4`
`imageUrls` Required for image-to-image.	`string[] (URL)`	İsteğe bağlı	`—`	`1–10 public https URLs`

İş Gönder

bash

curl -X POST https://seedance2ai.io/api/v1/image/gpt-image-2 \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-gpt-image-001" \
  -d '{
    "type": "text-to-image",
    "prompt": "Editorial product photo of a transparent running shoe on chrome",
    "resolution": "1K",
    "aspectRatio": "1:1"
  }'

Nano Banana Pro

Stilize, premium görsel çıktısı.

POST

/api/v1/image/nano-banana-pro

Parametreler

Parametre	Tip	Zorunlu	Varsayılan	İzin verilen değerler
`type` Generation type.	`string`	Zorunlu	`—`	`text-to-imageimage-to-image`
`prompt` Text prompt.	`string`	Zorunlu	`—`	`3–10000 chars`
`image_size` Aspect ratio.	`string`	İsteğe bağlı	`auto`	`1:19:1616:93:44:33:22:35:44:521:9auto`
`output_format` Image format.	`string`	İsteğe bağlı	`png`	`pngjpeg`
`resolution` Output resolution.	`string`	İsteğe bağlı	`1K`	`1K2K4K`
`image_urls` Required for image-to-image.	`string[] (URL)`	İsteğe bağlı	`—`	`1–8 public https URLs`

İş Gönder

bash

curl -X POST https://seedance2ai.io/api/v1/image/nano-banana-pro \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-nbp-001" \
  -d '{
    "type": "text-to-image",
    "prompt": "A premium packaging mockup for an AI video studio",
    "image_size": "1:1",
    "resolution": "1K",
    "output_format": "png"
  }'

Görev Durumunu Kontrol Et

Durum tamamlanana veya başarısız olana kadar poll yap.

bash

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

json

{
  "id": "sd2_xxxxx",
  "status": "completed",
  "model": "seedance",
  "output": { "video_url": "https://..." },
  "credits_used": 30
}

Hata kodları

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 for this account.
`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.

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

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

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.