> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upscale a Runway video

> Start a 4x video upscaling task with Runway via CometAPI using POST /runwayml/v1/video_upscale, capped at 4096px per side with versioning.

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

<Steps>
  <Step title="Submit the source video">
    Create the upscale task with your source clip URL.
  </Step>

  <Step title="Store the task id">
    Save the returned `id` for later status checks.
  </Step>

  <Step title="Poll for completion">
    Use [Get a Runway task](./runway-to-get-task-details) until the task finishes and the provider metadata exposes the final output.
  </Step>
</Steps>

## When to use it

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


## OpenAPI

````yaml api/openapi/video/runway/official-format/post-upscale-a-video.openapi.json POST /runwayml/v1/video_upscale
openapi: 3.1.0
info:
  title: Upscale a Video API
  version: 1.0.0
  description: >-
    Create a Runway video-upscale task through the official-format CometAPI
    route.
servers:
  - url: https://api.cometapi.com
security:
  - bearerAuth: []
paths:
  /runwayml/v1/video_upscale:
    post:
      summary: Create a Runway video-upscale task
      description: Submit a source video URL and receive a task id for later polling.
      operationId: upscale_a_video
      parameters:
        - name: X-Runway-Version
          in: header
          required: true
          description: Runway version header, for example `2024-11-06`.
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - videoUri
                - model
              properties:
                videoUri:
                  type: string
                  description: >-
                    A HTTPS URL pointing to a video or a data URI containing a
                    video.
                  default: https://your-video-host/source.mp4
                model:
                  type: string
                  description: The model variant to use. Must be upscale_v1.
                  default: upscale_v1
              default:
                videoUri: https://your-video-host/source.mp4
                model: upscale_v1
            examples:
              Default:
                summary: Default
                value:
                  videoUri: https://your-video-host/source.mp4
                  model: upscale_v1
      responses:
        '200':
          description: Task accepted.
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                properties:
                  id:
                    type: string
      x-codeSamples:
        - lang: Shell
          label: Default
          source: |
            curl https://api.cometapi.com/runwayml/v1/video_upscale \
              -H "Authorization: Bearer $COMETAPI_KEY" \
              -H "Content-Type: application/json" \
              -d '{
                  "videoUri": "https://your-video-host/source.mp4",
                  "model": "upscale_v1"
                }'
        - lang: Python
          label: Default
          source: >
            import os

            import requests


            response = requests.post(
                "https://api.cometapi.com/runwayml/v1/video_upscale",
                headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
                json={
                        "videoUri": "https://your-video-host/source.mp4",
                        "model": "upscale_v1"
                },
            )


            task = response.json()

            print(task["id"])  # poll GET /runwayml/v1/tasks/{id} until the
            output array appears
        - lang: JavaScript
          label: Default
          source: >
            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({
                        "videoUri": "https://your-video-host/source.mp4",
                        "model": "upscale_v1"
                    }),
            });


            const task = await response.json();

            console.log(task.id); // poll GET /runwayml/v1/tasks/{id} until the
            output array appears
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Bearer token authentication. Use your CometAPI key.

````