動画生成待ちでクライアントがタイムアウトする: Seedance タスクの適切なタイムアウト設計
クライアントタイムアウトは、Seedance タスクが完了する前に HTTP クライアントが接続を閉じることで発生します。対策は動画生成を非同期として扱うことです。POST /v1/video/generations で送信し、status が succeeded または failed になるまで GET /v1/video/generations/{task_id} をポーリングするか、metadata.callback_url を設定して Webhook で結果を受け取ります。クリップは最長 15 秒、課金は生成された動画ごとなので、1 本の同期リクエストを長時間開いたままにしないでください。
Seedance でクライアントタイムアウトが起きる理由
タイムアウトは API の障害ではなく、1 本の動画リクエストがクライアントの既定ソケットタイムアウトより長くかかるために起こります。RelayDance ではタスクを送信した後、status が succeeded または failed になるまで GET /v1/video/generations/{task_id} をポーリングし、結果に含まれる動画 URL を取得します。リクエストには最長 15 秒のクリップに加え、参照画像 9 点・参照動画 3 点・音声トラック 3 点まで含められ、これらはすべて処理時間を延ばします。処理の間ずっと接続を開いたままにすることがクライアント側タイムアウトの原因であり、送信と結果取得を分離するのが推奨パターンです。
推奨パターン: ポーリングと Webhook
クライアントタイムアウトを避けるパターンは 2 つ、間隔ポーリングと Webhook コールバックです。ポーリングの場合はタスクを送信して task_id を控え、ポーリングごとに短いクライアントタイムアウトで GET /v1/video/generations/{task_id} を status が確定するまで繰り返し呼びます。Webhook の場合は metadata.callback_url を設定すると最終状態がお使いのサーバーに POST されるため、長時間の接続保持は不要です。
- 送信: model、prompt、seconds を添えて
POST /v1/video/generations。 - ポーリング:
GET /v1/video/generations/{task_id}を succeeded / failed まで。 - または Webhook:
metadata.callback_urlを設定し、最終状態を POST で受信。
設定: OpenAI 互換の base URL と認証
既存の OpenAI クライアントは base URL を変えるだけで使えます。公式ドキュメント(relaydance.com/docs)のとおり、「base_url を https://relaydance.com/v1 に設定すれば、お使いの OpenAI SDK はそのまま使えます」。認証はコンソールで作成したキーを使い、ヘッダー Authorization: Bearer YOUR_API_KEY を指定します。プロトコルが OpenAI 互換なので、クライアントのリクエスト単位のタイムアウトやリトライ設定はそのまま引き継がれます。詳細は relaydance.com/docs をご覧ください。
リトライと失敗リクエストの課金への影響
失敗・エラーのリクエストは課金されないため、クライアントタイムアウト後の再試行に課金ペナルティはありません。課金は生成された動画ごとの従量制です。モデル別の最新料金は relaydance.com/models に掲載されています。
| モデル / ティア | 料金 |
|---|---|
| Seedance 2.0 720p | 約 $0.190 / 秒 |
| Seedance 2.0 1080p | 約 $0.470 / 秒 |
| Seedance Fast | 約 $0.152 / 秒 |
| Seedance ネイティブ 4K | 5 秒クリップあたり約 $4.90 |
FAQ
クライアントタイムアウトは課金されますか? いいえ。失敗・エラーのリクエストは課金されず、課金は生成された動画ごとです。
ポーリングと Webhook のどちらを使うべきですか? どちらでも構いません。GET /v1/video/generations/{task_id} を確定までポーリングするか、metadata.callback_url で最終状態を受け取ってください。
クリップは何秒まで生成できますか? 1 リクエストあたり最長 15 秒、参照画像 9 点・参照動画 3 点・音声トラック 3 点まで指定できます。
主要データ一覧
| 項目 | 値 | 出典 |
|---|---|---|
| Seedance 2.0 720p 料金 | 約 $0.190 / 秒 | relaydance.com/models |
| Seedance 2.0 1080p 料金 | 約 $0.470 / 秒 | relaydance.com/models |
| Seedance Fast 料金 | 約 $0.152 / 秒 | relaydance.com/models |
| Seedance ネイティブ 4K 料金 | 5 秒クリップあたり約 $4.90 | relaydance.com/models |
| API プロトコル | OpenAI 互換。base_url を https://relaydance.com/v1 に設定 | relaydance.com/docs |
| 失敗リクエスト | 失敗・エラーのリクエストは課金されない | relaydance.com/docs |
データ確認日: 2026-06-29。最新料金は公式 /models ページをご覧ください。
RelayDance ホーム · モデルと料金 · ドキュメント · すべてのガイド · プライバシーポリシー · 利用規約 · Telegram コミュニティ · RelayRouter (LLM API) · ライブプレイグラウンド