API 概要

Seedance 2.0 Open API の認証、送信フロー、ステータス確認、Webhook を確認できます。

Seedance 2.0 Open API を使うと、自社プロダクトから非同期で動画生成ジョブを送信し、完了後に結果を取得できます。

Base URL

https://www.seedance2.ink

Authentication

すべての Open API リクエストは、Seedance ダッシュボードで作成した Bearer トークンで認証します。

Authorization: Bearer sd2_live_your_api_key

{
  "success": false,
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

導入フロー

Seedance ダッシュボードで API Key を作成します。
POST /api/open/v1/video/generations で生成ジョブを送信します。
返却された requestId を保存します。
GET /api/open/v1/video/generations/{requestId} をポーリングします。
必要に応じて Webhook で完了通知を受け取ります。

主要エンドポイント

Method	Endpoint	Description
`GET`	`/api/open/v1/models`	利用可能なモデル、秒数、比率、解像度、価格情報を取得します。
`POST`	`/api/open/v1/video/generations`	新しい動画生成ジョブを作成します。
`GET`	`/api/open/v1/video/generations/{requestId}`	ジョブの状態を確認し、完了後に出力 URL を取得します。
`POST`	`/api/open/v1/video/generations/{requestId}/cancel`	待機中または処理中のジョブをキャンセルします。

Available Models

Model	Best for	Supported durations	Resolutions
`seedance-2.0`	Highest quality, multimodal generation	`4`-`15` seconds	`480p`, `720p`, `1080p`
`seedance-2.0-fast`	Faster turnaround	`4`-`15` seconds	`480p`, `720p`, `1080p`
`seedance-1.5-pro`	Lower-cost fallback workloads	`5` or `10` seconds	`480p`, `720p`, `1080p`

Supported aspect ratios:

16:9
9:16
1:1

ステータス

Status	Description
`queued`	リクエストは受理され、キューで待機しています。
`processing`	ジョブは現在処理中です。
`succeeded`	ジョブが正常終了し、`output.url` が利用できます。
`failed`	ジョブが失敗しました。`error` を確認してください。
`cancelled`	ジョブは完了前にキャンセルされました。

Models Endpoint Example

curl https://www.seedance2.ink/api/open/v1/models

{
  "success": true,
  "data": [
    {
      "id": "seedance-2.0",
      "type": "video_generation",
      "mode": "image_to_video",
      "durations": [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
      "aspectRatios": ["16:9", "9:16", "1:1"],
      "resolutions": ["480p", "720p", "1080p"],
      "usdPerSecond": {
        "480p": 0.05,
        "720p": 0.1,
        "1080p": 0.2
      }
    }
  ]
}

Webhook

webhookUrl を各リクエストで指定するか、API Key にデフォルトのコールバック URL を設定できます。

両方ある場合は、リクエスト単位の webhookUrl が優先されます。
Webhook Secret を設定している場合、x-seedance-signature が付与されます。
Webhook はジョブが終端状態になったときに送信されます。

x-seedance-signature: <hex_sha256_hmac>

{
  "success": true,
  "requestId": "req_1234567890",
  "status": "succeeded",
  "output": {
    "type": "video",
    "url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
  },
  "error": null
}

エラーコード

HTTP status	Error code	Description
`400`	`invalid_request`	リクエスト本文がスキーマに一致しません。
`401`	`unauthorized`	API Key が無効、または未指定です。
`402`	`insufficient_credits`	クレジット不足のためジョブを作成できません。
`404`	`not_found`	現在の API Key では対象ジョブが見つかりません。
`429`	`rate_limited`	毎分制限または月次上限を超過しています。
`500`	`internal_error`	サーバー側で予期しないエラーが発生しました。

次のステップ

テキストから動画を読む
画像から動画を読む

Seedance 2.0 Open API を使うと、自社プロダクトから非同期で動画生成ジョブを送信し、完了後に結果を取得できます。

Base URL

https://www.seedance2.ink

Authentication

すべての Open API リクエストは、Seedance ダッシュボードで作成した Bearer トークンで認証します。

Authorization: Bearer sd2_live_your_api_key

{
  "success": false,
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

導入フロー

Seedance ダッシュボードで API Key を作成します。
POST /api/open/v1/video/generations で生成ジョブを送信します。
返却された requestId を保存します。
GET /api/open/v1/video/generations/{requestId} をポーリングします。
必要に応じて Webhook で完了通知を受け取ります。

主要エンドポイント

Method	Endpoint	Description
`GET`	`/api/open/v1/models`	利用可能なモデル、秒数、比率、解像度、価格情報を取得します。
`POST`	`/api/open/v1/video/generations`	新しい動画生成ジョブを作成します。
`GET`	`/api/open/v1/video/generations/{requestId}`	ジョブの状態を確認し、完了後に出力 URL を取得します。
`POST`	`/api/open/v1/video/generations/{requestId}/cancel`	待機中または処理中のジョブをキャンセルします。

Available Models

Model	Best for	Supported durations	Resolutions
`seedance-2.0`	Highest quality, multimodal generation	`4`-`15` seconds	`480p`, `720p`, `1080p`
`seedance-2.0-fast`	Faster turnaround	`4`-`15` seconds	`480p`, `720p`, `1080p`
`seedance-1.5-pro`	Lower-cost fallback workloads	`5` or `10` seconds	`480p`, `720p`, `1080p`

Supported aspect ratios:

16:9
9:16
1:1

ステータス

Status	Description
`queued`	リクエストは受理され、キューで待機しています。
`processing`	ジョブは現在処理中です。
`succeeded`	ジョブが正常終了し、`output.url` が利用できます。
`failed`	ジョブが失敗しました。`error` を確認してください。
`cancelled`	ジョブは完了前にキャンセルされました。

Models Endpoint Example

curl https://www.seedance2.ink/api/open/v1/models

{
  "success": true,
  "data": [
    {
      "id": "seedance-2.0",
      "type": "video_generation",
      "mode": "image_to_video",
      "durations": [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
      "aspectRatios": ["16:9", "9:16", "1:1"],
      "resolutions": ["480p", "720p", "1080p"],
      "usdPerSecond": {
        "480p": 0.05,
        "720p": 0.1,
        "1080p": 0.2
      }
    }
  ]
}

Webhook

webhookUrl を各リクエストで指定するか、API Key にデフォルトのコールバック URL を設定できます。

両方ある場合は、リクエスト単位の webhookUrl が優先されます。
Webhook Secret を設定している場合、x-seedance-signature が付与されます。
Webhook はジョブが終端状態になったときに送信されます。

x-seedance-signature: <hex_sha256_hmac>

{
  "success": true,
  "requestId": "req_1234567890",
  "status": "succeeded",
  "output": {
    "type": "video",
    "url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
  },
  "error": null
}

エラーコード

HTTP status	Error code	Description
`400`	`invalid_request`	リクエスト本文がスキーマに一致しません。
`401`	`unauthorized`	API Key が無効、または未指定です。
`402`	`insufficient_credits`	クレジット不足のためジョブを作成できません。
`404`	`not_found`	現在の API Key では対象ジョブが見つかりません。
`429`	`rate_limited`	毎分制限または月次上限を超過しています。
`500`	`internal_error`	サーバー側で予期しないエラーが発生しました。

次のステップ

テキストから動画を読む
画像から動画を読む

Base URL

Authentication

導入フロー

主要エンドポイント

Available Models

ステータス

Models Endpoint Example

Webhook

エラーコード

次のステップ

目次

API 概要

Base URL

Authentication

導入フロー

主要エンドポイント

Available Models

ステータス

Models Endpoint Example

Webhook

エラーコード

次のステップ

目次