Skip to main content
POST
cURL
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

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.

id
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.

cost
object

Task cost metadata, when returned.

Last modified on September 18, 2026