Seedance 2.5 API：エンドポイント、認証、動画生成の開発者ガイド

Seedance 2.5は、長尺かつマルチモーダルな動画モデルです。つまり、これを動かすAPIは1リクエスト／1レスポンスではなく、非同期で動作します。生成タスクを送信し、完了をポーリングし、結果をダウンロードする、という流れになります。このパターンと、エンドポイント、認証ヘッダー、duration・resolution・参照素材のペイロードフィールドを押さえれば、あとは直感的に理解できるはずです。

本ガイドでは、Seedance 2.5 APIの契約仕様全体を説明します。エンドポイント、認証、リクエストボディ、非同期ポーリング、そのまま動くcurlとPythonのサンプルコードを取り上げます。対象は、モデルに関するByteDanceの契約仕様を踏襲するPixMind api-platformのルートです。さらに、Seedance 2.0およびKlingのAPIパターンとのサイドバイサイド比較、エンドツーエンドの本番パイプライン事例、サードパーティの開発者向けリソース、レート制限・コンカレンシー・webhook・クレジット確認を含む拡張FAQも収録しています。エンドポイントと認証の詳細はすべて、2026-07-31時点のライブバックエンドで検証済みです。

Seedance 2.5 モデル概要

Key Takeaways

エンドポイント： タスク作成は POST /api-platform/v1/generations、結果のポーリングは GET /api-platform/v1/task/{task_id}。

認証： Authorization: Bearer <API_KEY>（または X-API-Key ヘッダー）。PixMindダッシュボードでvideoスコープ付きのキーを作成します。

ペイロード： { model, prompt, duration, resolution, aspect_ratio, reference_images, reference_videos, generate_audio }。

非同期処理： 作成呼び出しは taskId を返します。status が ready になるまでポーリングし、videoUrl を読み取ります。

プロバイダ間の共通形状： Seedance 2.5、Seedance 2.0、Klingはいずれも同じ「送信してポーリング」パターンを採用しています。異なるのはエンドポイントパス、参照素材の上限、フィールド名だけです。

本番パターン： 作成時に Idempotency-Key を付与し、上限付きリトライとバックオフでポーリングし、送信前にクレジットを確認し、イテレーションではより安価なルートにフォールバックします。

APIアクセスは PixMind で Coming Soon（近日公開）： ルートはドキュメント化され準備完了、バックエンド接続の最終調整が進められています。

前提条件：APIキーを取得する

Seedance 2.5の呼び出しは、アカウントに紐付くスコープ付きAPIキーで認証されます。PixMind api-platformダッシュボードでキーを作成し、安全に保管してください。他のシークレットと同様に扱います。コード内では、ソース管理にコミットするのではなく、環境変数から読み込むようにします：

export PIXMIND_API_KEY="pk-xxxxxxxxxxxxxxxx"

APIキーを作成

PixMindでは、キーの権限はワークロード（image／video）ごとにスコープされます。Seedance 2.5を呼び出す前に、キーで video 権限が有効になっていることを確認してください。

Developer note: 環境（dev／staging／prod）ごとにキーをローテーションし、各キーは必要最小限のワークロードにスコープしましょう。videoスコープだけを持つstagingキーがimageパイプラインに漏れ出すことはないため、キーが漏洩した場合の被害範囲を限定できます。キーは定期的に再発行し、最終使用タイムスタンプをログに記録しておくと、休眠中のキーの特定と失効が容易になります。

Watch：Seedance 2.5 ワークフローのチュートリアル

コードを書く前に2.5アップグレードを最速で理解するには、公式デモ映像とコミュニティ分析を視聴するのが一番です。以下2つのチュートリアルは、APIが公開する30秒のネイティブ生成、4K出力、リージョンレベル編集、50件の参照素材を使ったワークフローをカバーしています：

noscriptフォールバック：Seedance 2.5 デモ（YouTube）、30秒のネイティブクリップ、リージョンレベル編集、50件のマルチモーダル参照素材を収録。

