Skip to main content
Glama

upscale video

upscale_video
Destructive

Upscale an existing video using a catalog model that supports upscale_video. Use get_model_catalog to choose a supported model and its settings. Returns a tracked task and playable result when complete.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "sourceMediaId": "<sourceMediaId>",
      "model": "<model>"
    },
    "name": "upscale_video"
  }
}

Input Schema

NameRequiredDescriptionDefault
modelYesActive model ID supporting this operation. Use get_model_catalog.
promptNoEdit or enhancement instructions.
maxCostUsdNoMaximum charge for each output. Checked against authoritative pricing before generation.
resolutionNo
aspectRatioNo
endFrameUrlNo
mediaInputsNoNamed media slots from get_model_catalog, for example reference_image_uri or mask_url.
scaleFactorNoUpscaling multiplier when supported by the selected model.
sparkTaskIdNoOriginating Spark task for library history and recovery.
workspaceIdNo
modelVariantNoVariant value from get_model_catalog variantSelector.options, such as high for Flare quality. Uses the catalog default when omitted.
outputFormatNoOutput format when supported by the selected model.
generateAudioNoExplicitly enable or disable generated video audio, when supported.
modelSettingsNoModel-specific controls using keys and options from get_model_catalog inputConstraints.slots or variantSelector.
sourceMediaIdYesCompleted workspace source media. The original is preserved.
idempotencyKeyNoStable request key. Retries with the same key reuse the existing output and do not start another paid generation.
sourceImageUrlNoPublic HTTP(S) source image/start-frame URL. Use mediaId for workspace images.
sourceVideoUrlNoPublic HTTP(S) source-video URL.
endFrameMediaIdNoWorkspace image for the final frame, when supported by the selected model.
referenceImagesNoImages to guide generation. Use labels such as person or product and refer to them as @person or @product in the prompt. Each item accepts a workspace mediaId or a public HTTP(S) URL.
sourceImageMediaIdNoWorkspace image to use as the source image/start frame.
sourceVideoMediaIdNoWorkspace video to edit or transform, when supported by the selected model.

Output Schema

