開発者向けAPI

SeeDanceE2.aiで構築。

基盤となるSeedance 2.0モデルを土台に、上流プロバイダーの機能を統一的にラップし、標準化された公開APIとして提供します。

model: promodel: fastmodel: mini
安定したAPI契約

`pro`、`fast`、`mini` に一度統合すれば、上流プロバイダーの変更は同じ公開契約の裏側で吸収されます。

テキストと画像のワークフロー

プロンプト起点と画像起点の動画生成をひとつのAPIで実行し、上流プロバイダーごとの差分を顧客に見せずに済みます。

非同期ジョブ、ポーリング、Webhook

生成リクエストを送信し、ジョブ状態をポーリングするか、動画完了時にクリーンなSeeDanceE2レスポンス形式のWebhookを受け取れます。

公開契約

動画生成のための単一の API 面

公開 API は上流プロバイダーを隠します。開発者は 3 つの公開モデル名、1 つの認証方式、1 つの非同期ジョブのライフサイクルだけを扱えば済みます。

認証

ベアラー API キー

すべてのリクエストに `Authorization: Bearer sk_seedancee2_live_xxxxx` を付与します。

タスクのライフサイクル

送信・ポーリング・Webhook

非同期の生成タスクを作成し、ID でポーリングするか、完了コールバックを受け取ります。

利用量とクレジット

予約と確定

レスポンスには予約・確定・返金のクレジットが含まれ、課金を監査できます。

公開モデル名

`pro`、`fast`、`mini` のみを使用

pro

本番品質

顧客向けのクリップや標準的な本番作業に使用します。

480p, 720p, 1080p
fast

高速な試行

プレビューのワークフローやプロンプトの反復実験に使用します。

480p, 720p
mini

低コストの検証

軽量な下書きやコストを抑えた生成に使用します。

480p, 720p
API の質問

よくある質問

動画生成 API のリクエストはどう認証しますか?

ワークスペースで API キーを作成し、各リクエストにベアラートークンとして送信します: Authorization: Bearer sk_seedancee2_live_xxxxx。

API は同期ですか、非同期ですか?

生成は非同期です。タスクを送信してタスク ID を受け取り、ステータスのエンドポイントをポーリングするか、Webhook を登録して動画の準備完了を受け取ります。

どのモデル名を指定できますか?

公開されている pro、fast、mini の 3 つだけです。各リクエストは利用可能な最良の基盤動画モデルにルーティングされるため、提供元が変わっても連携が壊れることはありません。

API の課金はどうなりますか?

API の利用は Web アプリと同じクレジット残高から消費されます。レスポンスには credits_reserved、credits_charged、credits_refunded が含まれ、すべての呼び出しを監査できます。

API はテキストからの動画だけでなく、画像からの動画にも対応していますか?

はい。テキストプロンプトを送ればテキストからの動画生成、参照画像の URL を添付すれば画像からの動画生成になります。画像の構図は保持され、記述した動きだけが生成されます。

SeeDanceE2 公開動画 API

SeeDanceE2 は動画生成用の安定した公開 API を提供しています。連携には公開モデル名 pro、fast、mini のみを使用してください。上流プロバイダーの詳細は SeeDanceE2 の契約の内側に隠れ、外部に露出しません。

ベース URL

https://api.SeeDanceE2.ai

クイックスタート

  1. SeeDanceE2 チームから API キーを取得します。
  2. 動画生成タスクを作成します。
  3. タスクをポーリングするか、完了時に Webhook を受け取ります。

最小構成の curl 例:

curl -X POST "https://api.SeeDanceE2.ai/v1/videos/generations" \
  -H "Authorization: Bearer sk_seedancee2_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mini",
    "input": {
      "prompt": "A cinematic drone shot of waves breaking against black volcanic rocks",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9"
    },
    "metadata": {
      "customer_job_id": "job_123"
    }
  }'

最小構成の JavaScript 例:

const response = await fetch("https://api.SeeDanceE2.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk_seedancee2_live_xxxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "mini",
    input: {
      prompt: "A cinematic drone shot of waves breaking against black volcanic rocks",
      duration: 5,
      resolution: "720p",
      aspect_ratio: "16:9",
    },
    metadata: {
      customer_job_id: "job_123",
    },
  }),
});

const result = await response.json();
console.log(result);

