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.