公式形式
Runway タスクを取得する
CometAPI を使用して GET /runwayml/v1/tasks/ を呼び出し、task ID によって Runway の動画生成タスクのステータス、進行状況、出力、メタデータを取得します。
GET
このエンドポイントを使用して、id によって Runway タスクを確認します。
まずこれらのフィールドを確認してください
- タスク識別子は
id - 現在のタスク状態は
status - タスクが成功したときの完成済みアセット URL は
output - タスクが失敗したときは
failureとfailureCode
使用するタイミング
- text-to-image、image-to-video、video-to-video など、official-format の Runway タスク作成ページを呼び出した後
リトライの動作
- 作成されたばかりのタスクでは、一時的に
task_not_existが返ることがあります - task id を無効と判断する前に、数秒待ってから再試行してください
- タスクが確認できるようになったら、終端状態または完了した出力が返るまで、このエンドポイントのポーリングを続けてください。
承認
Bearer token authentication. Use your CometAPI key.
ヘッダー
Optional Runway version header, for example 2024-11-06.
パスパラメータ
Runway task id returned by the create endpoint.
レスポンス
200 - application/json
Current task state.
Task ID.
Task status.
利用可能なオプション:
PENDING, RUNNING, SUCCEEDED, FAILED Task creation timestamp.
Output URLs returned after the task succeeds.
Failure reason returned after the task fails.
Failure code returned after the task fails.
Task progress.