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
Try SwitchX Image in Givon AI
Open a working project for regular creation, or use Playground to inspect the model parameters.
Use through API
Request fields, constraints, and ready-to-use examples for developers. The user workflow starts above.
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":"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 | — | up to 2000 chars |
aspectRatio aspectRatio | string | 9:16 | 16:9, 1:1, 21:9, 2:3, 3:2, 3:4, 4:3, 9:16 |
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
- up to 2000 chars
aspectRatio- Type
- string
- Default
- 9:16
- Allowed
- 16:9, 1:1, 21:9, 2:3, 3:2, 3:4, 4:3, 9:16
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
image_editsourceImage:imagemaskImage:imagereferenceAssetUris:image[]<=1