本番パイプラインにとってワークフローのアップグレードが何を意味するかをより深く議論する編集記事としては、公式リールと併せて「Seedance 2.5 Changes Everything」の分析を見る価値があります：

noscriptフォールバック：Seedance 2.5 Changes Everything（YouTube）。

Seedance 2.5 API の契約仕様

エンドポイント

生成タスクの作成：

POST /api-platform/v1/generations

完了のポーリング：

GET /api-platform/v1/task/{task_id}

作成エンドポイントは、統一された生成のエントリポイントです。model フィールドを読み取って適切にディスパッチします。model: "seedance-2.5" を送信すると、ルートが動画パイプラインを処理します。

認証

APIキーはBearerトークンとして送信します（OpenAI SDK互換）：

Authorization: Bearer $PIXMIND_API_KEY

認証ミドルウェアは、お好みで X-API-Key ヘッダーも受け付けます。両方ともサポートされており、どちらかを選んでクライアントコード全体で一貫して使用すれば、ログとリトライの追跡が容易になります。

リクエストボディ

フィールド	型	必須	説明
`model`	string	はい	モデルID。このルートでは `seedance-2.5`。
`prompt`	string	はい	自然言語でのショット指示。
`duration`	integer	いいえ	クリップの長さ（秒）。このルートでは最大30。
`resolution`	string	いいえ	`480p`、`720p`、`1080p`、`4K`。
`aspect_ratio`	string	いいえ	`16:9`、`9:16`、`1:1`、`4:3`、`3:4`。
`reference_images`	string[]	いいえ	アイデンティティ、製品、スタイルなどに使う公開画像URL（マルチモーダル入力は合計50件まで）。
`reference_videos`	string[]	いいえ	モーションやシーンのガイダンスに使う公開動画URL。
`generate_audio`	boolean	いいえ	モードが対応している場合に同期音声を生成します。

参照素材について： Seedance 2.5は1リクエストで最大 50件のマルチモーダル入力（画像、動画、テキスト、音声の組み合わせ）を受け付けます。各参照素材には明示的な役割（アイデンティティ、形状、モーション、カラーパレット、リズム）を1つだけ割り当て、同じプロパティを奪い合うアセットは除外しましょう。

Seedance 2.5動画に構成されるマルチモーダル参照入力

Seedance 2.5 API と Seedance 2.0、Kling の比較

現在の主要な動画生成APIの多くは、同じ非同期形状を共有しています。タスク作成用のPOST1つ、完了するまでポーリングするGET1つです。異なるのは、エンドポイントパス、認証規約、参照素材の上限、ペイロードのフィールド名です。下の表は、統合を計画する際に開発者が最も比較対象とする3つのAPIについて、それらの違いを整理したものです。

項目	Seedance 2.5 API（PixMind ルート）	Seedance 2.0 API（PixMind ルート）	Kling API（サードパーティ）
作成エンドポイント	`POST /api-platform/v1/generations`	`POST /api-platform/v1/generations`	`/v1/videos/text2video` と `/v1/videos/image2video` が分離（ライブのKling APIドキュメントで要確認）
ディスパッチ	本文で `model: "seedance-2.5"`	`model: "seedance-2.0-pro"`／`-fast`／`-mini`	モデルフィールドではなくエンドポイント選択
認証	`Authorization: Bearer <key>` または `X-API-Key`	同上	Kling APIキーからJWTフローで発行されるBearerアクセストークン（プロバイダ固有）
ポーリングエンドポイント	`GET /api-platform/v1/task/{task_id}`	同上	`GET /v1/videos/<id>` 形式
単発の最大長	最大30秒	5／10／15秒	第一当事業者のKlingでは通常5〜10秒、一部プロバイダルートでは更长
マルチモーダル参照	最大50（画像／動画／テキスト／音声）	最大9	エンドポイントに応じてimage-to-videoや最初／最後のフレームモード
音声	対応モードでは統合生成	対応	一部モードで対応
検証日	2026-07-31（PixMind ルート）	2026-07-31（PixMind ルート）	推定値。統合前にライブのKlingドキュメントで要確認

