expand video
expand_videoRun 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
| Name | Required | Description | Default |
|---|---|---|---|
| model | Yes | Active model ID supporting this operation. Use get_model_catalog. | |
| prompt | No | Edit or enhancement instructions. | |
| duration | No | Expected complete source duration in seconds, used to verify the approved Reframe plan. | |
| maxCostUsd | No | Maximum charge for each output. Checked against authoritative pricing before generation. | |
| resolution | No | ||
| aspectRatio | No | ||
| endFrameUrl | No | ||
| mediaInputs | No | Named media slots from get_model_catalog, for example reference_image_uri or mask_url. | |
| scaleFactor | No | Upscaling multiplier when supported by the selected model. | |
| sparkTaskId | No | Originating Spark task for library history and recovery. | |
| workspaceId | No | ||
| modelVariant | No | Variant value from get_model_catalog variantSelector.options, such as high for Flare quality. Uses the catalog default when omitted. | |
| outputFormat | No | Output format when supported by the selected model. | |
| generateAudio | No | Explicitly enable or disable generated video audio, when supported. | |
| modelSettings | No | Model-specific controls using keys and options from get_model_catalog inputConstraints.slots or variantSelector. | |
| sourceMediaId | Yes | Completed workspace source media. The original is preserved. | |
| idempotencyKey | No | Stable request key. Retries with the same key reuse the existing output and do not start another paid generation. | |
| sourceImageUrl | No | Public HTTP(S) source image/start-frame URL. Use mediaId for workspace images. | |
| sourceVideoUrl | No | Public HTTP(S) source-video URL. | |
| endFrameMediaId | No | Workspace image for the final frame, when supported by the selected model. | |
| referenceImages | No | Images 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. | |
| sourceImageMediaId | No | Workspace image to use as the source image/start frame. | |
| sourceVideoMediaId | No | Workspace video to edit or transform, when supported by the selected model. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| error | No | ||
| success | Yes |