switch_heading

Seedance 1.5 API ドキュメント

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

API v1 · 1.5 Base URL: https://seedanceapi.org/v1

クイックスタート

bash

1	curl -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

1	Authorization: Bearer YOUR_API_KEY

料金

480p

480p 解像度

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

時間	音声なし	音声あり
4s	8 credits	14 credits
8s	14 credits	28 credits
12s	19 credits	38 credits

720p

720p 解像度

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

時間	音声なし	音声あり
4s	14 credits	28 credits
8s	28 credits	56 credits
12s	42 credits	84 credits

APIエンドポイント

POST/v1/generate新しい動画を生成

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

リクエストボディ

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

1	curl -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
2	const 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

ベースURL

エンドポイント

ヘッダー

リクエストボディ

エラーコード

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

switch_heading