実運用からの気づき： 非同期形状が共通しているため、クライアントコードはプロバイダ間で再利用できます。作成〜ポーリングのループを1つの generate_video(model, payload) 関数にまとめ、モデルIDを差し替えれば、同じハーネスからSeedance 2.5、Seedance 2.0 Fast、KlingをA/Bテストできます。ショットごとに適切なルートを選ぶ上で、統合コードを書き直さずに済む最もコストの低い方法です。

実務上のポイント：すでにSeedance 2.0向けのポーリングクライアントを構築済みのチームであれば、2.5の導入はモデル文字列の変更と、新しい参照素材・durationフィールドの追加だけで済みます。統合の設計をやり直す必要はありません。

Seedance 2.5 と Kling のモデル比較

ステップ 1：生成タスクを作成する

以下は最小限の作成リクエストです。テキストプロンプトで5秒・720p・16:9のクリップを指定しています。Idempotency-Key ヘッダーは任意ですが、本番送信では推奨されます：

curl -X POST https://aihub-admin.aimix.pro/api-platform/v1/generations \
  -H "Authorization: Bearer $PIXMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A courier in a yellow jacket cycling through a neon-lit rainy Tokyo street at night, tracking shot, cinematic, no text",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

成功レスポンスはタスクIDを返します。ここでは動画本体は返らず、ポーリング用のハンドルを受け取ります：

{
  "code": 1000,
  "data": {
    "taskId": "47264",
    "type": "video",
    "status": "processing"
  }
}

code: 400 で「模型不存在或未配置」（モデルが存在しないか設定されていません）が返る場合、そのエンドポイントでは seedance-2.5 のバックエンドルートがまだ有効化されていません。これは、接続が最終調整中のPixMindでのComing Soon状態です。

ステップ 2：ready になるまでタスクをポーリングする

動画生成は非同期です。ステップ1の taskId を使ってタスクエンドポイントをポーリングします：

curl -X GET https://aihub-admin.aimix.pro/open-api/v1/task/47264 \
  -H "Authorization: Bearer $PIXMIND_API_KEY"

status フィールドは pending → processing → ready の順に遷移します。3〜5秒ごとにポーリングしてください。タスクが ready になると、レスポンスに最終的な動画URLが含まれます：

{
  "code": 1000,
  "data": {
    "taskId": "47264",
    "status": "ready",
    "progress": 100,
    "videoUrl": "https://.../seedance-2-5-47264.mp4",
    "coverUrl": "https://.../seedance-2-5-47264-cover.webp"
  }
}

終端失敗ステータスは failed、error、canceled、cancelled です。これらをハンドリングし、description フィールドをログに出力してください。

Developer note: 単一タスクなら3〜5秒間隔のポーリングで十分ですが、スケールするとリクエスト数はすぐに増殖します。20タスクのキューでは、各オープンタスクをサイクルごとに1回ポーリングする単一のディスパッチャループを採用し、タスクの経過時間に応じて指数バックオフ（5s、5s、10s、15s、上限30s）を適用するのが望ましいです。これにより、バッチ全体のp99レイテンシを伸ばすことなく、礼儀正しいリクエスト量を保てます。

ステップ 3：結果をダウンロードして利用する

status が ready になったら、videoUrl をダウンロードします（ポスターフレームとして coverUrl も任意で取得）。ファイルは標準的なMP4です。アプリケーションの要件に合わせてトランスコード、ホスト、埋め込みを行ってください。