最小構成の Python 例:

import requests

response = requests.post(
    "https://api.SeeDanceE2.ai/v1/videos/generations",
    headers={
        "Authorization": "Bearer sk_seedancee2_live_xxxxx",
        "Content-Type": "application/json",
    },
    json={
        "model": "mini",
        "input": {
            "prompt": "A cinematic drone shot of waves breaking against black volcanic rocks",
            "duration": 5,
            "resolution": "720p",
            "aspect_ratio": "16:9",
        },
        "metadata": {
            "customer_job_id": "job_123",
        },
    },
    timeout=60,
)

print(response.json())

認証

すべてのリクエストはベアラートークン認証を使用します。

Authorization: Bearer sk_seedancee2_live_xxxxx
Content-Type: application/json

x-api-key でキーを送ることもできますが、Authorization: Bearer ... を推奨します。

API キーとモデルアクセス

  • SeeDanceE2 の API キーは SeeDanceE2 チームから、またはプロフィール画面から発行されます。
  • 同じ API キーが公開モデル pro、fast、mini のすべてで利用できます。
  • Mini、Fast、Pro ごとに別々の API キーを用意する必要はありません。
  • 上流プロバイダーの認証情報は SeeDanceE2 が管理しており、顧客のリクエストに含める必要はありません。

すでに有効な SeeDanceE2 API キーをお持ちの場合、モデルの切り替えはリクエストの model フィールドを変更するだけです。例:

{
  "model": "mini"
}

を次に変更します:

{
  "model": "fast"
}

または:

{
  "model": "pro"
}

公開モデル

連携で使用する公開モデル名は次のとおりです。

モデル位置づけ長さ解像度
pro標準品質の本番生成4-15 秒480p, 720p, 1080p
fast高速な試行とプレビュー4-15 秒480p, 720p
mini低コストの生成4-15 秒480p, 720p

新しい連携では pro、fast、mini を使用してください。

対応アスペクト比:

16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive

クレジット

公開 API のクレジットは、SeeDanceE2 製品と同一の消費ルールに従います。

計算式:

credits = duration_seconds * per_second_rate * number_of_outputs

参照画像・参照動画・参照音声に対して、現時点で顧客向けの追加課金はありません。タスクごとの正確な値は、API レスポンスに含まれる予約クレジットと消費クレジットを正とします。

現在の秒単価は SeeDanceE2 製品の課金ルールと一致しています:

モデル480p720p1080p
pro10 クレジット/秒20 クレジット/秒50 クレジット/秒
fast8 クレジット/秒16 クレジット/秒非対応
mini5 クレジット/秒10 クレジット/秒非対応

例:

シナリオクレジット
mini、5 秒、720p50
pro、4 秒、480p40
fast、10 秒、720p160
pro、5 秒、720p、参照画像 2 枚100

タスクが失敗し返金対象となった場合、返却されるステータスのペイロードに返金クレジットが表示されます。

タスクのライフサイクル

公開 API が返すタスクステータス:

ステータス意味
pending受け付け済みで開始待ち
processing実行中
completed正常に完了
failed利用可能な出力なしで終了

動画タスクの作成

POST /v1/videos/generations

トップレベルのリクエストフィールド:

フィールド型必須説明
modelstringはい公開モデル名: pro、fast、mini
inputobjectはい生成パラメータ
callback_urlstringいいえ完了または失敗を受け取る公開 Webhook URL
metadataobjectいいえ顧客側で定義するメタデータ。ポーリングと Webhook のレスポンスにそのまま返されます

入力フィールド:

フィールド型必須説明
promptstringはいテキストプロンプト
generation_typestringいいえomni_reference または first_and_last_frames。既定値は omni_reference
image_urlsstring[]いいえ参照画像の URL
video_urlstringいいえ参照動画の URL(1 本)
video_urlsstring[]いいえ参照動画の URL。video_url と同時には送信しないでください
audio_urlsstring[]いいえ参照音声の URL
start_image_urlstringいいえfirst_and_last_frames 用の開始フレーム画像
end_image_urlstringいいえfirst_and_last_frames 用の終了フレーム画像
durationintegerいいえ出力の長さ(秒)。4〜15、既定値は 5
resolutionstringいいえ480p、720p、1080p。利用可能な解像度は選択したモデルにより異なります
aspect_ratiostringいいえ16:9、4:3、1:1、3:4、9:16、21:9、adaptive
generate_audiobooleanいいえ対応している場合は同期音声を生成します
watermarkbooleanいいえ透かし入りの出力を要求します
seedintegerいいえ再現性のためのシード値
return_last_framebooleanいいえ出力ペイロードに最終フレーム画像を含めます

