Seedanceタスクのステータスと結果

Seedance ビデオの作成は非同期です。作成リクエストはタスク ID を返します。タスクが完了するか失敗するまで Modelflare をポーリングします。

対応機種

タスクの作成

完全なリクエスト本文には、一致するモデル ページを使用します。

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "content": [{"type": "text", "text": "A cat walks through a sunlit room"}],
    "resolution": "720p",
    "duration": 5,
    "ratio": "16:9"
  }'

応答から id を保存します。互換性応答には task_id が使用される場合があります。

タスクをポーリングする

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

世間の反応はビデオプロバイダー全体で正規化されています。

JSON

{
  "id": "TASK_ID",
  "object": "video",
  "model": "seedance-2.5",
  "status": "in_progress",
  "progress": 42,
  "created_at": 1786084139,
  "seconds": "5",
  "metadata": {
    "action": "omniGenerate",
    "resolution": "1080p",
    "ratio": "9:16",
    "output_format": "mp4",
    "generate_audio": true,
    "usage": {"completion_tokens": 120, "total_tokens": 140}
  }
}

statusがqueuedまたはin_progressの間ポーリングします。 completedまたはfailedで停止します。

ステータス	意味	次のステップ
queued	実行待機中	再度投票してください
in_progress	処理中	再度投票してください
completed	ビデオが完成しました	コンテンツをダウンロードする
failed	タスクが失敗しました	エラーを読み取り、リクエストを修正します

サービス応答にそれらが含まれる場合、metadata には正規化されたアクション、解像度、比率、出力形式、オーディオ フラグ、およびトークンの使用法が含まれる場合があります。これらのフィールドはオプションとして扱います。 status とコンテンツ エンドポイントを安定したコントラクトとして使用します。

結果をダウンロードする

bash

curl --fail --location \
  https://modelflare.dev/v1/videos/TASK_ID/content \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --output seedance-result.mp4

コンテンツ エンドポイントはビデオ ストリームを返します。結果 URL は有効期限が切れる可能性があるため、すぐに保存してください。

失敗したタスク

作成では、プロバイダーの検証が完了する前にタスク ID を返すことができます。したがって、後のポーリングではタスクが failed に変更される可能性があります。エラーを調査するときは、リクエスト ID を保管してください。リクエスト エンベロープを別のモデル ファミリにサイレントに変更して再試行しないでください。