API Publik

Hasilkan video dan gambar dari alat Anda sendiri

Buat kunci, panggil API dengan autentikasi Bearer, dan polling status task hingga hasil siap. Berfungsi dengan Claude Code, Codex, dan klien HTTP apa pun.

Kelola Kunci

Mulai Cepat

Langkah 1

Buat kunci

Buat kunci API di dashboard Anda. Kunci ini hanya ditampilkan sekali, jadi simpan di tempat yang aman.

Langkah 2

Panggil API

Kirim permintaan POST dengan kunci Bearer Anda dan header Idempotency-Key.

Langkah 3

Polling Hasil

Lakukan polling pada endpoint status tugas hingga status menjadi selesai atau gagal, lalu baca hasilnya.

Autentikasi

Setiap permintaan diautentikasi dengan kunci API Bearer di header Authorization.

http

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

Seedance 2 Video

Teks, gambar, atau media menjadi video.

Kirim Tugas

POST

/api/v1/video/seedance2

Parameter

Parameter	Tipe	Wajib	Default	Nilai yang diizinkan
`mode` Generation mode.	`string`	Opsional	`text-to-video`	`text-to-videoimage-to-videomedia-to-video`
`quality_tier` Quality tier.	`string`	Opsional	`standard`	`ministandardpro`
`channel` Rendering channel.	`string`	Opsional	`standard`	`standardrealwild`
`prompt` Text prompt.	`string`	Wajib	`—`	`3–10000 chars`
`aspect_ratio` Aspect ratio.	`string`	Opsional	`16:9`	`1:121:94:33:416:99:16adaptive`
`duration` Clip duration.	`string`	Opsional	`5`	`4–15 (seconds)`
`resolution` Output resolution. 1080p-plus and 4k are available on pro only.	`string`	Opsional	`720p`	`720p1080p1080p-plus4k`
`image_url` Start frame — required for image-to-video.	`string (URL)`	Opsional	`—`	`public https URL, ≤ 30 MB`
`end_image_url` Optional end frame.	`string (URL)`	Opsional	`—`	`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)`	Opsional	`—`	`≤ 12 public https image/video URLs`
`generate_audio` Generate an audio track.	`boolean`	Opsional	`true`	`truefalse`
`fixed_lens` Lock the camera lens.	`boolean`	Opsional	`false`	`truefalse`
`seed` Optional deterministic seed.	`integer`	Opsional	`—`	`-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.

Permintaan

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

Respons202

json

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

Nilai credits_used yang ditampilkan dalam contoh ini hanya ilustrasi. Penggunaan sebenarnya dihitung saat pengiriman dan dikembalikan oleh API.

Periksa status tugas

GET

/api/v1/tasks/{id}

Permintaan

bash

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

Respons200

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

Kode error

All errors share this shape:

json

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

Kode	HTTP	Arti
`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.

Gunakan dengan Claude Code

Gunakan Copy for AI untuk mengekspor seluruh API sebagai Markdown yang bersih, tempelkan ke Claude Code atau Codex, lalu biarkan agen menghubungkan integrasinya. Atau arahkan agen langsung ke endpoint teks mentah.

Buka llms-api.txt DeepSeek Harness plugin

Skill

Pasang skill Seedance di Claude Code, Codex, atau agen mana pun — skill ini menulis prompt sinematik dan merendernya melalui API untuk Anda.

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

Unduh skill

FAQ

Siapa yang bisa menggunakan API?

Siapa pun yang memiliki kredit. Tidak ada batasan paket — akun mana pun yang memiliki kredit dapat membuat kunci dan memanggil API.

Bagaimana cara mendapatkan kredit?

Isi ulang atau berlangganan di halaman harga. Kredit langsung ditambahkan ke saldo Anda.

Apakah kredit dibagi antara website dan API?

Ya — saldo kredit pribadi Anda mendukung pembuatan di web dan panggilan API. Dalam tim, panggilan API menggunakan saldo pribadi masing-masing anggota, bukan pool bersama tim.

Bagaimana cara memulainya?

Buat kunci API di dasbor Anda, lalu panggil endpoint dengan token Bearer (lihat Quickstart di atas).

Bagaimana jika suatu panggilan mengembalikan insufficient_credits?

Saldo Anda kosong — isi ulang di halaman harga dan coba lagi.