Upscale a Runway video

POST

runwayml

video_upscale

cURL

curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/video_upscale \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "magnific_video_upscaler_creative",
  "videoUri": "https://example.com/source-video.mp4",
  "resolution": "2k"
}'

import os
import requests

response = requests.post(
    "https://api.cometapi.com/runwayml/v1/video_upscale",
    headers={"Authorization": f"Bearer {os.environ['COMETAPI_KEY']}"},
    json={
      "model": "magnific_video_upscaler_creative",
      "videoUri": "https://example.com/source-video.mp4",
      "resolution": "2k"
    },
)
response.raise_for_status()
print(response.json())

const response = await fetch(
  "https://api.cometapi.com/runwayml/v1/video_upscale",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      "model": "magnific_video_upscaler_creative",
      "videoUri": "https://example.com/source-video.mp4",
      "resolution": "2k"
    }),
  },
);
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cometapi.com/runwayml/v1/video_upscale",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'magnific_video_upscaler_creative',
    'videoUri' => 'https://example.com/source-video.mp4'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cometapi.com/runwayml/v1/video_upscale"

	payload := strings.NewReader("{\n  \"model\": \"magnific_video_upscaler_creative\",\n  \"videoUri\": \"https://example.com/source-video.mp4\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.cometapi.com/runwayml/v1/video_upscale")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"magnific_video_upscaler_creative\",\n  \"videoUri\": \"https://example.com/source-video.mp4\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/runwayml/v1/video_upscale")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"magnific_video_upscaler_creative\",\n  \"videoUri\": \"https://example.com/source-video.mp4\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "00000000-0000-4000-8000-000000000000"
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Use magnific_video_upscaler_creative to upscale a source video. The request returns a task id for retrieving the finished output.

Prepare the request

Authenticate with your CometAPI API key.
Set model to magnific_video_upscaler_creative and provide videoUri for a video of up to 30 seconds.
Replace the example video URL with an accessible HTTPS URL. videoUri also accepts a Base64 video data URI with an encoded size of up to 5 MB.
Choose resolution: 720p, 1k, 2k, or 4k. Omit the field for 2k.

Adjust the enhancement

Field	How to use it
`creativity`	Amount of generated detail to add, from `1` through `100`.
`sharpen`	Sharpness intensity, from `1` through `100`.
`smartGrain`	Grain and texture enhancement intensity, from `1` through `100`.
`flavor`	`vivid` emphasizes color and detail; `natural` favors faithful reproduction.
`fpsBoost`	Set `true` to request an increased output frame rate.

Omit a numeric control to use the model default. A value of 0 is treated as omission, so it does not explicitly select zero intensity. Likewise, fpsBoost: false is treated as omission and does not explicitly disable frame-rate enhancement. Omit optional fields instead of sending null.

Retrieve the result

Save the returned id and use Get a Runway task to retrieve the task status. When status is SUCCEEDED, read the result URLs from output. If the task fails, inspect failure and failureCode when present.

Authorizations

Authorization

string

header

required

Your CometAPI API key.

Body

application/json

Magnific video-upscaling request.

model

enum<string>

required

Model ID for this request.

Available options:

magnific_video_upscaler_creative

videoUri

required

Video to upscale, with a maximum duration of 30 seconds. Use an accessible HTTPS URL or a Base64 data URI with an encoded size of up to 5 MB.

Required string length: 13 - 2048

Pattern: ^https://

resolution

enum<string>

Target output resolution. Omit for 2k.

Available options:

720p,

1k,

2k,

4k

creativity

integer

Amount of generated detail to add. Use 1 through 100 for an explicit setting. Omit to use the model default; 0 is treated as omission.

Required range: 0 <= x <= 100

sharpen

integer

Sharpness intensity. Use 1 through 100 for an explicit setting. Omit to use the model default; 0 is treated as omission.

Required range: 0 <= x <= 100

smartGrain

integer

Grain and texture enhancement intensity. Use 1 through 100 for an explicit setting. Omit to use the model default; 0 is treated as omission.

Required range: 0 <= x <= 100

flavor

enum<string>

Processing style: vivid emphasizes color and detail; natural favors faithful reproduction.

Available options:

vivid,

natural

fpsBoost

boolean

Set true to request an increased output frame rate. Omit to leave this option unspecified; false is treated as omission.

Response

The task was created. Save its id for task retrieval.

string

required

Task ID for GET /runwayml/v1/tasks/{id}.

status

string

Task state, when returned.

createdAt

string<date-time>

Task submission timestamp, when returned.

output

string<uri>[]

Result URLs, when returned.

failure

string

Failure explanation, when returned.

failureCode

string

Machine-readable failure code, when returned.

estimatedCost

object

Task estimate metadata, when returned.

Show child attributes

cost

object

Task cost metadata, when returned.

Show child attributes

Last modified on September 21, 2026

cURL

curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/video_upscale \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "magnific_video_upscaler_creative",
  "videoUri": "https://example.com/source-video.mp4",
  "resolution": "2k"
}'

import os
import requests

response = requests.post(
    "https://api.cometapi.com/runwayml/v1/video_upscale",
    headers={"Authorization": f"Bearer {os.environ['COMETAPI_KEY']}"},
    json={
      "model": "magnific_video_upscaler_creative",
      "videoUri": "https://example.com/source-video.mp4",
      "resolution": "2k"
    },
)
response.raise_for_status()
print(response.json())

const response = await fetch(
  "https://api.cometapi.com/runwayml/v1/video_upscale",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      "model": "magnific_video_upscaler_creative",
      "videoUri": "https://example.com/source-video.mp4",
      "resolution": "2k"
    }),
  },
);
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cometapi.com/runwayml/v1/video_upscale",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'magnific_video_upscaler_creative',
    'videoUri' => 'https://example.com/source-video.mp4'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cometapi.com/runwayml/v1/video_upscale"

	payload := strings.NewReader("{\n  \"model\": \"magnific_video_upscaler_creative\",\n  \"videoUri\": \"https://example.com/source-video.mp4\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.cometapi.com/runwayml/v1/video_upscale")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"magnific_video_upscaler_creative\",\n  \"videoUri\": \"https://example.com/source-video.mp4\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/runwayml/v1/video_upscale")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"magnific_video_upscaler_creative\",\n  \"videoUri\": \"https://example.com/source-video.mp4\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "00000000-0000-4000-8000-000000000000"
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Content moderation

API keys

Prepare the request

Adjust the enhancement

Retrieve the result

Authorizations

Body

Response

​Prepare the request

​Adjust the enhancement

​Retrieve the result

Authorizations

Body

Response

Prepare the request

Adjust the enhancement

Retrieve the result