ウェブのランディングページであれば、典型的にはH.264・fast-start付きの8〜10秒クリップに圧縮して自動再生に備え、WebPポスターを抽出し、両方を自社CDNにホストします（PixMindはSeedance 2.5の事例メディアを cdn.pixmind.io にホストしています）。APIホストの videoUrl を本番でホットリンクしないでください。API URLの永続性は保証されていません。

Seedance 2.5生成のネイティブ4K静止画

Python完全サンプル

以下は、タスクを作成し、readyになるまでポーリングし、動画URLを出力する、完全に実行可能なPythonスニペットです。hello-world例が省略しがちな、本番クライアントに必要な3つの要素、Idempotency-Key、上限付きリトライループ、タイムアウト上限を追加しています：

import time
import uuid
import requests

API_BASE = "https://aihub-admin.aimix.pro"
API_KEY = "your-pixmind-api-key"  # スコープ: video

GEN = f"{API_BASE}/api-platform/v1/generations"
TASK = f"{API_BASE}/open-api/v1/task"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

# 1. 冪等キー付きで作成し、リトライ時に2回目の課金タスクが発火しないようにする
payload = {
    "model": "seedance-2.5",
    "prompt": "A 30-second continuous hero shot: a character walking through a neon city that flows into a product reveal",
    "duration": 30,
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "generate_audio": True,
}
headers = {**HEADERS, "Idempotency-Key": str(uuid.uuid4())}
create = requests.post(GEN, headers=headers, json=payload, timeout=30).json()
task_id = create["data"]["taskId"]
print(f"Task created: {task_id}")

# 2. 上限付きリトライと緩やかなバックオフでポーリング
max_attempts, delay = 100, 5
for attempt in range(max_attempts):
    time.sleep(delay)
    t = requests.get(f"{TASK}/{task_id}", headers=HEADERS, timeout=15).json()
    status = t["data"]["status"].lower()
    print(f"attempt={attempt + 1} status={status} progress={t['data'].get('progress', 0)}%")
    if status in ("ready", "succeeded", "completed"):
        print("Video URL:", t["data"]["videoUrl"])
        break
    if status in ("failed", "error", "canceled", "cancelled"):
        raise RuntimeError(f"Task failed: {t['data']}")
    delay = min(delay + 2, 30)  # バックオフ、上限30秒
else:
    raise TimeoutError(f"Task {task_id} did not finish in {max_attempts * 5}s")

エンドツーエンド事例：30秒の製品動画パイプライン

ここは多くのAPIガイドが省く部分です。実チームが上の契約仕様をどうやって再現可能な本番パイプラインに組み上げるか。シナリオは、D2Cブランドの4人クリエイティブチームが、固定予算と厳しい締切の中で製品ローンチ向けの30秒ヒーロー動画を制作する、というものです。以下のパターンは、一貫してスケジュール通りに納品できる形状を示しています。

パイプラインの概要

チームは作業を4つのステージに分割します。イテレーション（Seedance 2.0 Fastで安価なA/Bテスト）、最終生成（Seedance 2.5で1080p／30秒を1回）、レビューとリージョン編集（Seedance 2.5のリージョン再生成をターゲット指定で実行）、納品（トランスコード、ポスター、CDNアップロード）です。各ステージは同じクライアントコードを使い、変更するのはモデルIDとペイロードだけです。この分離こそが、パイプラインをキャンペーン間で再現可能にする要点です。

参照素材の割り当て

API呼び出しの前に、チームは各参照素材に単一の明示的な役割を割り当て、プロンプトとペイロードが同期するように共有スプレッドシートに記録します。50件入力バジェットのうち5件、それぞれに1つだけ役割を持たせます：

アセット	役割	参照方法
`character.jpg`	アイデンティティ（配達員）	プロンプト内で `@Image 1`
`product.jpg`	製品形状	プロンプト内で `@Image 2`
`studio-palette.png`	カラーパレット	プロンプト内で `@Image 3`
`camera-motion.mp4`	カメラワーク	プロンプト内で `@Video 1`
`rhythm.wav`	カットのリズム	プロンプト内で `@Audio 1`

