自分のツールで動画と画像を生成

クイックスタート

1. 1

   キー作成

   ダッシュボードでAPIキーを生成してください。一度だけ表示されるため、安全な場所に保存してください。

   キー管理
2. 2

   APIを呼び出す

   BearerキーとIdempotency-Keyヘッダーを指定してPOSTリクエストを送信します。

   cURLJavaScriptPython

   Copy

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

3. 3

   結果のポーリング

   タスクステータスエンドポイントをポーリングし、ステータスが完了または失敗になるまで待ちます。その後、出力を読み取ってください。

   cURLJavaScriptPython

   Copy

   while true; do
     TASK=$(curl -s https://www.seedance2ai.io/api/v1/tasks/sd2_xxxxx \
       -H "Authorization: Bearer $SEEDANCE_API_KEY")
     STATUS=$(echo "$TASK" | jq -r '.status')
     if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then
       echo "$TASK" | jq
       break
     fi
     sleep 10
   done

認証

すべてのリクエストは、AuthorizationヘッダーにBearer APIキーを指定して認証されます。

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

Tasks and balance

Read endpoints for building a task history, showing remaining credits, or discovering models at runtime. They share the read rate limit.

curl "https://www.seedance2ai.io/api/v1/tasks?limit=20" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

{
  "data": [
    {
      "id": "sd2_xxxxx",
      "type": "video",
      "status": "completed",
      "model": "seedance2",
      "credits_used": 30,
      "result_urls": ["https://..."]
    }
  ],
  "has_more": false,
  "next_cursor": null
}

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

{
  "credits": 1200,
  "subscription_credits": 1000,
  "subscription_credits_expire_at": "2026-07-01T00:00:00.000Z"
}

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

{
  "data": [
    {
      "id": "seedance2",
      "name": "Seedance 2.0",
      "type": "video",
      "method": "POST",
      "endpoint": "/api/v1/video/seedance2",
      "modes": ["text-to-video", "image-to-video", "media-to-video"],
      "task_id_prefix": "sd2_"
    }
  ]
}

エラーコード

Every error has the same shape. Branch on code, and show message to a person. A task that was accepted can still fail later, so also check status when you poll.

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request body: prompt: String must contain at least 3 character(s)"
  }
}

Rate limits

A request over the limit returns HTTP 429 with a Retry-After header in seconds, plus X-RateLimit-Limit and X-RateLimit-Reset. Wait that long, then retry with the same Idempotency-Key.

Submit a job

30 per 60 seconds

Every POST endpoint, counted per account across all of its keys.

Read

120 per 60 seconds

Task status, task list, balance and models. Counted separately, so polling never uses up the submit budget.

Reference media validation

3 per 60 seconds

Seedance requests that include reference media, per account and source IP.

Claude Code で使用

「Copy for AI」でAPI全体をクリーンなMarkdownとしてエクスポートし、Claude CodeやCodexに貼り付ければ、エージェントが統合をセットアップしてくれます。または、エージェントをrawテキストのエンドポイントに直接向けることもできます。

Skill

SeedanceスキルをClaude Code、Codex、または任意のエージェントにインストールすると、シネマティックなプロンプトを作成し、APIを通じてレンダリングしてくれます。

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

よくある質問

APIは誰が利用できますか？

クレジットをお持ちの方ならどなたでもご利用いただけます。プランによる制限はありません — クレジットのあるアカウントであれば、キーを作成してAPIを呼び出すことができます。

クレジットはどうやって入手できますか？

料金ページでチャージまたはプランに加入してください。クレジットは即座に残高に追加されます。

ウェブサイトとAPIでクレジットは共有されますか？

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

どうやって始めますか？

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

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

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