Ideogram Text to Image
fal-ai/ideogram/v3Generate and edit images from text with Ideogram Text to Image from fal through one Spiral API key. It runs in the background and returns images. Pay as you go, with no subscription.
Pricing
$0.039 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
| Field | Kind | Default | Description |
|---|---|---|---|
image_urls | URLs or files | — | A set of images to use as style references (maximum total size 10MB across all style references). The images should be in JPEG, PNG or WebP format |
rendering_speed | one of TURBO, BALANCED, QUALITY | BALANCED | The rendering speed to use. |
color_palette | JSON | — | A color palette for generation, must EITHER be specified via one of the presets (name) or explicitly via hexadecimal representations of the color with optional weights (members) |
style_codes | list | — | A list of 8 character hexadecimal codes representing the style of the image. Cannot be used in conjunction with style_reference_images or style |
style | one of AUTO, GENERAL, REALISTIC, DESIGN | — | The style type to generate with. Cannot be used with style_codes. |
expand_prompt | true or false | true | Determine if MagicPrompt should be used in generating the request or not. |
num_images | number (whole) 1 to 8 | 1 | Number of images to generate. |
seed | number (whole) | — | Seed for the random number generator |
style_preset | one of 80S_ILLUSTRATION, 90S_NOSTALGIA, ABSTRACT_ORGANIC, ANALOG_NOSTALGIA, ART_BRUT, ART_DECO, ART_POSTER, AURA, AVANT_GARDE, BAUHAUS, BLUEPRINT, BLURRY_MOTION, BRIGHT_ART, C4D_CARTOON, CHILDRENS_BOOK, COLLAGE, COLORING_BOOK_I, COLORING_BOOK_II, CUBISM, DARK_AURA, DOODLE, DOUBLE_EXPOSURE, DRAMATIC_CINEMA, EDITORIAL, EMOTIONAL_MINIMAL, ETHEREAL_PARTY, EXPIRED_FILM, FLAT_ART, FLAT_VECTOR, FOREST_REVERIE, GEO_MINIMALIST, GLASS_PRISM, GOLDEN_HOUR, GRAFFITI_I, GRAFFITI_II, HALFTONE_PRINT, HIGH_CONTRAST, HIPPIE_ERA, ICONIC, JAPANDI_FUSION, JAZZY, LONG_EXPOSURE, MAGAZINE_EDITORIAL, MINIMAL_ILLUSTRATION, MIXED_MEDIA, MONOCHROME, NIGHTLIFE, OIL_PAINTING, OLD_CARTOONS, PAINT_GESTURE, POP_ART, RETRO_ETCHING, RIVIERA_POP, SPOTLIGHT_80S, STYLIZED_RED, SURREAL_COLLAGE, TRAVEL_POSTER, VINTAGE_GEO, VINTAGE_POSTER, WATERCOLOR, WEIRD, WOODBLOCK_PRINT | — | Style preset for generation. The chosen style preset will guide the generation. |
prompt required | text | — | |
image_size | JSON | square_hd | The resolution of the generated image |
negative_prompt | text | Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt. |
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": "fal-ai/ideogram/v3",
"input": {
"prompt": "The Bone Forest stretched across the horizon, its trees fashioned from the ossified remains of ancient leviathans that once swam through the sky. Shamans with…"
}
}'Frequently asked questions
How much does Ideogram Text to Image cost?
$0.039 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 Text to Image through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/ideogram/v3"` 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 Text to Image?
No. Spiral runs it on its own fal account and charges your Spiral balance.
Can my AI agent use Ideogram Text to Image?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.