Query: Single Task

Runway task query API for retrieving the status and output of a specific task.

---

Overview

• Method: GET
• Path: /runwayml/v1/tasks/{task_id}
• Content-Type: application/json
• Category: Video Models (Video) / Runway official API

Authentication

• Header: Authorization: Bearer <token>
• Additional header: X-Runway-Version: 2024-11-06

---

Path Parameters

Parameter	Type	Required	Description
task_id	string	Yes	Task ID to query

---

Request Example

curl Example

curl -X GET "https://api.gpt.ge/runwayml/v1/tasks/your_task_id" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_TOKEN" \
  -H "X-Runway-Version: 2024-11-06"

JavaScript (fetch) Example

fetch('https://api.gpt.ge/runwayml/v1/tasks/your_task_id', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_TOKEN',
    'X-Runway-Version': '2024-11-06'
  }
})
  .then(res => res.json())
  .then(console.log)

Python Example (requests)

import requests

resp = requests.get(
    'https://api.gpt.ge/runwayml/v1/tasks/your_task_id',
    headers={
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN',
        'X-Runway-Version': '2024-11-06'
    }
)
print(resp.json())

---

Response Fields

Field	Type	Description
id	string	Task ID
status	string	Task status, possible values: PENDING, THROTTLED, RUNNING, SUCCEEDED, FAILED, CANCELLED
createdAt	string	Task creation time
output	array[string]	Task output array, may contain video URLs
progress	number	Task progress as a float, may be null

---

Response Example (200)

{
  "id": "2272f1f2-dbb8-4083-a126-d9a8f0524bb2",
  "status": "SUCCEEDED",
  "createdAt": "2024-11-30T07:06:07.912Z",
  "output": [
    "https://dnznrvs05pmza.cloudfront.net/ad0e7fa4-9ab6-4dd6-9269-b401fc71c385.mp4?_jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXlIYXNoIjoiMzgzYTZlZjczYjg5OGUyNCIsImJ1Y2tldCI6InJ1bndheS10YXNrLWFydGlmYWN0cyIsInN0YWdlIjoicHJvZCIsImV4cCI6MTczMzA5NzYwMH0.Wu7X9F6wyR4TrTUIuShCdeo2o8YNe6MSGtzvP4qEDs0"
  ]
}