Amazon-Nova-Canvas | EmpirioLabs AI Docs

Provider: Amazon
Category: Image Generation
Endpoint: POST /v1/images/generations
Context window: —
Served from: —

Image generation and editing model creating and modifying images from text or image inputs, with inpainting, virtual try-on, and style controls.

At a glance

Field	Value
Model id	`amazon-nova-canvas`
Input modalities	text
Output modalities	image
Context window	—
Region	—
Features	inpainting, background_removal
New	No
Native inference	No

Pricing

Charge	Spec	Rate
Small Standard (≤1024×1024)	per image	$0.12
Small Premium (≤1024×1024)	per image	$0.18
Large Standard (≤2048×2048)	per image	$0.18
Large Premium (≤2048×2048)	per image	$0.24

Example request

$ curl https://api.empiriolabs.ai/v1/images/generations \
>   -H 'Authorization: Bearer $EMPIRIOLABS_API_KEY' \
>   -H 'Content-Type: application/json' \
>   -d '{"model": "amazon-nova-canvas", "prompt": "a misty forest at dawn", "size": "1024x1024"}'

Parameters

Parameter	Type	Required	Default	Description
`task_type`	enum	no	`"TEXT_IMAGE"`	Job kind. INPAINTING/OUTPAINTING/IMAGE_VARIATION/COLOR_GUIDED/BACKGROUND_REMOVAL/VIRTUAL_TRY_ON each enable different sub-params. · Allowed: `TEXT_IMAGE`, `IMAGE_VARIATION`, `INPAINTING`, `OUTPAINTING`, `BACKGROUND_REMOVAL`, `COLOR_GUIDED_GENERATION`, `VIRTUAL_TRY_ON`
`prompt`	string	yes	—	Prompt. Required for all task types except BACKGROUND_REMOVAL.
`negative_prompt`	string	no	`""`	What to avoid.
`aspect_ratio`	enum	no	`"1:1"`	Output aspect ratio. · Allowed: `1:1`, `3:4`, `2:3`, `9:16`, `1:2`, `1:3`, `1:4`, `4:3`, `3:2`, `16:9`, `2:1`, `3:1`, `4:1`
`size_scale`	enum	no	`"small"`	small: max 1024px on long side. large: max 2048px. · Allowed: `small`, `large`
`num_images`	number	no	`1`	Number of images to generate. · Range: 1 – 5
`cfg_scale`	number	no	`7`	Classifier-free guidance. · Range: 1.1 – 10
`seed`	number	no	—	Reproducibility seed.
`similarity_strength`	number	no	`0.7`	IMAGE_VARIATION only. 0.2 = creative, 1.0 = stay close to source. · Range: 0.2 – 1
`inpaint_mask_prompt`	string	no	—	INPAINTING only. Describe what to mask (e.g. ‘the sofa’).
`mask_type`	enum	no	`"GARMENT"`	VIRTUAL_TRY_ON only. · Allowed: `GARMENT`, `PROMPT`, `IMAGE`
`tryon_mask_prompt`	string	no	—	VIRTUAL_TRY_ON only with mask_type=PROMPT.
`garment_class`	enum	no	`"UPPER_BODY"`	VIRTUAL_TRY_ON only with mask_type=GARMENT. · Allowed: `UPPER_BODY`, `LOWER_BODY`, `FOOTWEAR`, `FULL_BODY`
`colors`	string	no	—	COLOR_GUIDED_GENERATION only. Comma-separated hex colors (e.g. ‘#C2D1E6,#636574’).
`image`	string	no	—	Reference image URL or base64. Required for IMAGE_VARIATION/INPAINTING/OUTPAINTING/BACKGROUND_REMOVAL/VIRTUAL_TRY_ON.
`response_format`	enum	no	`"url"`	Output shape. · Allowed: `url`, `b64_json`

Live machine-readable schema is also available at GET https://api.empiriolabs.ai/v1/models/amazon-nova-canvas.