Skip to main content
GET
이 엔드포인트를 사용해 id로 Runway 작업을 확인합니다.

먼저 이 필드를 확인하세요

  • 작업 식별자용 id
  • 현재 작업 상태용 status
  • 작업이 성공했을 때 완료된 에셋 URL용 output
  • 작업이 실패했을 때의 failurefailureCode

사용 시점

  • text-to-image, image-to-video, video-to-video 같은 공식 형식 Runway 작업 생성 페이지를 호출한 후

재시도 동작

  • 방금 생성된 작업은 잠시 동안 task_not_exist를 반환할 수 있습니다
  • 작업 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.

마지막 수정일 2026년 7월 2일