label llms.txt open_chatgpt

Seedance 2.5 API ドキュメント

API v3 で Seedance 2.5 と Seedance 2.5 Flash の動画を生成:テキストから動画、参照画像・動画・音声、開始・終了フレーム、動画編集、4K 出力。

API v3 · 2.5 / 2.5 Flash Base URL: https://seedanceapi.org/v3

API v3 は Seedance 2.5 専用の独立したエンドポイントです。既存の /v1 と /v2 の統合はこれまでどおり動作します。Seedance 2.5 が必要な場合のみ /v3 に切り替えてください。

クイックスタート

bash
1curl -X POST 'https://seedanceapi.org/v3/generate' \
2 -H 'Authorization: Bearer YOUR_API_KEY' \
3 -H 'Content-Type: application/json' \
4 -d '{
5 "model": "seedance-2.5",
6 "prompt": "A cinematic aerial shot over a coastline at golden hour",
7 "aspect_ratio": "16:9",
8 "resolution": "720p",
9 "duration": 10
10 }'

認証

すべての API リクエストは、Authorization ヘッダーに Bearer トークンが必要です。

重要: API キーはダッシュボードの API Keys ページで取得できます。サーバー上に保管し、ブラウザのコードには絶対に含めないでください。 → API キーを取得

http
1Authorization: Bearer YOUR_API_KEY

生成モード

モード送信するフィールド
テキストから動画prompt + aspect_ratio
参照生成(画像・動画・音声)prompt + image_urls / reference_video_urls / reference_audio_urls
開始 / 終了フレームprompt + first_frame_url (+ last_frame_url)
動画編集prompt + reference_video_urls (1) + duration: -1 + aspect_ratio: "adaptive"

料金(クレジット)

クレジットは動画の秒単位で課金され、モデル、解像度、参照動画の有無によって変わります。金額はタスク作成時に差し引かれ、失敗した場合は自動的に返金されます。

クレジットをチャージしますか? → 料金ページでチャージ. 1 USD = 100 クレジット。

2.5

Seedance 2.5

最高画質。480p、720p、ネイティブ 4K に対応。

解像度入力レート例
480pテキスト / 画像 / 音声28 クレジット / 秒出力 10 秒 = 280 クレジット
480p参照動画あり17 クレジット / 秒参照 5 秒 + 出力 10 秒 = 255 クレジット
720pテキスト / 画像 / 音声63 クレジット / 秒出力 10 秒 = 630 クレジット
720p参照動画あり38 クレジット / 秒参照 5 秒 + 出力 10 秒 = 570 クレジット
4kテキスト / 画像 / 音声251 クレジット / 秒出力 10 秒 = 2510 クレジット
4k参照動画あり155 クレジット / 秒参照 5 秒 + 出力 10 秒 = 2325 クレジット
Flash

Seedance 2.5 Flash

より高速で低価格。480p と 720p に対応。

解像度入力レート例
480pテキスト / 画像 / 音声18.5 クレジット / 秒出力 10 秒 = 185 クレジット
480p参照動画あり11.5 クレジット / 秒参照 5 秒 + 出力 10 秒 = 173 クレジット
720pテキスト / 画像 / 音声41 クレジット / 秒出力 10 秒 = 410 クレジット
720p参照動画あり25.5 クレジット / 秒参照 5 秒 + 出力 10 秒 = 383 クレジット

reference_video_urls を送る場合、参照動画の秒数には低めの動画入力レートが適用され、出力秒数が加算されます。動画編集(duration -1)は入力動画の長さの 2 倍で課金されます。合計はクレジット単位に切り上げられます。

API エンドポイント

POST/v3/generate

Seedance 2.5 または Seedance 2.5 Flash のジョブを開始します。呼び出しはすぐに task_id を返します。/v3/status をポーリングするか、callback_url を渡して結果を取得してください。

リクエストボディ

Body ParametersJSON
prompt:string

テキストプロンプト(必須、最大 5000 文字)。

model:optional string

seedance-2.5(デフォルト)または seedance-2.5-flash。 Defaults to seedance-2.5.

duration:optional number

出力の長さ(秒):4 から 30 までの任意の整数。動画編集では -1 を使用し、出力は入力動画と同じ長さになります。 Defaults to 5.

resolution:optional string

Seedance 2.5:480p、720p、4k。Seedance 2.5 Flash:480p または 720p。1080p は利用できません。 Defaults to 720p.

aspect_ratio:optional string

16:9、9:16、4:3、3:4、adaptive。動画編集では adaptive が必須です。 Defaults to 16:9.

image_urls:optional string[]

