Skip to main content
GET
中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。
  • Query async video generation task execution status and results
  • Real-time status updates and progress tracking
  • Get generated videos when task completes
  • Multi-language support (zh/en/ko/ja)
All video generation tasks are executed asynchronously. After submitting a task, you need to query the status and results via the query endpoint.
素材審査が必要な Seedance の動画タスクもこの API で照会します. queued には素材の準備や審査待ちも含まれ, タスクの受理は動画生成開始を意味しません. 準備期限は既定で 1 ラウンド 20 分で, その後の動画生成時間は含みません. 失敗時は error.message を確認します.
通常の画像と動画のタスクは GET /v1/tasks/{task_id} でも照会でき, usage と billing の定義は共通です. このページは冒頭に記載した生成タスク照会パスのレスポンスを説明します. サンプルはフィールドを示すもので, モデルの現在の価格や固定の課金方式を示すものではありません. 実際のタスクで返されたフィールドと金額を確認してください.

Seedance の元の URL と代替 URL

元の URL の配信が有効な Seedance タスクでは, result.data[].url は上流の元の動画 URL を保持します. url を優先し, アクセスできない場合にのみ同じ結果項目の fallback_url に切り替えてください. プラットフォームはクライアントの地域に応じて URL を自動で切り替えません. 代替フィールドは任意で, コピーが利用可能な場合のみ返されます. 元の URL の配信が無効, コピーが利用できない, または過去のタスクにコピーがない場合は省略されることがあります. 省略は生成失敗を意味しません. 最終フレームも last_frame_url を優先し, アクセスできない場合のみ fallback_last_frame_url を使用します. 代替 URL は元の URL の有効期限を延長しません. 長期保存が必要な場合は速やかにダウンロードしてください.

Authorizations

string
必須
All endpoints require Bearer Token authenticationGet your API Key:Visit the API Key Management Page to get your API KeyAdd it to the request header:

Path パラメータ

string
必須
Task ID returned by the video generation API

レスポンス

string
Unique task identifier
string
省略可能な顧客側の業務 ID. タスク作成時に client_business_id を指定した場合のみ返します.
string
Object type, always generation.task
string
Task status
  • queued - Queued for processing
  • in_progress - Processing
  • completed - Successfully completed
  • failed - Failed
integer
Task progress percentage (0-100)
string
Video generation model used
integer
省略可能なプラットフォームのタスク更新時刻, Unix タイムスタンプ. 現在は Seedance Global で返します. generation.updated_at は上流の更新時刻です.
integer
Task creation time (Unix timestamp)
integer
タスク終了時刻, Unix タイムスタンプ. この照会パスでは, 成功または失敗したタスクに保存済みの終了時刻がある場合に返します.
integer
Task completion time (Unix timestamp, only returned when completed)
integer
Video URL expiration time (Unix timestamp, only returned on completion)
object
Task result (only returned on success)
object
省略可能な Seedance の生成メタデータです. 保存済みで公開可能なフィールドのみ返し, デフォルト値は補完しません. 生成パラメータであり, トップレベルの usage にある課金数量の代わりにはなりません.generation.usage は既存の互換フィールドで, completion_tokens と total_tokens を含む場合があります. 欠落する場合や最終課金数量と異なる場合があります. トップレベルの usage に加算せず, 課金数量にはトップレベルの usage を使用してください.
object
省略可能な課金数量, 動画トークン内訳, ツール使用回数です. 単位と省略条件はタスクの使用量フィールドを参照してください.charge_type から input_images までは課金数量であり, billing.status=settled と同時にのみ返されます. 固定料金の動画は提出時に確認された数量を, 実際の長さやトークンで確定する動画は最終確定数量を返します. 返されないフィールドは省略され, ゼロで補完されません.
object
任意のプラットフォーム課金状態と確定済み請求額です. 課金状態は生成状態とは独立しており, completed でも確定済みとは限りません. オブジェクトがない場合も無料とは限りません. 料金と実際の請求額を参照してください.タスク Webhook の data.billing も同じ確認条件と値を使います.
object
エラー information (only returned on failure)エラーコードとメッセージは通常文字列です. Seedance Global は error.code と error.message に上流の元の JSON 値を保持し, 数値や null もそのまま返します. 上流にないフィールドをプラットフォームのデフォルト値で補完しません.

Task ステータス Reference

Polling Strategy

Python Polling Example

Resource Expiration

Generated video URLs are valid for 24 hours
  • Please download and save videos within the validity period
  • expires_at field indicates video expiration time (Unix timestamp)
  • Expired videos cannot be accessed; to regenerate, submit a new task
  • Thumbnails expire simultaneously with videos

エラーと失敗理由

リクエストエラー, タスク失敗の具体的な原因, 復旧方法はエラー早見表を参照してください. 照会成功後もタスク状態を確認し, HTTP ステータスと業務コードを区別してください.

Performance Tips

Video generation takes longer, recommendations:
  1. ToAPIs Task Webhook: Webhook を主経路、照会をフォールバックにします
  2. 照会間隔: 5~10秒以上と jitter。429 は Retry-After を読み exponential backoff
  3. Set Timeout: Long videos may take 5-10 minutes, set reasonable timeout
  4. Download Promptly: Videos expire after 24 hours, save to your storage immediately
非同期タスクのレート制限を参照してください。バッチ照会は最大100件です。