Ana içeriğe atla
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"
    }
  }
}
Bu endpoint’i, resmi format sarmalayıcısı üzerinden kimliğe göre bir Runway görevini incelemek için kullanın.

​
Önce şu alanları kontrol edin

  • Sarmalayıcı düzeyindeki durum için dış code ve message
  • Geçerli görev durumu için data.status ve data.progress
  • Sağlayıcıya özgü görev meta verileri için iç içe data.data

​
Ne zaman kullanılır

  • text-to-image, image-to-video, video-to-video veya upscale gibi resmi formatlı bir Runway görev oluşturma sayfasını çağırdıktan sonra
  • reverse-format feed rotası yerine birleşik sarmalayıcı yanıtına ihtiyaç duyduğunuzda

​
Yeniden deneme davranışı

  • Yeni oluşturulmuş bir görev kısa bir süreliğine task_not_exist döndürebilir
  • Görev kimliğini geçersiz saymadan önce birkaç saniye bekleyin ve yeniden deneyin
  • Görev görünür olduktan sonra, bu rota ve ters feed sarmalayıcısı aynı kuyruğa alınmış veya işlemde olan zarfı döndürebilir
2026-03-13 tarihinde yapılan canlı doğrulamada, düz bir Runway görev nesnesi yerine code: success, status: QUEUED ve iç içe bir data nesnesi içeren sarmalanmış bir yanıt döndü.

Yetkilendirmeler

​
Authorization
string
header
gerekli

Bearer token authentication. Use your CometAPI key.

Başlıklar

​
X-Runway-Version
string

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

Yol Parametreleri

​
id
string
gerekli

Runway task id returned by the create endpoint.

Yanıt

200 - application/json

Current wrapper task state or not-yet-visible error.

​
code
string | null
gerekli
​
message
string
gerekli
​
data
object