Image Generation

Generate images, remove backgrounds, and vectorize with AI models.

POST/api/v1/image/generate

Request Body

Parameter	Type	Required	Description
model	string	Yes	Model key (see models below)
prompt	string	No	Text prompt (required for most models)
params	object	No	Model-specific parameters
attachmentMediaIds	string[]	No	Positional media attachment IDs

Response

{
  "inferenceJobId": "ij_..."
}

Example

POST/api/v1/image/generate

{
  "model": "nano-banana-2",
  "prompt": "A polished product shot of a ceramic mug on travertine",
  "params": { "aspectRatio": "1:1", "resolution": "1K" }
}

Models

nano-banana-2

General-purpose image generation. Prompt required.

Parameter	Type	Required	Description
aspectRatio	string	No	9:16, 16:9, 1:1, 4:5, 4:3, 3:4, 3:2, 2:3, 21:9, 8:1, 1:8, 4:1, 1:4, auto (default 9:16)
resolution	string	No	1K, 2K, 4K (default 1K)
styleId	string	No	Optional style UUID to apply

Attachments: Up to 14 optional reference images.

nano-banana-pro

Pro-tier image generation. Prompt required.

Parameter	Type	Required	Description
aspectRatio	string	No	9:16, 16:9, 1:1, 4:5, 4:3, 3:4, 3:2, 2:3, 21:9, auto (default 9:16)
resolution	string	No	1K, 2K, 4K (default 1K)
styleId	string	No	Optional style UUID to apply

Attachments: Up to 14 optional reference images.

seedream-4-5

High-quality image generation. Prompt required.

Parameter	Type	Required	Description
aspectRatio	string	No	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9 (default 16:9)
resolution	string	No	2K, 4K (default 2K)

Attachments: Up to 14 optional reference images.

z-image

Fast image generation. Prompt required.

Parameter	Type	Required	Description
aspectRatio	string	No	1:1, 21:9, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 9:21 (default 9:16)

Attachments: None.

gpt-image-1-5

OpenAI image generation. Prompt required.

Parameter	Type	Required	Description
aspectRatio	string	No	1:1, 16:9, 9:16 (default 9:16)
quality	string	No	auto, high, medium, low (default auto)
background	string	No	auto, transparent, opaque (default auto)

Attachments: Up to 16 optional reference images.

grok-imagine

Fast image generation and editing by xAI. Prompt required.

Parameter	Type	Required	Description
aspectRatio	string	No	9:16, 16:9, 1:1, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, auto (default 9:16)
resolution	string	No	1k, 2k (default 1k)

Attachments: 1 optional reference image for editing.

grok-imagine-pro

High-quality image generation and editing by xAI. Prompt required.

Parameter	Type	Required	Description
aspectRatio	string	No	9:16, 16:9, 1:1, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, auto (default 9:16)
resolution	string	No	1k, 2k (default 1k)

Attachments: 1 optional reference image for editing.

birefnet-bg-removal

Background removal. No prompt needed.

Parameter	Type	Required	Description
bgRemovalModel	string	No	portrait, general-fast, general-premium (default general-fast)
quality	string	No	low, high (default low)

Attachments: 1 required image (input_image).

runware-vectorize

Image vectorization. No prompt needed.

Parameter	Type	Required	Description
vectorizeModel	string	No	recraft:1@1, picsart:1@1 (default recraft:1@1)

Attachments: 1 required image (input_image).