メインコンテンツへスキップ
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>'
{
  "id": "d0658ae1-bbdd-4adc-aaba-fd8070e14d79",
  "status": "SUCCEEDED",
  "createdAt": "2026-05-01T12:47:47.351Z",
  "output": [
    "https://example.com/output.mp4"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

このエンドポイントは、id によって Runway タスクを確認するために使用します。

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

  • タスク識別子には id
  • 現在のタスク状態には status
  • タスク成功時の完了済みアセット URL には output
  • タスク失敗時には failure と failureCode

​
使用するタイミング

  • text-to-image、image-to-video、video-to-video、upscale など、official-format の Runway タスク作成ページを呼び出した後
  • compatibility-format の feed ルートではなく、この形式が必要な場合

​
リトライ動作

  • 作成されたばかりのタスクでは、一時的に task_not_exist が返ることがあります
  • task id を無効と判断する前に、数秒待ってから再試行してください
  • タスクが確認可能になると、このルートと compatibility-format の feed ルートは、同じ queued または in-progress のレスポンスを返すことがあります

承認

​
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.