完全な例:

curl -X POST "https://api.SeeDanceE2.ai/v1/videos/generations" \
  -H "Authorization: Bearer sk_seedancee2_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pro",
    "callback_url": "https://example.com/webhooks/seedancee2",
    "input": {
      "prompt": "A cinematic tracking shot through a rain-soaked neon market at night",
      "image_urls": [
        "https://example-cdn.com/reference-1.png",
        "https://example-cdn.com/reference-2.png"
      ],
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true,
      "return_last_frame": true
    },
    "metadata": {
      "customer_job_id": "job_123",
      "campaign": "launch_week"
    }
  }'

成功時のレスポンス:

{
  "data": {
    "id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
    "status": "pending",
    "model": "pro",
    "credits_reserved": 100,
    "created_at": "2026-06-29T10:00:00.000Z"
  }
}

動画タスクの取得

GET /v1/videos/generations/{id}

ポーリングの例:

const response = await fetch(
  "https://api.SeeDanceE2.ai/v1/videos/generations/vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
  {
    headers: {
      Authorization: "Bearer sk_seedancee2_live_xxxxx",
    },
  }
);

const result = await response.json();
console.log(result);

処理中のレスポンス:

{
  "data": {
    "id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
    "status": "processing",
    "model": "pro",
    "created_at": "2026-06-29T10:00:00.000Z",
    "metadata": {
      "customer_job_id": "job_123",
      "campaign": "launch_week"
    }
  }
}

完了時のレスポンス:

{
  "data": {
    "id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
    "status": "completed",
    "model": "pro",
    "created_at": "2026-06-29T10:00:00.000Z",
    "completed_at": "2026-06-29T10:06:20.000Z",
    "credits_charged": 100,
    "output": {
      "video_url": "https://media.SeeDanceE2.ai/videos/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.mp4",
      "thumbnail_url": "https://media.SeeDanceE2.ai/video-posters/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.jpg",
      "last_frame_url": "https://media.SeeDanceE2.ai/video-posters/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.jpg"
    },
    "metadata": {
      "customer_job_id": "job_123",
      "campaign": "launch_week"
    }
  }
}

失敗時のレスポンス:

{
  "data": {
    "id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
    "status": "failed",
    "model": "pro",
    "created_at": "2026-06-29T10:00:00.000Z",
    "credits_charged": 0,
    "credits_refunded": 100,
    "error": {
      "code": "generation_failed",
      "message": "The video could not be generated. Please try again with a different prompt.",
      "type": "generation_error"
    },
    "metadata": {
      "customer_job_id": "job_123",
      "campaign": "launch_week"
    }
  }
}

動画タスクの一覧

GET /v1/videos/generations

対応するクエリパラメータ:

フィールド型説明
statusstringpending、processing、completed、failed で絞り込みます
limitinteger最大件数。既定値 20、最大 100

例:

curl "https://api.SeeDanceE2.ai/v1/videos/generations?status=completed&limit=10" \
  -H "Authorization: Bearer sk_seedancee2_live_xxxxx"

モデル一覧

GET /v1/models

レスポンス例:

{
  "data": [
    {
      "id": "pro",
      "status": "active",
      "resolutions": ["480p", "720p", "1080p"],
      "duration": {
        "min": 4,
        "max": 15
      }
    }
  ]
}

利用状況のサマリー

GET /v1/usage

対応するクエリパラメータ:

フィールド型説明
startstring省略可能。ISO 8601 形式の開始日時フィルタ
endstring省略可能。ISO 8601 形式の終了日時フィルタ
limitinteger返す日次タイムラインの最大行数。既定値 30、最大 365

例:

curl "https://api.SeeDanceE2.ai/v1/usage?start=2026-07-01T00:00:00.000Z&end=2026-07-31T23:59:59.999Z&limit=7" \
  -H "Authorization: Bearer sk_seedancee2_live_xxxxx"

レスポンス例:

{
  "data": {
    "range": {
      "start": "2026-07-01T00:00:00.000Z",
      "end": "2026-07-31T23:59:59.999Z"
    },
    "summary": {
      "total_jobs": 12,
      "pending_jobs": 1,
      "processing_jobs": 2,
      "completed_jobs": 8,
      "failed_jobs": 1,
      "credits_charged": 280,
      "credits_refunded": 40,
      "net_credits": 240
    },
    "by_model": [
      {
        "model": "mini",
        "total_jobs": 7,
        "pending_jobs": 0,
        "processing_jobs": 1,
        "completed_jobs": 5,
        "failed_jobs": 1,
        "credits_charged": 120,
        "credits_refunded": 20,
        "net_credits": 100
      },
      {
        "model": "pro",
        "total_jobs": 5,
        "pending_jobs": 1,
        "processing_jobs": 1,
        "completed_jobs": 3,
        "failed_jobs": 0,
        "credits_charged": 160,
        "credits_refunded": 20,
        "net_credits": 140
      }
    ],
    "timeline": [
      {
        "date": "2026-07-01",
        "total_jobs": 4,
        "pending_jobs": 0,
        "processing_jobs": 1,
        "completed_jobs": 3,
        "failed_jobs": 0,
        "credits_charged": 100,
        "credits_refunded": 0,
        "net_credits": 100
      }
    ]
  }
}

Webhook

callback_url を指定すると、タスクが completed または failed に到達した時点で SeeDanceE2 が POST リクエストを送信します。

確認すべき推奨ヘッダー:

X-Seedancee2-Event: video.generation.completed
X-Seedancee2-Signature: t=1770000000,v1=...

アカウントで Webhook 署名が有効な場合、ボディは次のように署名されます:

payload_to_sign = "{timestamp}.{raw_json_body}"
signature = hex(hmac_sha256(webhook_secret, payload_to_sign))

完了時の Webhook ペイロード:

{
  "data": {
    "id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
    "status": "completed",
    "model": "pro",
    "created_at": "2026-06-29T10:00:00.000Z",
    "completed_at": "2026-06-29T10:06:20.000Z",
    "credits_charged": 100,
    "output": {
      "video_url": "https://media.SeeDanceE2.ai/videos/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.mp4",
      "thumbnail_url": "https://media.SeeDanceE2.ai/video-posters/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.jpg"
    },
    "metadata": {
      "customer_job_id": "job_123",
      "campaign": "launch_week"
    }
  }
}

失敗時の Webhook ペイロード:

{
  "data": {
    "id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
    "status": "failed",
    "model": "pro",
    "created_at": "2026-06-29T10:00:00.000Z",
    "credits_charged": 0,
    "credits_refunded": 100,
    "error": {
      "code": "generation_failed",
      "message": "The video could not be generated. Please try again with a different prompt.",
      "type": "generation_error"
    },
    "metadata": {
      "customer_job_id": "job_123",
      "campaign": "launch_week"
    }
  }
}

入力ガイドライン

画像:

要件値
形式JPEG、PNG、WebP、BMP、TIFF、GIF
枚数参照画像は最大 9 枚
first_and_last_framesちょうど 2 枚

動画:

要件値
video_url1 本
video_urls最大 3 本

音声:

要件値
audio_urls最大 3 本

エラー

エラーの形式:

{
  "error": {
    "code": "insufficient_credits",
    "message": "Your credit balance is too low. Please top up.",
    "type": "billing_error"
  }
}

現在の公開エラーコード:

HTTP ステータスコード種別説明
400invalid_requestinvalid_request_errorパラメータの欠落または不正
401invalid_api_keyauthentication_errorAPI キーが未指定、不正、または無効化済み
402insufficient_creditsbilling_errorクレジット残高が不足
404model_not_foundinvalid_request_errorモデルが存在しない、または非アクティブ
404task_not_foundinvalid_request_errorタスク ID が存在しない
500internal_errorapi_error予期しないサーバーエラー

連携上の注意

  • pro、fast、mini など公開モデル名のみを使用してください。
  • 内部プロバイダー名、内部タスク ID、内部メディアホストに依存したロジックを組まないでください。
  • metadata を自社側で保存し、コールバックやポーリング結果を社内の業務レコードと突き合わせられるようにしてください。
  • 本番運用では完了通知に Webhook を使い、ポーリングはフォールバックとして残してください。