パスパラメータ
string
必須
動画作成リクエストから返されるタスクID。
id と task_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
利用可能な場合に
url、duration、width、height を含む単一ビデオペイロード。array
生成タスクが複数の出力を返す場合の複数ビデオペイロード。
string
エラーメッセージ(失敗時)。
integer
作成タイムスタンプ。
integer
最終更新タイムスタンプ。
string
タスクに使用されたモデル。
ポーリングのベストプラクティス
- 5〜10秒ごとにポーリングする
- 長時間のタスクには指数バックオフを実装する
- 最大タイムアウトを設定する(例: 10分)
failedステータスを適切に処理する