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`
`end_image_url` Optional end frame.	`string (URL)`	İsteğe bağlı	`—`	`public https URL`
`media_urls` Required for media-to-video. 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` Not supported on the real channel or mini tier.	`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://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

# Download the one-file skill from Seedance 2 AI
mkdir -p ~/.claude/skills/seedance
curl -L https://seedance2ai.io/downloads/seedance-skill.md -o ~/.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.