ベアラー API キー
すべてのリクエストに `Authorization: Bearer sk_seedancee2_live_xxxxx` を付与します。
基盤となるSeedance 2.0モデルを土台に、上流プロバイダーの機能を統一的にラップし、標準化された公開APIとして提供します。
`pro`、`fast`、`mini` に一度統合すれば、上流プロバイダーの変更は同じ公開契約の裏側で吸収されます。
プロンプト起点と画像起点の動画生成をひとつのAPIで実行し、上流プロバイダーごとの差分を顧客に見せずに済みます。
生成リクエストを送信し、ジョブ状態をポーリングするか、動画完了時にクリーンなSeeDanceE2レスポンス形式のWebhookを受け取れます。
公開 API は上流プロバイダーを隠します。開発者は 3 つの公開モデル名、1 つの認証方式、1 つの非同期ジョブのライフサイクルだけを扱えば済みます。
すべてのリクエストに `Authorization: Bearer sk_seedancee2_live_xxxxx` を付与します。
非同期の生成タスクを作成し、ID でポーリングするか、完了コールバックを受け取ります。
レスポンスには予約・確定・返金のクレジットが含まれ、課金を監査できます。
顧客向けのクリップや標準的な本番作業に使用します。
プレビューのワークフローやプロンプトの反復実験に使用します。
軽量な下書きやコストを抑えた生成に使用します。
ワークスペースで API キーを作成し、各リクエストにベアラートークンとして送信します: Authorization: Bearer sk_seedancee2_live_xxxxx。
生成は非同期です。タスクを送信してタスク ID を受け取り、ステータスのエンドポイントをポーリングするか、Webhook を登録して動画の準備完了を受け取ります。
公開されている pro、fast、mini の 3 つだけです。各リクエストは利用可能な最良の基盤動画モデルにルーティングされるため、提供元が変わっても連携が壊れることはありません。
API の利用は Web アプリと同じクレジット残高から消費されます。レスポンスには credits_reserved、credits_charged、credits_refunded が含まれ、すべての呼び出しを監査できます。
はい。テキストプロンプトを送ればテキストからの動画生成、参照画像の URL を添付すれば画像からの動画生成になります。画像の構図は保持され、記述した動きだけが生成されます。
SeeDanceE2 は動画生成用の安定した公開 API を提供しています。連携には公開モデル名 pro、fast、mini のみを使用してください。上流プロバイダーの詳細は SeeDanceE2 の契約の内側に隠れ、外部に露出しません。
https://api.SeeDanceE2.ai最小構成の 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/jsonx-api-key でキーを送ることもできますが、Authorization: Bearer ... を推奨します。
pro、fast、mini のすべてで利用できます。すでに有効な 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 製品の課金ルールと一致しています:
| モデル | 480p | 720p | 1080p |
|---|---|---|---|
pro | 10 クレジット/秒 | 20 クレジット/秒 | 50 クレジット/秒 |
fast | 8 クレジット/秒 | 16 クレジット/秒 | 非対応 |
mini | 5 クレジット/秒 | 10 クレジット/秒 | 非対応 |
例:
| シナリオ | クレジット |
|---|---|
mini、5 秒、720p | 50 |
pro、4 秒、480p | 40 |
fast、10 秒、720p | 160 |
pro、5 秒、720p、参照画像 2 枚 | 100 |
タスクが失敗し返金対象となった場合、返却されるステータスのペイロードに返金クレジットが表示されます。
公開 API が返すタスクステータス:
| ステータス | 意味 |
|---|---|
pending | 受け付け済みで開始待ち |
processing | 実行中 |
completed | 正常に完了 |
failed | 利用可能な出力なしで終了 |
POST /v1/videos/generationsトップレベルのリクエストフィールド:
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | はい | 公開モデル名: pro、fast、mini |
input | object | はい | 生成パラメータ |
callback_url | string | いいえ | 完了または失敗を受け取る公開 Webhook URL |
metadata | object | いいえ | 顧客側で定義するメタデータ。ポーリングと Webhook のレスポンスにそのまま返されます |
入力フィールド:
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
prompt | string | はい | テキストプロンプト |
generation_type | string | いいえ | omni_reference または first_and_last_frames。既定値は omni_reference |
image_urls | string[] | いいえ | 参照画像の URL |
video_url | string | いいえ | 参照動画の URL(1 本) |
video_urls | string[] | いいえ | 参照動画の URL。video_url と同時には送信しないでください |
audio_urls | string[] | いいえ | 参照音声の URL |
start_image_url | string | いいえ | first_and_last_frames 用の開始フレーム画像 |
end_image_url | string | いいえ | first_and_last_frames 用の終了フレーム画像 |
duration | integer | いいえ | 出力の長さ(秒)。4〜15、既定値は 5 |
resolution | string | いいえ | 480p、720p、1080p。利用可能な解像度は選択したモデルにより異なります |
aspect_ratio | string | いいえ | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive |
generate_audio | boolean | いいえ | 対応している場合は同期音声を生成します |
watermark | boolean | いいえ | 透かし入りの出力を要求します |
seed | integer | いいえ | 再現性のためのシード値 |
return_last_frame | boolean | いいえ | 出力ペイロードに最終フレーム画像を含めます |
完全な例:
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対応するクエリパラメータ:
| フィールド | 型 | 説明 |
|---|---|---|
status | string | pending、processing、completed、failed で絞り込みます |
limit | integer | 最大件数。既定値 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対応するクエリパラメータ:
| フィールド | 型 | 説明 |
|---|---|---|
start | string | 省略可能。ISO 8601 形式の開始日時フィルタ |
end | string | 省略可能。ISO 8601 形式の終了日時フィルタ |
limit | integer | 返す日次タイムラインの最大行数。既定値 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
}
]
}
}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_url | 1 本 |
video_urls | 最大 3 本 |
音声:
| 要件 | 値 |
|---|---|
audio_urls | 最大 3 本 |
エラーの形式:
{
"error": {
"code": "insufficient_credits",
"message": "Your credit balance is too low. Please top up.",
"type": "billing_error"
}
}現在の公開エラーコード:
| HTTP ステータス | コード | 種別 | 説明 |
|---|---|---|---|
| 400 | invalid_request | invalid_request_error | パラメータの欠落または不正 |
| 401 | invalid_api_key | authentication_error | API キーが未指定、不正、または無効化済み |
| 402 | insufficient_credits | billing_error | クレジット残高が不足 |
| 404 | model_not_found | invalid_request_error | モデルが存在しない、または非アクティブ |
| 404 | task_not_found | invalid_request_error | タスク ID が存在しない |
| 500 | internal_error | api_error | 予期しないサーバーエラー |
pro、fast、mini など公開モデル名のみを使用してください。metadata を自社側で保存し、コールバックやポーリング結果を社内の業務レコードと突き合わせられるようにしてください。