公共 API

使用自有工具生成影片與圖片

建立金鑰，透過 Bearer 驗證呼叫 API，並持續輪詢任務狀態，直到取得結果。支援 Claude Code、Codex 及任何 HTTP 客戶端。

管理金鑰

快速入門

步驟 1

建立金鑰

在您的控制台中生成一組 API 金鑰。該金鑰僅顯示一次，請妥善保管。

步驟 2

呼叫 API

使用您的 Bearer 金鑰與 Idempotency-Key 標頭發送 POST 請求。

步驟 3

結果投票

輪詢任務狀態端點，直到狀態為完成或失敗，然後讀取輸出結果。

身份驗證

每個請求皆透過 Authorization 標頭中的 Bearer API 金鑰進行認證。

http

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

Seedance 2 Video

文字、圖片或媒體轉換為影片。

提交任務

POST

/api/v1/video/seedance2

參數

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

請求

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

回應202

json

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

示例中的 credits_used 數值僅供說明。實際消耗會在提交時結算，並由 API 回傳。

檢查任務狀態

GET

/api/v1/tasks/{id}

請求

bash

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

回應200

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

錯誤代碼

All errors share this shape:

json

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

代碼	HTTP	含義
`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 使用

使用 Copy for AI 將完整 API 匯出為乾淨的 Markdown，貼到 Claude Code 或 Codex，讓代理程式自動完成整合串接。或直接將代理程式指向純文字端點。

開啟 llms-api.txt DeepSeek Harness plugin

Skill

在 Claude Code、Codex 或任何代理程式中安裝 Seedance 技能 — 它會自動撰寫電影級提示詞，並透過 API 為你生成影片。

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

常見問題

誰可以使用 API？

只要有額度的使用者即可使用。沒有方案限制——任何擁有額度的帳戶都能建立金鑰並呼叫API。

如何獲得點數？

前往定價頁面加值或訂閱，點數將即時存入您的帳戶餘額。

網站與 API 的點數是否共用？

是的，您的個人點數額度同時用於網頁生成和 API 呼叫。在團隊中，API 呼叫使用每位成員的個人額度，而非共享的團隊額度。

如何開始？

在儀表板中建立 API 金鑰，然後使用 Bearer token 呼叫端點（請參閱上方快速入門）。

如果呼叫回傳 insufficient_credits，該如何處理？

您的餘額為零，請前往價格頁面充值後重試。