Skip to main content

パスパラメータ

string
必須
動画作成リクエストから返されるタスクID。idtask_id は同じ非同期識別子として扱ってください。
作成レスポンスが poll_url を返す場合は、その正確な URL を呼び出してください。これが /v1/tasks/{id} を指す場合は、それを正準の固定ステータスエンドポイントとして扱ってください。タスクが存在しない、または公開された非同期タスク契約を通じて解決できない場合、TokenLab は async_task_not_found を返し、メッセージ Task not found or no longer available. を返します。

レスポンス

string
正準の非同期タスク識別子。
string
非同期タスク識別子の別名。
string
作成レスポンスが提供する場合の推奨ポーリングURL。
string
決済がすでに完了している場合に返される TokenLab の請求トランザクション ID です。dashboard / 照合で使う取引識別子であり、非同期 id / task_id とは別物です。
string
タスクのステータス: pending, processing, completed, failed
number
任意の進捗値です。実際の進捗値が利用できる場合のみ返されます。完了判定には status を使用してください。
string
生成されたビデオの URL(完了時)。
object
利用可能な場合に urldurationwidthheight を含む単一ビデオペイロード。
array
生成タスクが複数の出力を返す場合の複数ビデオペイロード。
string
エラーメッセージ(失敗時)。
integer
作成タイムスタンプ。
integer
最終更新タイムスタンプ。
string
タスクに使用されたモデル。

ポーリングのベストプラクティス

  • 5〜10秒ごとにポーリングする
  • 長時間のタスクには指数バックオフを実装する
  • 最大タイムアウトを設定する(例: 10分)
  • failed ステータスを適切に処理する