LogoSeedance API

Seedance 2.0 API ドキュメント

Seedance 2.0 動画生成 API をアプリケーションに統合するための完全ガイド。

API v1.0 Base URL: https://seedanceapi.org/v1

クイックスタート

bash
curl -X POST 'https://seedanceapi.org/v1/generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A cinematic shot of mountains at sunrise with flowing clouds",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": "8"
  }'

認証

すべてのAPIリクエストには、AuthorizationヘッダーでBearerトークンを使用した認証が必要です。

重要: ダッシュボードのAPI KeysページからAPIキーを取得できます。 → APIキーを取得

http
Authorization: Bearer YOUR_API_KEY

料金

480p

480p 解像度

高速生成、プレビューやドラフトに最適

時間音声なし音声あり
4s8 credits ($0.04)14 credits ($0.07)
8s14 credits ($0.07)28 credits ($0.14)
12s19 credits ($0.095)38 credits ($0.19)
720p

720p 解像度

高品質出力、本番使用におすすめ

時間音声なし音声あり
4s14 credits ($0.07)28 credits ($0.14)
8s28 credits ($0.14)56 credits ($0.28)
12s42 credits ($0.21)84 credits ($0.42)

APIエンドポイント

POST/v1/generate
Seedance 2.0 モデルで新しい動画生成タスクを作成します。テキストから動画、画像から動画をサポート。

リクエストボディ

Parameterタイプ必須説明
promptstring必須生成する動画のテキスト説明（最大2000文字）
aspect_ratiostring任意出力アスペクト比。対応：1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21 (デフォルト: 1:1)
resolutionstring任意動画解像度："480p" または "720p" (デフォルト: 720p)
durationstring任意動画の長さ（秒）："4"、"8"、または "12" (デフォルト: 8)
generate_audioboolean任意動画のAI音声生成を有効にする (デフォルト: false)
fixed_lensboolean任意カメラを固定してモーションブラーを軽減 (デフォルト: false)
image_urlsstring[]任意画像から動画生成用の参照画像URL配列（最大1枚）
callback_urlstring任意非同期ステータス通知用のWebhook URL。パブリックアクセス可能である必要があります。

テキストから動画

json
{
  "prompt": "A majestic eagle soaring through golden sunset clouds over ocean waves",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "8"
}

画像から動画

json
{
  "prompt": "The character slowly turns and smiles at the camera",
  "image_urls": [
    "https://example.com/my-image.jpg"
  ],
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "4"
}

音声生成付き

json
{
  "prompt": "A peaceful river flowing through a forest with birds singing",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "8",
  "generate_audio": true,
  "fixed_lens": true
}

レスポンス

Task created successfully

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "seed15abc123def456pro",
    "status": "IN_PROGRESS"
  }
}
GET/v1/status
動画生成タスクのステータスを確認し、完了後に結果を取得します。

クエリパラメータ

Parameterタイプ必須説明
task_idstring必須生成エンドポイントから返された一意のタスクID

リクエスト例

bash
curl -X GET 'https://seedanceapi.org/v1/status?task_id=seed15abc123def456pro' \
  -H 'Authorization: Bearer YOUR_API_KEY'

💡 Tip: ステータスAPIのresponseフィールドは動画URLの配列です。data.response[0]に直接アクセスして動画URLを取得できます。

javascript
// Extract video URL from response
const videoUrl = data.response[0];

レスポンス

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "seed15abc123def456pro",
    "status": "SUCCESS",
    "consumed_credits": 28,
    "created_at": "2026-02-07T10:30:00Z",
    "request": {
      "prompt": "A majestic eagle soaring through golden sunset clouds",
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "duration": "8"
    },
    "response": [
      "https://cdn.example.com/videos/seed15abc123def456pro.mp4"
    ],
    "error_message": null
  }
}

APIプレイグラウンド

ブラウザで直接APIをテストします。YOUR_API_KEYを実際のAPIキーに置き換えてください。

API プレイグラウンドPOST

エラーコード

StatusCodeDescription
400 不正なリクエストINVALID_PROMPTプロンプトが無効または空です
400 不正なリクエストINVALID_ASPECT_RATIOサポートされていないアスペクト比です
400 不正なリクエストINVALID_RESOLUTION解像度は480pまたは720pである必要があります
400 不正なリクエストINVALID_DURATION時間は4、8、または12秒である必要があります
400 不正なリクエストTOO_MANY_IMAGESimage_urls配列には最大1つの画像URLが許可されています
401 認証エラーINVALID_API_KEYAPIキーが存在しないか無効です
402 INSUFFICIENT_CREDITSこの操作にはクレジットが不足しています
404 見つかりませんTASK_NOT_FOUNDタスクIDが見つからないか、あなたのアカウントに属していません
500 サーバー内部エラーINTERNAL_ERRORサーバーエラーです。後でもう一度お試しください