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 9 tokens/s
curl -X POST https://api.givon.ai/api/v1/generations \
-H "Authorization: Bearer $GIVON_API_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* promptScene / motion description. | string | — | up to 2000 chars |
aspectRatio aspectRatio | string | auto | auto |
resolution resolution | string | 720p | 720p, 1080p |
Source video* sourceVideoAsset input for the sourceVideo slot. | string | — | video · asset, https, data |
Mask video switchxAlphaVideoAsset input for the switchxAlphaVideo slot. | string | — | video · asset, https, data |
Reference images referenceAssetUrisOptional reference assets as asset:// URIs, HTTPS URLs, or data URIs. | array | — | image · up to 1 · asset, https, data |
providerOptions providerOptions | object | — | object |
promptScene / motion description.
- Type
- string
- Default
- —
- Allowed
- up to 2000 chars
aspectRatio- Type
- string
- Default
- auto
- Allowed
- auto
resolution- Type
- string
- Default
- 720p
- Allowed
- 720p, 1080p
sourceVideoAsset input for the sourceVideo slot.
- Type
- string
- Default
- —
- Allowed
- video · asset, https, data
switchxAlphaVideoAsset input for the switchxAlphaVideo slot.
- Type
- string
- Default
- —
- Allowed
- video · asset, https, data
referenceAssetUrisOptional reference assets as asset:// URIs, HTTPS URLs, or data URIs.
- Type
- array
- Default
- —
- Allowed
- image · up to 1 · asset, https, data
providerOptions- Type
- object
- Default
- —
- Allowed
- object
Cost
from 9 tokens/sThe variant is selected automatically from request fields, so you do not need to send it.
Capabilities
image_to_videovideo_to_videoreference_to_videosourceVideo:video*switchxAlphaVideo:videoreferenceAssetUris:image[]<=1Run SwitchX Video
Get an API key and the same request shape will work across every model in the catalog.