プロンプトはそれぞれを明示的にマッピングします。「@Image 1 のキャラクターは変更しない、@Image 2 の製品に合わせる、@Video 1 はカメラモーションのみに使用、カットは @Audio 1 に合わせる」といった具合です。このマッピングこそが、クリエイティブディレクションとAPIペイロード間の契約です。役割が割り当てられない参照素材はリクエストに入れません。

イテレーションステージ（コスト管理）

30秒の2.5実行に予算を投じる前に、チームはSeedance 2.0 Fastで5秒・720pにてプロンプトと参照素材を検証します。これは同じ POST /api-platform/v1/generations 呼び出しで、model: "seedance-2.0-fast" を指定します。3回のイテレーションでも2.5実行1回のごく一部のコストであり、予算コミット前に参照素材の競合を洗い出せます。ディスパッチャは各イテレーションの taskId、ステータス、経過秒数をログに記録し、クリエイティブリードがバリアントをサイドバイサイドで比較できるようにします。

実運用からの気づき： このステージを飛ばして30秒の2.5生成に直行するチームは、典型的には3〜4回の定価実行分を、Fast段階で捕捉できたはずのプロンプト競合の修正に浪費します。イテレーションステージはパイプライン全体で最もROIが高い部分であり、安定して納品するチームはここを必須とみなしています。

最終生成（Seedance 2.5で30秒／1080p）

Fastイテレーションでプロンプトの意図が正しく読めることを確認したら、チームは本番生成を送信します。model: "seedance-2.5"、duration: 30、resolution: "1080p"、5件すべての参照素材を添付し、役割マッピング済みの完全なプロンプトを指定します。作成呼び出しには Idempotency-Key を含め、CIランナーからのネットワークリトライが2回目の課金タスクを発火させないようにします。クリエイティブリードは、ディスパッチャにコミットを許可する前に、最終 taskId 送信ログをレビューします。これだけで高額なプロンプトの誤入力を防げる、1分程度のチェックです。

ポーリング、エラー、冪等性

単一のディスパッチャがタスクを5秒ごとにポーリングし、30秒までバックオフ、最大100回（約8分）で上限とします。終端失敗（failed、error）が起きた場合、失敗descriptionが一時的なバックエンド問題を示しているときのみ、新しい Idempotency-Key で1回だけリトライします。参照素材やプロンプトのエラーはクリエイティブリードにエスカレーションされ、再送前に修正されます。盲目的なリトライは行いません。ディスパッチャは試行ごとに構造化ログ1行（タスクID、ステータス、進捗、経過秒数）を書き出し、ローンチ後にコストとレイテンシを監査できるようにします。

リージョン編集

レビューの結果、クライアントから最終ショットの右側の棚の製品を差し替えたいという要望が来ます。チームはその領域だけをターゲットにしたリージョンレベル編集タスクを送信し、クリップ残り部分のモーションとアイデンティティを保持します。これこそクライアントワークにおける2.5の最も価値ある機能です。1日がかりの往復が10分の再生成になります。パイプラインは元の taskId と編集の taskId をプロジェクトログで紐付けて保持し、納品されたすべてのフレームの来歴を追跡可能にします。

納品

readyになった videoUrl をダウンロードし、ウェブ自動再生用に fast-start 付きのH.264にトランスコードし、coverUrl から抽出したWebPポスターをペアにして、チームのCDNにアップロードします。最終アセットはランディングページにプッシュされ、公開前にフレーム単位でレビューされます（アイデンティティ、手、製品形状、ロゴ、音声同期）。

コスト規律

パイプラインは3箇所で支出に上限を設けます。第1に、イテレーション実行は2.5ではなくFastで行います。第2に、2.5送信前にクレジット事前確認を行い、選択したdurationとresolutionに対する閾値をウォレット残高が下回っていればアボートします。第3に、ディスパッチャにローンチごとのハードなタスク予算を設定し、上限に達したら新規タスクの送信を拒否します。Seedance 2.5の価格は未公開のため、チームは秒あたりの数値をすべて推定として扱い、各キャンペーン前にライブジェネレーターで現在クレジットを確認します。

