ideogram/4.0/tiling

Name: Ideogram V4.0q Tiling
Author: Ideogram

4.0 Tiling by Ideogram - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.

Input

Prompt(string)

The prompt to generate an image from.

Image URL or upload(string)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum

Optional URL of an image. When provided without `mask_url`, performs image-to-image tiling; with `mask_url`, performs inpainting tiling.

This field is required.

Image URL or upload(string)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum

Optional URL of a mask image for inpainting tiling. White regions are regenerated, black regions are preserved. Requires `image_url`.

Strength(number)

How much to transform the input image. Only used when `image_url` is provided. Range: 0 to 1.

Output Format(string)

The format of the generated image. Allowed values: jpeg, png.

Expansion Model(string)

Which model expands the prompt. 'None' disables prompt expansion and skips its fee; 'Medium' is fast; 'Large' uses Ideogram's Magic Prompt for the highest quality. Allowed values: None, Medium, Large.

Tiling Mode(string)

Tiling direction: 'both' (omnidirectional), 'horizontal' (left-right only), or 'vertical' (top-bottom only). Allowed values: both, horizontal, vertical.

Rendering Speed(string)

The rendering speed to use. Faster speeds use fewer denoising steps. Allowed values: TURBO, BALANCED, QUALITY.

Aspect Ratio(string)

The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.

Seed(integer)

The seed to use for generation. If not provided, a random seed will be used.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDideogram/4.0/tiling

Input Schema

10 parameters · 2 required · 8 optional

Parameter	Type	Required	Description
`image`	string	Required	Optional URL of an image. When provided without `mask_url`, performs image-to-image tiling; with `mask_url`, performs inpainting tiling.
`prompt`	string	Required	The prompt to generate an image from.
`mask`	string	Optional	Optional URL of a mask image for inpainting tiling. White regions are regenerated, black regions are preserved. Requires `image_url`.
`seed`	integer	Optional	The seed to use for generation. If not provided, a random seed will be used.
`strength`	number	Optional	How much to transform the input image. Only used when `image_url` is provided. · Min: 0 · Max: 1 · Default: 0.8
`tiling_mode`	string	Optional	Tiling direction: 'both' (omnidirectional), 'horizontal' (left-right only), or 'vertical' (top-bottom only). · Options: both, horizontal, vertical · Default: "both" bothhorizontalvertical
`aspect_ratio`	string	Optional	The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16
`output_format`	string	Optional	The format of the generated image. · Options: jpeg, png · Default: "jpeg" jpegpng
`expansion_model`	string	Optional	Which model expands the prompt. 'None' disables prompt expansion and skips its fee; 'Medium' is fast; 'Large' uses Ideogram's Magic Prompt for the highest quality. · Options: None, Medium, Large · Default: "Medium" NoneMediumLarge
`rendering_speed`	string	Optional	The rendering speed to use. Faster speeds use fewer denoising steps. · Options: TURBO, BALANCED, QUALITY · Default: "BALANCED" TURBOBALANCEDQUALITY

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "ideogram/4.0/tiling",
  "prompt": "A red panda perched on a mossy branch in a misty forest at sunrise",
  "strength": 0.8,
  "tiling_mode": "both",
  "output_format": "jpeg",
  "expansion_model": "Large",
  "rendering_speed": "BALANCED"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Ideogram V4.0q Tiling

API README

PRICED DRAFT — MANUAL REVIEW REQUIRED exact_model_mode: ideogram/v4/tiling original_unit: Your request will cost $0.03 per megapixel in TURBO mode, $0.06 per megapixel in BALANCED mode, or $0.10 per megapixel in QUALITY mode. method: tiling megapixel tiers by rendering_speed using metered output dimensions result_base_price: 0.24 result_price_formula: ((usage.width ?? 2048) * (usage.height ?? 2048) / 1048576) * ((params.rendering_speed ?? "BALANCED") == "TURBO" ? 0.03 : (params.rendering_speed ?? "BALANCED") == "QUALITY" ? 0.10 : 0.06) review_status: pending; model remains disabled checked_at: 2026-08-16