LogoSeedance API

Seedance 2.0 API ドキュメント

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

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

クイックスタート

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

認証

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

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

http
1Authorization: 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 モデルで新しい動画生成タスクを作成します。テキストから動画、画像から動画をサポート。

リクエストボディ

Body ParametersJSON
prompt:string

生成する動画のテキスト説明（最大2000文字）

aspect_ratio:optional string

出力アスペクト比。対応：1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21 Defaults to 1:1.

resolution:optional string

動画解像度：480p または 720p Defaults to 720p.

duration:optional string

動画の長さ（秒）：4、8、または 12 Defaults to 8.

generate_audio:optional boolean

動画のAI音声生成を有効にする Defaults to false.

fixed_lens:optional boolean

カメラを固定してモーションブラーを軽減 Defaults to false.

image_urls:optional string[]

画像から動画生成用の参照画像URL配列（最大1枚）

callback_url:optional string

非同期ステータス通知用のWebhook URL。パブリックアクセス可能である必要があります。

テキストから動画

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

画像から動画

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

音声生成付き

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

レスポンス

Task created successfully

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "seed15abc123def456pro",
6 "status": "IN_PROGRESS"
7 }
8}
GET/v1/status

動画生成タスクのステータスを確認し、完了後に結果を取得します。

クエリパラメータ

Body ParametersJSON
task_id:string

生成エンドポイントから返された一意のタスクID

リクエスト例

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

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

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

レスポンス

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "seed15abc123def456pro",
6 "status": "SUCCESS",
7 "consumed_credits": 28,
8 "created_at": "2026-02-07T10:30:00Z",
9 "request": {
10 "prompt": "A majestic eagle soaring through golden sunset clouds",
11 "aspect_ratio": "16:9",
12 "resolution": "720p",
13 "duration": "8"
14 },
15 "response": [
16 "https://cdn.example.com/videos/seed15abc123def456pro.mp4"
17 ],
18 "error_message": null
19 }
20}

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サーバーエラーです。後でもう一度お試しください