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`	`ministandardpro`
`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:16adaptive`
`duration` Clip duration.	`string`	İsteğe bağlı	`5`	`4–15 (seconds)`
`resolution` Output resolution. 1080p-plus and 4k are available on pro only.	`string`	İsteğe bağlı	`720p`	`720p1080p1080p-plus4k`
`image_url` Start frame — required for image-to-video.	`string (URL)`	İsteğe bağlı	`—`	`public https URL, ≤ 30 MB`
`end_image_url` Optional end frame.	`string (URL)`	İsteğe bağlı	`—`	`public https URL, ≤ 30 MB`
`media_urls` Required for media-to-video. Images are limited to 30 MB; video URLs must support duration probing.	`string[] (URL)`	İsteğe bağlı	`—`	`≤ 12 public https image/video 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` Optional deterministic seed.	`integer`	İsteğe bağlı	`—`	`-1 – 4294967295`

Seedance prompt guide

Seedance prompts work best as concrete director instructions. Describe the subject, action, scene, camera motion, visual style, and constraints, then map every reference asset to the right API parameter.

Use image_url for the opening frame, end_image_url for the closing frame, and media_urls for character, motion, style, source-video, or extension references.
Describe asset roles in natural language inside prompt. Do not send raw asset ids, asset:// URLs, or in-app-only labels such as @图片1.
For edits say “strictly edit the supplied source video”; for extensions say “continue from the supplied previous clip.”
For complex scenes, use ordered shots plus a style and constraint package: stable faces, natural motion, no deformation, no watermark, no logo, and no subtitles unless intended.

İstek

bash

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"
  }'

Yanıt202

json

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

Bu örneklerde gösterilen credits_used değerleri yalnızca açıklama amaçlıdır. Gerçek kullanım gönderim sırasında hesaplanır ve API tarafından döndürülür.

Görev Durumunu Kontrol Et

GET

/api/v1/tasks/{id}

İstek

bash

curl https://www.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",
  "resolution": "720p",
  "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.
`purchase_required`	`403`	Seedance 2.5 requires a successful credits or plan purchase; free promotional credits alone do not unlock it.
`insufficient_credits`	`402`	Not enough credits. Seedance 2.5 always returns HTTP 402 with insufficient_credits; when an authoritative quote is available, it may also include required_credits, available_credits, pricing_version, and promotion_applied.
`rate_limited`	`429`	Too many requests — the general limit is 30 requests per 60 seconds per account; Seedance requests that validate reference media are limited to 3 per 60 seconds per account and source IP, with a project-wide safety cap. 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

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.

Aç llms-api.txt DeepSeek Harness plugin

Skill

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

bash

# Download the one-file skill from Seedance 2 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

Skill indir

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.