Skip to main content
GET
このエンドポイントを使用して、id によって Runway タスクを確認します。

まずこれらのフィールドを確認してください

  • タスク識別子は id
  • 現在のタスク状態は status
  • タスクが成功したときの完成済みアセット URL は output
  • タスクが失敗したときは failurefailureCode

使用するタイミング

  • text-to-image、image-to-video、video-to-video など、official-format の Runway タスク作成ページを呼び出した後

リトライの動作

  • 作成されたばかりのタスクでは、一時的に task_not_exist が返ることがあります
  • task id を無効と判断する前に、数秒待ってから再試行してください
  • タスクが確認できるようになったら、終端状態または完了した出力が返るまで、このエンドポイントのポーリングを続けてください。

承認

Authorization
string
header
必須

Bearer token authentication. Use your CometAPI key.

ヘッダー

X-Runway-Version
string

Optional Runway version header, for example 2024-11-06.

パスパラメータ

id
string
必須

Runway task id returned by the create endpoint.

レスポンス

200 - application/json

Current task state.

id
string
必須

Task ID.

status
enum<string>
必須

Task status.

利用可能なオプション:
PENDING,
RUNNING,
SUCCEEDED,
FAILED
createdAt
string

Task creation timestamp.

output
string[]

Output URLs returned after the task succeeds.

failure
string

Failure reason returned after the task fails.

failureCode
string

Failure code returned after the task fails.

progress
number

Task progress.