Skip to main content
GET
Use este endpoint para inspecionar uma tarefa do Runway por id.

​
Verifique estes campos primeiro

  • id para o identificador da tarefa
  • status para o estado atual da tarefa
  • output para as URLs dos assets concluídos quando a tarefa for bem-sucedida
  • failure e failureCode quando a tarefa falhar

​
Quando usar

  • Após chamar uma página de criação de tarefa do Runway em formato oficial, como text-to-image, image-to-video ou video-to-video

​
Comportamento de nova tentativa

  • Uma tarefa recém-criada pode retornar brevemente task_not_exist
  • Aguarde alguns segundos e tente novamente antes de tratar o id da tarefa como inválido
  • Quando a tarefa estiver visível, continue fazendo polling deste endpoint até que ele retorne um estado terminal ou a saída concluída.

Autorizações

​
Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Cabeçalhos

​
X-Runway-Version
string

Optional Runway version header, for example 2024-11-06.

Parâmetros de caminho

​
id
string
obrigatório

Runway task id returned by the create endpoint.

Resposta

200 - application/json

Current task state.

​
id
string
obrigatório

Task ID.

​
status
enum<string>
obrigatório

Task status.

Opções disponíveis:
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.

Última modificação em 2 de julho de 2026