SwitchX Video

Changes the background, object, or lighting in existing footage from text, one reference, and an optional mask while preserving the subject, shape, motion, and expressions. Duration comes from the source video; output is 720p or 1080p.

Cost

from 0.3 tokens/frame

VideoProvider: Beeble

Try SwitchX Video in Givon AI

Open a working project for regular creation, or use Playground to inspect the model parameters.

Create in a project Open in playground Use through API

Use through API

Request fields, constraints, and ready-to-use examples for developers. The user workflow starts above.

Run generation

IDEMPOTENCY_KEY="${IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.givon.ai/api/v1/generations \
  -H "Authorization: Bearer $GIVON_API_KEY" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","model":"switchx-video","input":{"prompt":"cinematic drone shot over a city at night","aspectRatio":"auto","resolution":"720p","sourceVideo":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'

Input fields

* required

Field	Type	Default	Allowed
prompt*`prompt` Generation prompt describing the scene, action and direction.	string	—	up to 2000 chars
aspectRatio`aspectRatio`	string	auto	auto
resolution`resolution`	string	720p	720p, 1080p
Source video*`sourceVideo` Asset input for the sourceVideo slot.	string	—	video · asset, https, data
Mask video`switchxAlphaVideo` Asset input for the switchxAlphaVideo slot.	string	—	video · asset, https, data
Reference images`referenceAssetUris` Optional reference assets as asset:// URIs, HTTPS URLs, or data URIs. The item limit applies to physical references after repeated owned asset identities and identities already bound to video slots are excluded. URL entries remain distinct; every supplied item is validated.	array	—	image · up to 1 · asset, https, data
providerOptions`providerOptions`	object	—	object

prompt*prompt

Generation prompt describing the scene, action and direction.

Type: string
Default: —
Allowed: up to 2000 chars

aspectRatioaspectRatio

Type: string
Default: auto
Allowed: auto

resolutionresolution

Type: string
Default: 720p
Allowed: 720p, 1080p

Source video*sourceVideo

Asset input for the sourceVideo slot.

Type: string
Default: —
Allowed: video · asset, https, data

Mask videoswitchxAlphaVideo

Asset input for the switchxAlphaVideo slot.

Type: string
Default: —
Allowed: video · asset, https, data

Reference imagesreferenceAssetUris

Optional reference assets as asset:// URIs, HTTPS URLs, or data URIs. The item limit applies to physical references after repeated owned asset identities and identities already bound to video slots are excluded. URL entries remain distinct; every supplied item is validated.

Type: array
Default: —
Allowed: image · up to 1 · asset, https, data

providerOptionsproviderOptions

Type: object
Default: —
Allowed: object

Cost

from 0.3 tokens/frame

720pdefault9 tk

1080p27 tk

The variant is selected automatically from request fields, so you do not need to send it.

Capabilities

Modesvideo_edit

Asset slotssourceVideo:video*switchxAlphaVideo:videoreferenceAssetUris:image[]<=1

Get API key

Where to use this model

AI video generator Image to video