Skip to main content
Glama

expand video

expand_video
Destructive

Run the Reframe preset on a complete workspace video up to 120 seconds and 500 MB. Outpaint a new aspect ratio, join provider chunks, and restore the original audio. Supports runway-aleph-2, google-gemini-omni-1-1, luma-ray-3-2-reframe, ltx-2.3-reframe, wan-2-2-vace-reframe, and beeble-switchframe. LTX supports 1:1, 4:5, 5:4, 9:16, and 16:9 at 720p or 1080p and automatically matches the scene; omit prompt for LTX. SwitchFrame requires a workspace image in mediaInputs.reference_image_uri. Call once per requested source/format/settings variant. 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": "expand_video"
  }
}

Input Schema

NameRequiredDescriptionDefault
modelYesActive model ID supporting this operation. Use get_model_catalog.
promptNoEdit or enhancement instructions.
durationNoExpected complete source duration in seconds, used to verify the approved Reframe plan.
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

A4.3/5.0
Behavior4/5

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

Annotations already declare the write/destructive, open-world, non-idempotent profile, and the description adds real behavior beyond that: the chunk-join and audio-restore pipeline, per-model requirements, per-model aspect-ratio support, and a tracked task with a playable result on completion. It stops short of explaining cost exposure (maxCostUsd checks, paid per variant) or failure modes, which would have been the remaining high-value disclosure for a destructive generation tool.

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?

Front-loaded with the operation and its limits, then model list, then per-model rules, then a return note. Dense but nearly every clause carries operational information; only the packed enumeration of LTX aspect ratios and the six model IDs is close to bulk that could be delegated to get_model_catalog.

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 23-parameter, nested-schema, destructive generation tool with an output schema, the description covers the operation, size limits, model selection path, per-model prerequisites, and result shape. Notable omissions are cost/approval semantics and idempotency/retry behavior, which matter given the non-idempotent, chargeable nature of the call.

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

Parameters4/5

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

With 83% schema coverage the baseline is 3, and the description earns above it by assigning concrete meaning to specific parameters: prompt is omitted for LTX, mediaInputs.reference_image_uri is mandatory for SwitchFrame, and aspectRatio/resolution are constrained per model. The remaining 23-parameter surface (maxCostUsd, idempotencyKey, duration verification) is left entirely to the schema.

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

Purpose5/5

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

Opens with a specific verb and resource ("Run the Reframe preset on a complete workspace video") plus hard limits (120 seconds, 500 MB), which distinguishes it from edit_video, generate_video, and upscale_video without needing their schemas. The follow-on mechanics (outpaint a new aspect ratio, join provider chunks, restore original audio) make the operation unambiguous.

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

Usage Guidelines4/5

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

Gives concrete routing advice: use get_model_catalog to pick a supported model and settings, omit prompt for LTX, supply mediaInputs.reference_image_uri for SwitchFrame, and call once per source/format/settings variant. It never states when to prefer a sibling such as edit_video or upscale_video, so the guidance is strong on how to call it but incomplete on when not to.

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.