50件のマルチモーダル参照素材の取り扱い

目玉機能である「最大50件のマルチモーダル入力」は、ペイロード上は公開URLの配列として現れます：

{
  "model": "seedance-2.5",
  "prompt": "Keep the character from the first image unchanged; use the video for body motion and the audio for rhythm",
  "duration": 20,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "reference_images": ["https://cdn.example.com/character.jpg", "https://cdn.example.com/product.jpg"],
  "reference_videos": ["https://cdn.example.com/motion.mp4"],
  "generate_audio": true
}

すべての参照URLは公開到達可能でなければなりません。それぞれに役割を1つだけ割り当て、その役割をプロンプト内で記述します（例：「@Video 1 はボディモーションのみに使用」）。これにより、モデルはどの入力がどのプロパティを制御するかを把握できます。

Developer note: 送信前に、すべての参照URLが期待するcontent-typeでHTTP 200を返すことを事前検証しましょう。CDN保護されたアセットでの403が、本番で failed タスクを引き起こす最も一般的な原因であり、生成予算全体を無駄にします。クライアント側での2行のHEADリクエストチェックで、この系統の失敗を完全に防げます。また、キャンペーン途中でアセットを差し替えてもモデルが受け取る内容が暗黙に変わらないよう、安定したコンテンツアドレス型URL（例：パスにハッシュやバージョンを含める）を使用してください。

エラー処理と冪等性

401「API Key 无效」、キー違い、またはキーにvideoスコープがない状態。キーとその権限を確認してください。
400「模型不存在或未配置」、このバックエンドでは seedance-2.5 ルートがまだ有効化されていません。PixMindではComing Soon状態です。
4001「余额不足」、リクエストは有効ですがウォレットにクレジットがなく、タスクは作成されません。
429 レート制限、指数バックオフでリトライしてください。作成エンドポイントはキーごとのコンカレンシーとリクエストレートの上限を強制します。頻繁に引っかかる場合は、サポートに連絡して上限引き上げを相談するか、短い間隔で送信を段階的にずらしてください。
502／504 ゲートウェイエラー、一時的です。同じ Idempotency-Key で作成呼び出しをリトライすれば、バックエンドが重複排除し、2回目の課金タスクは発火しません。
ポーリングタイムアウト、試行回数に上限を設け（例：100回×5秒＝約8分）、タイムアウトは1回だけリトライする失敗として扱います。

本番では、クライアントのリトライが2回目の課金タスクを発火させないよう、すべての作成呼び出しで Idempotency-Key ヘッダーを渡してください。論理タスクごと（HTTP試行ごとではなく）にUUIDを1度だけ生成して自側で保持し、同じ論理生成がリトライ、CI再実行、キューのリプレイをまたいで重複排除されるようにします。具体的なパターンは、ユーザー（またはジョブランナー）がタスク作成を決めた時点でUUIDを生成し、最初のHTTP呼び出し前に永続化し、同じ論理タスクのリトライすべてで再利用する、というものです。

サードパーティの開発者向けリソース

上の契約仕様はPixMindでの実装パスです。ByteDanceの基盤モデルと公式APIサーフェスについてより深い文脈が必要な場合、開発者が最もよく参照するリソースを以下に挙げます（2026-07-31時点で検証済み）：

