메인 콘텐츠로 건너뛰기
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