create_upload

Get a signed URL to upload a local video file (up to 100MB) when it has no public URL. PUT the file bytes to upload_url with the returned headers (no Authorization header), then pass video_url to upscale_video. The URL expires in 1 hour.

Argument	Type	Description
size*	integer	File size in bytes
content_type*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "content_type",
    "size"
  ],
  "properties": {
    "size": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "File size in bytes",
      "exclusiveMinimum": 0
    },
    "content_type": {
      "enum": [
        "video/mp4",
        "video/quicktime",
        "video/webm"
      ],
      "type": "string"
    }
  }
}

get_account

Your credit balance and the price per second of video for each resolution.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

get_task

Get an upscale task. Status is queued, processing, completed (output_url is the result) or failed (credits were refunded). Set wait_seconds (up to 45) to wait for it to finish before returning; call again if it is still running.

read-only

Argument	Type	Description
task_id*	string
wait_seconds	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "task_id"
  ],
  "properties": {
    "task_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    },
    "wait_seconds": {
      "type": "integer",
      "maximum": 45,
      "minimum": 0
    }
  }
}

list_tasks

List your upscale tasks, newest first, including ones started on the website.

read-only

Argument	Type	Description
limit	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1
    }
  }
}

upscale_video

Start upscaling a video to 1080p, 2k or 4k. Charges credits for the whole video (its length is read from the file) and returns the task. Downloading a large video can take a few minutes. If this call times out or fails, first call list_tasks to see whether the task was created, and retry only with the SAME idempotency_key: a new key charges again.

Argument	Type	Description
video_url*	string	Public http(s) URL of the video (MP4, MOV or WebM, up to 500MB; up to 1200 seconds at 1080p, 600 seconds at 2k and 4k), or the video_url returned by create_upload
resolution*	string	Target resolution
idempotency_key*	string	A unique string for this request, e.g. a UUID (printable ASCII, no spaces). Reuse it when retrying the same request.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "video_url",
    "resolution",
    "idempotency_key"
  ],
  "properties": {
    "video_url": {
      "type": "string",
      "description": "Public http(s) URL of the video (MP4, MOV or WebM, up to 500MB; up to 1200 seconds at 1080p, 600 seconds at 2k and 4k), or the video_url returned by create_upload"
    },
    "resolution": {
      "enum": [
        "1080p",
        "2k",
        "4k"
      ],
      "type": "string",
      "description": "Target resolution"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[\\x21-\\x7e]{1,255}$",
      "description": "A unique string for this request, e.g. a UUID (printable ASCII, no spaces). Reuse it when retrying the same request."
    }
  }
}

VideoUpscaler

Try it

create_upload

Tools

VideoUpscaler

Try it

create_upload

Tools