BytePlus Seedance 2.5 リソースページ、ai.byteplus.com/lumina/en/resource/bytedance-seedance-2-5。ByteDance自身による2.5の枠付けで、広告動画生成や製品デモを中心に構成されています。機能のナラティブと、ByteDance自身がターゲットにするユースケースを把握するのに有用です。2026-07-31掲載確認済み。
BytePlus ModelArk API ドキュメント、ByteDanceのクラウド経由でSeedanceを呼び出すための公式開発者サーフェス。接続されたルートが何を公開しているか確認する必要があるときにフィールド名とモードを相互参照し、それらの名前をクライアントにミラーリングしてください。
Volcengine 火山方舟（Volcano Engine Ark）ドキュメント、volcengine.com/docs/82379。同一モデルファミリーの中国国内エンドポイント。非同期の送信〜ポーリングパターンはPixMindルートと同じですが、フィールド名と認証フローはわずかに異なります。2026-07-31掲載確認済み。統合前にライブパスを要確認。
MakeFun AI デモ再現ガイド、makefun.ai/seedance-2-5-demo-videos/。BytePlus ModelArkの参照素材多用型デモワークフローを再現する手順を解説。独自のプロンプトを設計する前に公式の見た目を再現したい場合に役立ちます。
コミュニティ分析、Topview/Mediumの2.5解説、PixoのFORCEカバレッジ、ToSeaの完全ガイドはいずれも編集視点からワークフローのアップグレードを取り上げています。文脈把握には有用ですが、エンドポイントの詳細については不十分です。技術的な仕様は必ずライブAPIで確認してください。

Developer note: サードパーティのガイドは古くなりがちです。いずれも出発点として扱い、エンドポイントパス、フィールド名、クレジットコストは統合当日に接続ルートに対して確認してください。本ガイドのエンドポイントと認証の詳細は2026-07-31検証済みですが、モデルはまだロールアウト中のため、本番ローンチ前に再確認してください。

Seedance 2.5 API FAQ

Seedance 2.5 APIのエンドポイントは何ですか？

タスク作成は POST /api-platform/v1/generations、その後 status が ready になるまで GET /api-platform/v1/task/{task_id} をポーリングします。モデルフィールドは seedance-2.5 です。

Seedance 2.5 APIではどう認証すればよいですか？

APIキーを Authorization: Bearer <key> として送信します。X-API-Key ヘッダーも受け付けられます。PixMindダッシュボードでvideo権限付きのキーを作成し、ソースに埋め込まず環境変数から読み込んでください。

Seedance 2.5 APIはPixMindで利用可能ですか？

ルートはドキュメント化され準備完了、バックエンドアクセスは最終調整中で、モデルはComing Soonとしてマークされています。/api-platform/models/seedance-2-5 ページにエンドポイントとパラメータのリファレンスがあり、/ai-video/seedance-2-5 ページではその間ウェブジェネレーターを利用できます。

1リクエストで送れる参照素材は何件ですか？

1リクエストで最大50件のマルチモーダル入力（画像、動画、テキスト、音声の組み合わせ）。Seedance 2.0の9件から増加しました。すべての参照素材は公開到達可能なURLでなければなりません。

Seedance 2.5 APIは動画を同期的に返しますか？

いいえ。動画生成は非同期です。作成呼び出しは taskId を返し、タスクエンドポイントを status が ready になるまでポーリングしてから videoUrl を読み取ります。典型的な30秒生成には数分かかるため、クライアントはブロッキングではなくポーリング前提で設計してください。

レート制限とコンカレンシー上限はどうなっていますか？

作成エンドポイントはキーごとのリクエストレートとコンカレンシー上限を強制します。超過するとレスポンスは429を返すため、指数バックオフでリトライしてください。バッチワークロード（少数の同時タスクを超える場合）では、短い間隔で送信を段階的にずらし、429が頻出する場合はサポートに連絡して上限引き上げを相談してください。数値上限はアカウントごとに調整されるため、大規模バッチジョブを設計する前に自分のキーで検証してください。

Seedance 2.5 APIはwebhookやコールバックに対応していますか？

