doubao-seedance-2-5-flashをPOST /ai/v1/videosで使い、タスクの状態を確認してから、結果をダウンロードします。現在のAIHubMixスキーマでは、480p/720p出力、4〜30秒のクリップ、画像最大10点、動画最大5点、音声最大5点の参照に対応しています。/v1/videosを使っている旧クライアントでは、モデル IDだけでなくエンドポイントも変更する必要があります。
このガイドは2026年11月16日に確認しました。上記の短縮IDとdoubao-seedance-2-5-flash-261115はいずれもモデルスキーマを返し、1080pリクエストを400 schema_violationで拒否しました。別途行った4秒・480pの作成リクエストは402 insufficient_quotaを返し、動画は生成されませんでした。以下の手順は現在のスキーマとドキュメントに基づいていますが、この確認では生成の成功、レイテンシ、MOV出力、編集機能をエンドツーエンドで検証していません。
前提条件とスキーマの確認
Seedance 2.5 Flashのモデルページでは、このガイド全体で使用する短縮IDでモデルが掲載されています。タスクを送信する前に、次の点を確認してください。
- AIHubMixコンソールで非同期メディアタスクを有効にします。この機能が有効になっていないアカウントで発生するエラーとして、
403 async_not_enabledがドキュメントに記載されています。 - API キーにアクセス権があり、アカウントに十分なクレジットがあることを確認します。実際の確認では
402 insufficient_quotaが返され、メッセージはYour account has insufficient quota. Add credits and try again.でした。 - シェルで
AIHUBMIX_API_KEYを環境変数として設定します。ソースファイルやブラウザーコードにキーを含めないでください。 - 現在のスキーマを取得します。スキーマ確認リクエストに認証は不要です。
curl --fail-with-body -sS \
'https://aihubmix.com/call/schema/models/doubao-seedance-2-5-flash/endpoints' \
| jq '.endpoints[] | select(.path == "/ai/v1/videos") | .request.schema'
11月16日時点のスキーマでFlashに記載されているエンドポイントは/ai/v1/videosのみです。resolutionには480pと720p(デフォルトは720p)を指定でき、durationには4〜30の整数、またはモデルに長さを選択させる-1を指定できます。予算を予測しやすくするには、durationを明示的に指定してください。
作成、状態確認、ダウンロード
AIHubMix Video Generation APIでは、作成、状態の照会、ダウンロードがそれぞれ分かれています。作成リクエストがHTTP成功になっても、タスクが受け付けられたことを示すだけです。完了を確認できるのはstatus: "completed"の場合のみです。照会がHTTP 200を返しても、タスク自体のstatus: "failed"を示す場合があります。
テキストから動画へのタスクを送信する
この例では、音声付きの10秒・720p・16:9の商品紹介クリップをリクエストします。テキストのみを使用するため、外部でホストされた参照画像には依存しません。
curl --fail-with-body -sS -X POST https://aihubmix.com/ai/v1/videos \
-H "Authorization: Bearer $AIHUBMIX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "doubao-seedance-2-5-flash",
"prompt": "A matte ceramic espresso cup sits on wet slate as warm morning light sweeps across rising steam. The camera slowly dollies in. Quiet cafe ambience.",
"duration": 10,
"aspect_ratio": "16:9",
"resolution": "720p",
"generate_audio": true
}'
返されたタスクidはすぐに保存してください。GET /ai/v1/videos/{id}を15秒おきに呼び出し、completed、failed、またはcancelledになるまで確認します。処理中の状態確認には動画詳細ルートを使用してください。プロバイダーの状態を更新するため、統合タスクリストでは代用できません。完了後、同じBearerヘッダーを付けてGET /ai/v1/videos/{id}/contentからダウンロードします。
Pythonクライアントの全体例
python3 -m pip install requestsで依存関係をインストールし、次のコードをseedance_flash.pyとして保存してから、API キーを設定したシェルでpython3 seedance_flash.pyを実行します。この例ではドキュメントに記載された手順を実装していますが、前述のクォータエラーにより生成全体のテストはできませんでした。
import os
import time
from pathlib import Path
import requests
BASE_URL = "https://aihubmix.com"
HEADERS = {
"Authorization": f"Bearer {os.environ['AIHUBMIX_API_KEY']}",
"Content-Type": "application/json",
}
PAYLOAD = {
"model": "doubao-seedance-2-5-flash",
"prompt": "A matte ceramic espresso cup sits on wet slate as warm morning light sweeps across rising steam. The camera slowly dollies in. Quiet cafe ambience.",
"duration": 10,
"aspect_ratio": "16:9",
"resolution": "720p",
"generate_audio": True,
}
# Submit once. A network timeout does not prove that creation failed.
response = requests.post(
f"{BASE_URL}/ai/v1/videos", headers=HEADERS, json=PAYLOAD, timeout=60
)
response.raise_for_status()
task = response.json()
task_id = task["id"]
print(f"Task ID: {task_id}", flush=True)
deadline = time.monotonic() + 20 * 60
while task["status"] not in {"completed", "failed", "cancelled"}:
if time.monotonic() >= deadline:
raise TimeoutError(f"Still waiting for {task_id}; query it again, do not recreate it.")
time.sleep(15)
response = requests.get(
f"{BASE_URL}/ai/v1/videos/{task_id}", headers=HEADERS, timeout=30
)
response.raise_for_status()
task = response.json()
if task["status"] != "completed":
raise RuntimeError(f"Task {task_id}: {task.get('error') or task['status']}")
response = requests.get(
f"{BASE_URL}/ai/v1/videos/{task_id}/content", headers=HEADERS, timeout=120
)
response.raise_for_status()
Path("seedance_flash_10s.mp4").write_bytes(response.content)
print("Saved seedance_flash_10s.mp4")
20分の期限はクライアント側の待機上限であり、サーバーでのキャンセルや生成時間の保証ではありません。状態確認またはダウンロードに失敗した場合は、タスクIDを保持してその操作を再試行してください。タイムアウト時やプロバイダーの状態が不確かなときに、生成リクエストを自動で再送しないでください。
BytePlusの公式オンライン推論料金では、Flashの料金は動画入力なしの場合が100万トークンあたり$7.00、480p/720pの動画入力ありの場合が$4.30です。テキストのみの例では、推定トークン数は10 × 1280 × 720 × 24 / 1024 = 216,000となり、720pの場合、Flashでは$1.51、フラッグシップの2.5では$2.31です。これらはBytePlusの計算上の推定値であり、AIHubMixの実測請求額ではありません。
参照素材とWebhook
メディアを使ってクリップを作成する場合は、input_referencesにtype(image_url、video_url、またはaudio_url)と、アクセス可能なメディアを指すurlを含むエントリーを追加します。スキーマ上の上限は、各タイプにつき10 / 5 / 5です。最初と最後のフレームを指定するには、代わりにframe_imagesを使用します。各エントリーにはframe_typeと、ネストされたimage_url.urlがあります。空でないframe_imagesとinput_referencesを併用しないでください。フレームを指定する場合はaspect_ratio: "adaptive"が必要で、最後のフレームを指定するには最初のフレームも必要です。
Async Tasksのドキュメントには、webhook_urlを使ったHTTPSコールバックが記載されています。現在のFlashスキーマにはこのフィールドが含まれていますが、webhook_events_filterはなく、additionalProperties: falseに設定されています。そのため、このモデルスキーマに従う場合、フィルターは省略してください。ドキュメントによると、デフォルトではcompleted、failed、cancelledが送信されます。配信は最低1回保証され、最大6回試行されます。再試行の間隔は1、4、16、64、256秒です。重複をevent_idで排除してください。タスク単位のコールバックには個別の署名シークレットがないため、タスクを照会して最終状態を確認します。署名検証が必要なアプリケーション向けには、アカウント単位のサブスクリプションがドキュメントに記載されています。
エラー:実測内容とドキュメントの記載
1080p:実測で確認されたスキーマ拒否
両方のAIHubMixモデル IDで、resolution: "1080p"を指定した4秒のリクエストがHTTP 400を返しました。返されたエラーフィールドは次のとおりです。
{
"error": {
"code": "schema_violation",
"message": "`resolution` must be one of: 480p, 720p, null.",
"type": "invalid_request_error"
}
}
レスポンスにはリクエストのトレースIDも含まれていましたが、ここでは省略しています。これは実際に観測されたゲートウェイによる拒否であり、上流のエラーを推測したものではありません。生成の成功や速度測定を示すものでもありません。
以下のその他の制約は現在のFlashスキーマに基づいています。これらの無効な組み合わせは、実際の確認では個別に送信していません。
| 入力の問題 | スキーマの要件 | 修正方法 |
|---|---|---|
| 4K出力 | 480pまたは720p | 解像度を下げる |
| 参照素材が多すぎる | 画像10点 / 動画5点 / 音声5点 | 数を減らす |
| 2つの参照配列 | 空でない配列は1つ | どちらかのワークフローを選ぶ |
| 最後のフレームのみ | 最初のフレームも必要 | 両方のフレームを指定する |
| フレーム指定時の固定比率 | Adaptive比率 | adaptiveを使用する |
実在人物の参照素材:認証済みアセットを使用する
Doubaoが実在人物の画像に対して固有のプライバシー拒否を返した場合、AIHubMixではdoubao_real_person_requiredが記載されています。この確認では、このエラーは発生しませんでした。ドキュメントに記載されたメッセージは次のとおりです。
このリクエストでは実在人物の画像を使用しています。実在人物の認証を完了し、有効なアセット参照を使用してください。https://docs.aihubmix.com/cn/api/doubao-real-person-assetsを参照してください。
Doubao Real-Person Assets Guideに従ってください。/ai/v1/asset-groupsでグループを作成し、/ai/v1/asset-groups/{id}/verification-sessionsで認証セッションを作成します。画像に写っている人物にウェブでの認証を完了してもらい、/ai/v1/asset-groups/{id}/assetsでアセットを登録して、有効になるまで待ちます。生成時の参照にはasset://<ASSET_ID>を使用してください。写真のURLだけでは、同意取得とアセット登録の手順を代替できません。
クォータ、リクエストサイズ、ダウンロード
実測された402 insufficient_quotaにより、解像度が有効なリクエストは生成処理まで進みませんでした。再試行する前にクレジットを追加してください。正しいプロンプトやモデル IDを変更しても、このレスポンスは解決しません。403 async_not_enabledは別のエラーで、ドキュメントに記載された前提条件の不足を示し、コンソールでの有効化が必要です。
AIHubMixのドキュメントには、リクエストボディの上限が32 MiBで、413 request_too_largeが返されると記載されています。公開URLを使えば、リクエストボディ内でBase64によりデータが膨張するのを避けられます。ただし、参照先のメディアもモデル固有のサイズと形式の制限を満たす必要があります。
完了した動画は速やかに保存してください。AIHubMixの既存のSeedance 2.5連携ガイドでは、出力URLの有効期間は約30分と短いことが警告されています。Flashでの固定された保持期間は、ここでは確認していません。動画APIはexpires_at: nullを返すことがありますが、これは無期限保存を保証するものではありません。ダウンロードに関するドキュメント記載のエラーには410 artifact_expiredと429 too_many_downloadsがあります。ダウンロードで一時的なサービスエラーが発生した場合は、クリップを再生成するのではなく、既存のタスクから再度ダウンロードしてください。
有効なリクエストでも注意が必要な移行時の落とし穴
Volcengine Seedance 2.5ガイドでは、Flashもファミリーに含まれることが明記され、MOV出力、編集、延長に対応することが確認されています。ただし、これらベンダー側の機能は、ゲートウェイ経由で検証できた内容とは区別する必要があります。
- MOVと編集用フィールドは公開されていますが、ここではエンドツーエンドでテストしていません。Flashのスキーマでは、
extra.output_format: "mp4"または"mov"、およびextra.omni_reference_task_typeのauto、reference、edit、extendが受け付けられます。タスク種別のフィールドを明示的に送信する場合、空ではないinput_referencesが必要です。さらにeditでは、動画参照、adaptive比率、duration: -1が必要です。extendでは、動画参照とadaptive比率が必要です。 - タスク種別を明示しても、モデルがその指定に同意するとは限りません。Arkでは、推定されたタスク種別とパラメーターが矛盾する場合に非同期の
InvalidParameter.TaskTypeConstraintが返され、明示的に指定されたタスク種別と推定結果が異なる場合にはInvalidParameter.TaskTypeMismatchが返されると記載されています。AIHubMixでの正確な対応関係は実測していません。ゲートウェイコードを決めつけず、返されたタスクのerrorを確認してください。 - FlashはDraftからの昇格に対応していません。ベンダーは、480pのDraftから最終版へ進む2段階ワークフローをフラッグシップの2.5に限定しています。Flashはこれに対応しておらず、AIHubMixの現在の両モデルのスキーマにも
draftとdraft_taskは含まれていません。 - 動画入力は料金に影響します。公式の料金計算では、入力動画と出力動画の長さが考慮され、トークン数の最低値が適用される場合もあります。100万トークンあたり$4.30という料金は、動画を使ったジョブの費用が、条件の同じテキストのみのジョブより安くなることを保証するものではありません。計算式だけに頼らず、実際の使用量とアカウントの請求額を確認してください。
- 一部の説明には曖昧さが残っています。Flashのゲートウェイスキーマには
extra.priority、extra.safety_identifier、extra.toolsが公開されていますが、説明には依然として「2.0 series only」と記載されています。一方、Arkのタスク作成リファレンスでは、2.5ファミリーについてもpriorityとtoolsが列挙されています。スキーマに項目があるだけでは、AIHubMixでの効果は確認できません。本番環境で利用する前に、個別の機能を検証してください。
事前確認チェックリスト
- 非同期タスクを有効にし、アカウント残高を確認します。
/ai/v1/videosでは短縮版のFlash IDを使い、最新のスキーマを取得します。- 480pまたは720pを選び、4~30秒の範囲で再生時間を明示的に指定します。
- 参照素材は、画像10枚、動画5本、音声クリップ5件以内にします。
- フレーム参照は分けて指定し、アスペクト比にはadaptiveを使います。
- 実在人物の肖像を参照する場合は、検証済みの有効なアセットを経由します。
- タスク IDを保存し、タスクの最終ステータスを確認して、速やかにダウンロードします。
- 生成状態が不明な場合は、既存のタスクに対してステータス照会やダウンロードを再試行します。
よくある質問
FlashでOpenAI互換の/v1/videosパスを使えますか?
現在のFlashスキーマに記載されているのは/ai/v1/videosのみです。このガイドの例では、ネイティブの非同期パスを使用してください。
aspect_ratio: "16:9"を指定すると、フレーム画像のリクエストが失敗するのはなぜですか?
Flashのスキーマでは、空でないframe_imagesを指定する場合、aspect_ratio: "adaptive"が必須です。また、最後のフレームを指定するには最初のフレームも必要で、フレーム参照と空でないinput_referencesは併用できません。
doubao_real_person_requiredを解決するにはどうすればよいですか?
本人確認とアセット登録の手順に従い、アセットが有効になるまで待ってから、アセット URIで参照してください。このコードはDoubao固有のプライバシー上の拒否を示しますが、今回の確認では再現されませんでした。
短い参照動画でも、計算式の予測より料金が高くなるのはなぜですか?
入力に動画が含まれる場合、ベンダーの課金ルールによってトークン数に最低値が適用されることがあります。この計算式はあくまで推定値です。実際の消費量と請求額は、アカウントの課金記録を確認してください。
生成に失敗した場合やモデレーションで拒否された場合も料金は発生しますか?
BytePlusとVolcengineの公式課金ルールでは、生成が成功した場合に課金され、生成の失敗やコンテンツモデレーションによる拒否には課金されないとされています。AIHubMixのエラーに関するドキュメントでは、過去の請求額について課金記録を確認するよう案内しています。ここでは、生成の成功・失敗いずれについても請求額を測定していません。
Flashの生成結果は、いつまでにダウンロードする必要がありますか?
完了後すぐにダウンロードしてください。既存のSeedance 2.5ガイドでは、URLの有効期間は約30分とされていますが、Flashの正確な保持期間は確認されていません。また、有効期限フィールドがnullでも、結果が永続的に保持されることを意味するわけではありません。
AIHubMix経由でMOV出力や編集・延長はサポートされていますか?
現在のFlashスキーマでは、対応するフィールドがextraの下に公開されており、ベンダーもこれらの機能をドキュメントで案内しています。ただし、作成テストがクォータ不足の応答で終了したため、AIHubMix経由でのエンドツーエンドの動作は確認できていません。
続けて読む:Seedance 2.5 Flashシリーズ
- モデルを選ぶ前に価格の比較と解像度による違いを確認しますか? Seedance 2.5 Flashと2.5、2.0の比較:アップグレードする価値はある?
出典
ドキュメントとスキーマは2026年11月16日に確認し、検証時の応答は08:26 UTCに記録しました。価格はBytePlusの公式推定値であり、ゲートウェイ経由の実測料金ではありません。
- 動画生成API(AIHubMix Docs)
- 非同期タスクAPI(AIHubMix Docs)
- Doubao実在人物アセットガイド(AIHubMix Docs)
- ModelArkの料金(BytePlus)
- Seedance 2.5チュートリアル(Volcengine Ark)



