公開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に貼り付ければ、エージェントが統合をセットアップしてくれます。または、エージェントをrawテキストのエンドポイントに直接向けることもできます。

llms-api.txtを開く DeepSeek Harness plugin

Skill

SeedanceスキルをClaude Code、Codex、または任意のエージェントにインストールすると、シネマティックなプロンプトを作成し、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でクレジットは共有されますか？

はい — 個人のクレジット残高が、Web生成とAPI呼び出しの両方で使用できます。チームでは、API呼び出しには各メンバーの個人残高が使われ、共有のチームプールは使用されません。

どうやって始めますか？

ダッシュボードでAPIキーを作成し、Bearerトークンを使用してエンドポイントを呼び出してください（詳しくは上記のQuickstartを参照）。

API呼び出しでinsufficient_creditsが返された場合はどうなりますか？

残高が不足しています。料金ページでチャージして、再度お試しください。