検証済みのPixMindルートはポーリング方式のみで、プッシュコールバックには対応していません。アーキテクチャがプッシュ通知を必要とする場合は、タスクエンドポイントをポーリングして status が終端状態に達したときに下流サービスへwebhookを発行する、単一のディスパッチャを独自に動かしてください。これにより統合がシンプルになり、環境間で変わる可能性のあるコールバックURLにパイプラインが結合されるのを避けられます。

同時タスクは何件まで実行できますか？

コンカレンシーは、キーごとの上限とクレジット残高によって制限されます。30秒・1080pのワークでは、数十件ではなく数件のタスクを並列に実行することを想定してください。ライブ上限は「自分のアカウントで検証済み」として扱いましょう。小規模なキャリブレーションバッチを送信し、同時に pending から processing に遷移するタスク数を測定して、その数に対してキューのサイズを決めてください。

APIが返す動画フォーマットは何ですか？

readyタスクは標準MP4ファイルを指す videoUrl と、ポスターフレーム用の coverUrl を返します。納品ターゲットに必要なフォーマットにダウンロードしてトランスコードしてください（ウェブ向けには fast-start 付きH.264、SNS向けには縦型エンコード、編集マスタリング向けにはProRes）。APIホストの videoUrl は永続性が保証されないため、本番でホットリンクしないでください。ready 時にファイルを自社CDNにコピーしましょう。

送信前にクレジットを確認するにはどうすればよいですか？

選択したdurationとresolutionに対する現在のクレジットコストをライブジェネレーターで確認し、ウォレット残高をチェックします。残高が不足している場合、APIは 4001「余额不足」 を返し、その時点でタスクは作成されません。本番パイプラインでは、タスクごとの閾値を下回る場合に早期アボートする事前送信チェックを追加し、ウォレットでカバーできない作品をキューに入れないようにしてください。

「模型不存在或未配置」エラーはどう直せばよいですか？

この400レスポンスは、呼び出しているバックエンドエンドポイントで seedance-2.5 ルートが有効化されていないことを意味します。PixMindでは、バックエンド接続が最終調整中のComing Soon状態です。ドキュメント通りの /api-platform/v1/generations パスを model: "seedance-2.5"（小文字・厳密）で呼んでいるか確認してください。両方正しくてもエラーが続く場合、ルートはまだアカウントで開放されていません。/api-platform/models/seedance-2-5 ページで提供状況をモニターしてください。

指定可能な解像度と長さは何ですか？

単発で最大30秒まで。解像度は480p、720p、1080p、ネイティブ4K。接続ルートが一部のみを公開する可能性があるため、送信前にライブジェネレーターで正確な選択肢を確認してください。

Seedance 2.5 APIの価格は公開されていますか？

現時点では未公開です。他所で見る秒あたりの数値はすべて推定として扱ってください。送信前に、選択したdurationとresolutionに対する現在のクレジットをライブジェネレーターで確認し、価格更新があった場合でも統合を書き直さずに吸収できるようパイプラインを構成してください。

Seedance 2.5 API で構築を始めよう

Seedance 2.5 APIは、標準的な非同期動画生成の契約仕様です。作成呼び出し1つ、ポーリングループ1つ、ダウンロード1つ。videoスコープ付きのキーを取得すれば、上記のcurlとPythonのサンプルだけで最初の統合をリリースできます。比較表とパイプライン事例は、この契約仕様を単一クリップから、クライアントの編集、予算圧力、締切に耐える再現可能な本番ワークフローへとスケールする方法を示しています。

→ Seedance 2.5 API ルートリファレンス（完全版）を読む、または APIアクセスが最終調整中の間はウェブジェネレーターでモデルを試す。

すべてのSeedanceルートを比較

エンドポイントと認証の詳細は PixMind api-platform バックエンドに対して 2026-07-31 に検証済み。サードパーティリソースリンクも 2026-07-31 検証済み。Kling API の比較項目は推定値であり、ライブの Kling ドキュメントで確認してください。Seedance 2.5 の価格は未公開で推定のみとして扱われます。