SwitchX Image
Beeble relighting and compositing: transfers an object, background, or light from text, one reference, and an optional mask onto the source photo with physically consistent lighting instead of generating from scratch. 720p and 1080p.
Cost
from 6 tokens
curl -X POST https://api.givon.ai/api/v1/generations \
-H "Authorization: Bearer $GIVON_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"image","model":"switchx-image","input":{"prompt":"studio portrait of a red corgi, soft light","aspectRatio":"9:16","imageSize":"720p","sourceImage":"asset://asset_...","referenceAssetUris":["asset://asset_..."]}}'Input fields
* required| Field | Type | Default | Allowed |
|---|---|---|---|
prompt* promptImage description. | string | — | string |
aspectRatio aspectRatio | string | 9:16 | 9:16, 16:9, 1:1, 4:3, 3:4, 2:3, 3:2, 21:9 |
imageSize imageSize | string | 720p | 720p, 1080p |
Source image sourceImageAsset used as the source image for image editing. | string | — | image · asset, https, data |
Mask image maskImageOptional mask image for region editing. Requires sourceImage. | string | — | image · asset, https, data |
Reference images referenceAssetUrisOptional reference images as asset:// URIs, HTTPS URLs, or data URIs. | array | — | image · up to 1 · asset, https, data |
promptImage description.
- Type
- string
- Default
- —
- Allowed
- string
aspectRatio- Type
- string
- Default
- 9:16
- Allowed
- 9:16, 16:9, 1:1, 4:3, 3:4, 2:3, 3:2, 21:9
imageSize- Type
- string
- Default
- 720p
- Allowed
- 720p, 1080p
sourceImageAsset used as the source image for image editing.
- Type
- string
- Default
- —
- Allowed
- image · asset, https, data
maskImageOptional mask image for region editing. Requires sourceImage.
- Type
- string
- Default
- —
- Allowed
- image · asset, https, data
referenceAssetUrisOptional reference images as asset:// URIs, HTTPS URLs, or data URIs.
- Type
- array
- Default
- —
- Allowed
- image · up to 1 · asset, https, data
Cost
from 6 tokensThe variant is selected automatically from request fields, so you do not need to send it.
Capabilities
text_to_imageimage_editimage_referencesourceImage:imagemaskImage:imagereferenceAssetUris:image[]<=1Run SwitchX Image
Get an API key and the same request shape will work across every model in the catalog.