メインコンテンツへスキップ
GET
/
runwayml
/
v1
/
tasks
/
{id}
Poll a Runway official-format task
curl --request GET \
  --url https://api.cometapi.com/runwayml/v1/tasks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "3d957031-9a2a-45e2-9dc7-bc8513059c50",
    "action": "IMAGE_TO_VIDEO",
    "status": "QUEUED",
    "fail_reason": "",
    "submit_time": 1773366766,
    "start_time": 0,
    "finish_time": 0,
    "progress": "0%",
    "data": {
      "id": "3d957031-9a2a-45e2-9dc7-bc8513059c50",
      "status": "PENDING",
      "createdAt": "2026-03-13T09:52:46+08:00"
    }
  }
}
このエンドポイントは、公式フォーマットのラッパーを通じて id で Runway タスクを確認するために使用します。

​
まず確認すべきフィールド

  • ラッパーレベルのステータスは外側の code と message
  • 現在のタスク状態は data.status と data.progress
  • プロバイダー固有のタスクメタデータはネストされた data.data

​
使用するタイミング

  • text-to-image、image-to-video、video-to-video、upscale など、公式フォーマットの Runway タスク作成ページを呼び出した後
  • reverse-format の feed ルートではなく、統一されたラッパーレスポンスが必要な場合

​
リトライ動作

  • 作成直後のタスクは一時的に task_not_exist を返すことがあります
  • タスク id を無効と判断する前に、数秒待ってから再試行してください
  • タスクが参照可能になると、このルートと reverse の feed ラッパーは、同じ queued または in-progress のエンベロープを返すことがあります
2026-03-13 のライブ検証では、code: success、status: QUEUED、および素の Runway タスクオブジェクトではなくネストされた data オブジェクトを含むラップ済みレスポンスが返されました。

承認

​
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 wrapper task state or not-yet-visible error.

​
code
string | null
必須
​
message
string
必須
​
data
object