参照画像 URL を最大 4 件(http/https)。各画像の使い方をプロンプトで説明してください。

first_frame_url:optional string

開始フレームとして使用する画像 URL。image_urls、reference_video_urls、reference_audio_urls と併用できません。

last_frame_url:optional string

終了フレームとして使用する画像 URL(任意)。first_frame_url が必要です。

reference_video_urls:optional string[]

参照動画 URL を最大 3 件、合計 30 秒まで。動画編集では 4 秒から 30 秒の動画をちょうど 1 件送信してください。

reference_audio_urls:optional string[]

参照音声 URL を最大 3 件。例:音楽やボイストラック。

generate_audio:optional boolean

動画と一緒にサウンドトラックを生成します。 Defaults to true.

web_search:optional boolean

プロンプト内の被写体について、モデルがウェブを検索できるようにします。 Defaults to false.

callback_url:optional string

タスク完了時に呼び出される Webhook(任意、公開 URL。localhost は不可)。

public:optional boolean

任意:結果を公開ギャラリーに表示することを許可します。

テキストから動画

json
1{
2 "model": "seedance-2.5",
3 "prompt": "A slow dolly shot through a neon-lit street in the rain",
4 "aspect_ratio": "16:9",
5 "resolution": "720p",
6 "duration": 10
7}

参照画像 + 音声

json
1{
2 "model": "seedance-2.5",
3 "prompt": "The woman in the reference image dances to the beat of the reference audio in a sunlit studio",
4 "image_urls": ["https://example.com/character.jpg"],
5 "reference_audio_urls": ["https://example.com/beat.mp3"],
6 "aspect_ratio": "9:16",
7 "resolution": "720p",
8 "duration": 8
9}

開始・終了フレーム(Flash)

json
1{
2 "model": "seedance-2.5-flash",
3 "prompt": "The flower bud slowly opens into full bloom",
4 "first_frame_url": "https://example.com/bud.jpg",
5 "last_frame_url": "https://example.com/bloom.jpg",
6 "resolution": "480p",
7 "duration": 6
8}

動画編集

json
1{
2 "model": "seedance-2.5",
3 "prompt": "Change the season to winter with falling snow; keep the camera motion",
4 "reference_video_urls": ["https://example.com/input-12s.mp4"],
5 "aspect_ratio": "adaptive",
6 "duration": -1,
7 "resolution": "720p"
8}

4K 出力

json
1{
2 "model": "seedance-2.5",
3 "prompt": "Macro shot of morning dew rolling off a green leaf",
4 "aspect_ratio": "16:9",
5 "resolution": "4k",
6 "duration": 5
7}

レスポンス

Task created

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n90a1b2c3d4e5f6sd25",
6 "status": "IN_PROGRESS",
7 "consumed_credits": 630
8 }
9}
GET/v3/status

status が SUCCESS または FAILED になるまで task_id でポーリングします。ここで返されるのは /v3/generate で作成されたタスクのみです。

クエリパラメータ

Body ParametersJSON
task_id:string

POST /v3/generate が返すタスク ID(sd25 で終わる)。

リクエスト例

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

Tip: status が SUCCESS の場合、data.response は動画 URL の配列です。最初の URL には data.response[0] を使ってください。保存が必要な場合はファイルをダウンロードしてください。

javascript
1const videoUrl = data.response[0];

レスポンス

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n90a1b2c3d4e5f6sd25",
6 "status": "SUCCESS",
7 "consumed_credits": 630,
8 "created_at": "2026-11-19T10:30:00Z",
9 "type": "seedance-2.5-t2v",
10 "request": {
11 "model": "seedance-2.5",
12 "prompt": "A slow dolly shot…",
13 "aspect_ratio": "16:9",
14 "duration": 10
15 },
16 "response": [
17 "https://cdn.example.com/videos/n90a1b2c3d4e5f6sd25.mp4"
18 ],
19 "error_message": null
20 }
21}

API プレイグラウンド

ブラウザで API を試せます。YOUR_API_KEY を実際のキーに置き換えてください。成功した呼び出しはすべて課金されます。

API プレイグラウンドPOST

エラーコード

Status発生条件
400 不正なリクエストパラメータが欠落しているか無効です。例:サポートされていない model、resolution、aspect_ratio、duration、メディア URL など。メッセージにどれかが示されます。
401 認証エラーAPI キーがないか無効です。
402 このタスクに必要なクレジットが不足しています。
404 見つかりませんタスクが存在しないか、/v3/generate で作成されたものではありません。
500 サーバー内部エラーサーバーエラーです。後で再試行してください。失敗したタスクは自動的に返金されます。