NameRequiredDescriptionDefault
dataNo
errorNo
successYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / data / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "aspectRatio": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "downloadUrl": {
      -        "anyOf": [
      -          {
      -            "format": "uri",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "durationMs": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "error": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "imageUrl": {
      -        "anyOf": [
      -          {
      -            "format": "uri",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "mediaId": {
      -        "type": "string"
      -      },
      -      "model": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "playableUrl": {
      -        "anyOf": [
      -          {
      -            "format": "uri",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "posterUrl": {
      -        "anyOf": [
      -          {
      -            "format": "uri",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "progress": {
      -        "anyOf": [
      -          {
      -            "maximum": 1,
      -            "minimum": 0,
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "progressLabel": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "prompt": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "status": {
      -        "enum": [
      -          "queued",
      -          "generating",
      -          "completed",
      -          "failed"
      -        ],
      -        "type": "string"
      -      },
      -      "type": {
      -        "enum": [
      -          "image",
      -          "video",
      -          "audio"
      -        ],
      -        "type": "string"
      -      },
      -      "viewUrl": {
      -        "format": "uri",
      -        "type": "string"
      -      },
      -      "workspaceId": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "workspaceId",
      -      "mediaId",
      -      "type",
      -      "status",
      -      "progress",
      -      "progressLabel",
      -      "playableUrl",
      -      "imageUrl",
      -      "posterUrl",
      -      "downloadUrl",
      -      "viewUrl",
      -      "durationMs",
      -      "model",
      -      "aspectRatio",
      -      "prompt",
      -      "error"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "activeIndex": {
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "items": {
      -        "items": {
      -          "$ref": "#/properties/data/anyOf/0"
      -        },
      -        "maxItems": 8,
      -        "minItems": 1,
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "items",
      -      "activeIndex"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "aspectRatio": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "downloadUrl": {
      +        "anyOf": [
      +          {
      +            "format": "uri",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "durationMs": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "elapsedSeconds": {
      +        "anyOf": [
      +          {
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "error": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "heartbeatAgeSeconds": {
      +        "anyOf": [
      +          {
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "height": {
      +        "anyOf": [
      +          {
      +            "exclusiveMinimum": 0,
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "imageUrl": {
      +        "anyOf": [
      +          {
      +            "format": "uri",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "lastHeartbeatAt": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "mediaId": {
      +        "type": "string"
      +      },
      +      "model": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "playableUrl": {
      +        "anyOf": [
      +          {
      +            "format": "uri",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "posterUrl": {
      +        "anyOf": [
      +          {
      +            "format": "uri",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "progress": {
      +        "anyOf": [
      +          {
      +            "maximum": 1,
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "progressLabel": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "prompt": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "requestedAspectRatio": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "status": {
      +        "enum": [
      +          "queued",
      +          "generating",
      +          "completed",
      +          "failed"
      +        ],
      +        "type": "string"
      +      },
      +      "type": {
      +        "enum": [
      +          "image",
      +          "video",
      +          "audio"
      +        ],
      +        "type": "string"
      +      },
      +      "viewUrl": {
      +        "format": "uri",
      +        "type": "string"
      +      },
      +      "width": {
      +        "anyOf": [
      +          {
      +            "exclusiveMinimum": 0,
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "workspaceId": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "workspaceId",
      +      "mediaId",
      +      "type",
      +      "status",
      +      "progress",
      +      "progressLabel",
      +      "playableUrl",
      +      "imageUrl",
      +      "posterUrl",
      +      "downloadUrl",
      +      "viewUrl",
      +      "durationMs",
      +      "model",
      +      "aspectRatio",
      +      "prompt",
      +      "error"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "activeIndex": {
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "items": {
      +        "items": {
      +          "$ref": "#/properties/data/anyOf/0"
      +        },
      +        "maxItems": 8,
      +        "minItems": 1,
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "items",
      +      "activeIndex"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed2 schema fields changed
    • changedInput schema / properties / modelSettings / description
      Previous value: -"Model-specific controls using keys and options from get_model_catalog inputConstraints.slots."New value: +"Model-specific controls using keys and options from get_model_catalog inputConstraints.slots or variantSelector."
    • addedInput schema / properties / modelVariant
      Added value: +{
      +  "description": "Variant value from get_model_catalog variantSelector.options, such as high for Flare quality. Uses the catalog default when omitted.",
      +  "minLength": 1,
      +  "type": "string"
      +}
  3. First observed

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare non-read-only, open-world, non-idempotent, and destructive, so the safety profile is carried by structured data. The description adds only that a tracked task and playable result are returned, which duplicates what the output schema likely covers. It omits the paid-generation nature (implied only by the maxCostUsd parameter), idempotency-key retry behavior, and the fact that the original is preserved.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three short sentences, front-loaded with the action and scope, with no filler. The catalog hint in sentence two is slightly redundant with the schema's own 'Use get_model_catalog' text, but the overall package is efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 22-parameter generative mutation tool with nested objects and an output schema, the description covers the essential decision path: pick a catalog model, submit, and receive a tracked task plus result. Cost, idempotency-key reuse, and source-input selection are left entirely to the schema, which is a real but modest gap given the schema's richness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 82%, so the schema already documents nearly every one of the 22 parameters, including the catalog pointers for model, modelVariant, and modelSettings. The description repeats the catalog instruction rather than explaining any parameter beyond the schema, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource ('Upscale an existing video') plus the constraint that the model must support the operation. It does not distinguish the tool from plausible siblings such as upscale_image, enhance_video_media, or convert_video_to_hdr, so it stops short of a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It tells the agent to call get_model_catalog first to pick a supported model and settings, which is a concrete prerequisite. It never says when to choose this over enhance_video_media or upscale_image, and gives no exclusions or input-precondition guidance (e.g. workspace media vs. public URL).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.