Skip to main content
POST
/
runwayml
/
v1
/
video_upscale
Create a Runway video-upscale task
curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/video_upscale \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "videoUri": "https://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.mp4",
  "model": "upscale_v1"
}
'
{
  "id": "<string>"
}
Use this endpoint to start a Runway upscaling task for an existing video asset.

​
Before you call it

  • Send the required X-Runway-Version header, for example 2024-11-06
  • Use model: upscale_v1
  • Provide a stable HTTPS videoUri
  • Expect a 4x upscale with a maximum edge size of 4096 pixels

​
Task flow

1

Submit the source video

Create the upscale task with your source clip URL.
2

Store the task id

Save the returned id for later status checks.
3

Poll for completion

Use Get Task Details until the task finishes and the provider metadata exposes the final output.

​
When to use it

  • After your final edit render is approved
  • When you need a higher-resolution delivery asset instead of a faster preview

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Headers

​
X-Runway-Version
string
required

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

Body

application/json
​
videoUri
string
default:https://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.mp4
required

A HTTPS URL pointing to a video or a data URI containing a video.

​
model
string
default:upscale_v1
required

The model variant to use. Must be upscale_v1.

Response

200 - application/json

Task accepted.

​
id
string
required