Spiral gives your agent every tool with one account. Browse the tools →

falImageAvailable now

Ideogram V4.0q Tiling

ideogram/v4/tiling

Generate and edit images from text with Ideogram V4.0q Tiling from fal through one Spiral API key. It runs in the background and returns images. Pay as you go, with no subscription.

Pricing

$0.052 per image. Billed on num_images, default 1.

Limits

Runs
In the background
Returns
image
Longest queue wait
1 hour
Run deadline
30 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
prompt requiredtext—

The prompt to generate an image from.

expansion_modelone of
None, Medium, Large
Medium

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.

image_sizeJSONsquare_hd

The resolution of the generated seamlessly tileable image.

rendering_speedone of
TURBO, BALANCED, QUALITY
BALANCED

The rendering speed to use. Faster speeds use fewer denoising steps.

accelerationone of
none, low, regular, high
none

The acceleration level to use for the image generation.

num_imagesnumber (whole)
1 to 4
1

Number of images to generate.

seednumber (whole)—

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

output_formatone of
jpeg, png
jpeg

The format of the generated image.

image_urlURL or file—

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

mask_urlURL or file—

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

strengthnumber
0 to 1
0.8

How much to transform the input image. Only used when image_url is provided.

tiling_modeone of
both, horizontal, vertical
both

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

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "ideogram/v4/tiling",
    "input": {
      "prompt": "A red panda perched on a mossy branch in a misty forest at sunrise"
    }
  }'

Frequently asked questions

How much does Ideogram V4.0q Tiling cost?

$0.052 per image. Billed on `num_images`, default 1. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Ideogram V4.0q Tiling through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "ideogram/v4/tiling"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with fal to use Ideogram V4.0q Tiling?

No. Spiral runs it on its own fal account and charges your Spiral balance.

Can my AI agent use Ideogram V4.0q Tiling?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.