How to Use Ideogram 3.0 Character in Gemini
Create new scenes around the same person using one character reference image. Choose this version when you want a new composition, rather than a masked edit or a variation of an existing scene.
Prompts to try with Ideogram 3.0 Character in Gemini
Copy an example into Gemini, or ask in your own words.
Use Ideogram 3.0 Character with my attached portrait. Show the person reading beside a cafe window, wearing a navy sweater, with soft afternoon light and a relaxed expression.
Use Ideogram 3.0 Character with my attached reference to create three separate story images: the character entering a forest, finding a lantern, and resting beside a cabin. Use the same red coat in every scene.
Generate a product photo with Ideogram 3.0 Character: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first.
Make four logo concepts for a coffee brand called "Northline" with Ideogram 3.0 Character.
Create a 16:9 hero image of a quiet mountain cabin at dusk with Ideogram 3.0 Character.
How to set up Ideogram 3.0 Character in Gemini
Pick the way that suits you. Each takes about two minutes.
Use the Gemini connector
- Open Connected Apps
On your computer, go to gemini.google.com. At the bottom, click Settings › Connected Apps. If you don't see Connected Apps, click Personal Intelligence first, then Connected Apps.
- Add Spiral as a custom app
Under Custom apps, click Add a custom app and paste this MCP server URL:
https://api.spiral.ai/mcp
- Sign in to Spiral and approve
Follow the on-screen instructions. Spiral opens: sign in, pick the organization and click Authorize. No API key.
Use the Spiral skill
- Send Gemini this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Ideogram 3.0 Character
One request; the result comes back by polling or a webhook.
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/character", "input": { "prompt": "Place the woman leisurely enjoying a cup of espresso while relaxing at a sunlit café table in Siena, Italy. The café setting showcases vintage wooden furniture…", "reference_image_urls": [ "<reference_image_urls>" ] } }'
Then paste one of the prompts above: Gemini finds Ideogram 3.0 Character on Spiral, shows the price and runs it.
Ideogram 3.0 Character providers and prices
Spiral runs Ideogram 3.0 Character through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Ideogram 3.0 Character works from your image URLs, prompt, and reference image URLs. Ask Gemini for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Rendering speed | TURBO, BALANCED, or QUALITY | BALANCED | The rendering speed to use. |
| Style | AUTO, REALISTIC, or FICTION | AUTO | The style type to generate with. Cannot be used with style_codes. |
| Expand prompt | on or off | on | Determine if MagicPrompt should be used in generating the request or not. |
| Number of images | 1 to 8 | 1 | Number of images to generate. |
| Seed | a whole number | Seed for the random number generator | |
| Negative prompt | what to leave out, in words | Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt. |
Every API field of Ideogram V3 Character · Base is on its tool page: open its card above.
What can you do with Ideogram 3.0 Character in Gemini?
Turn one reference portrait into a set of scenes featuring the same person. Explore poses and settings in conversation, then use an edit or remix when you have a composition to work from.
Recurring story characters
Reuse one character reference for separate story scenes. Describe one action and setting per image, then compare the face and defining traits across the results.
Portrait variations
Explore the same person's appearance in different settings, poses, and outfits. Use a clear reference and specify the changes you want in each scene.
Character placement
Use Character Edit to place a reference character into a masked part of an existing scene. Keep the character preservation mask separate from the scene's replacement mask.
Composition studies
Use Character Remix to reinterpret an existing scene with your character. Compare stronger and weaker image influence to decide how much of the source composition to retain.
Consistent website illustrations
Create a recurring guide character for onboarding, help pages, and empty states. Review facial features and distinctive traits across the set before choosing the final images.
Campaign image variations
Place one recurring character in several campaign scenes. Use new generations for new compositions and Remix when an existing image provides the composition you want.
More on Ideogram 3.0 Character and Gemini
Overview
Ideogram 3.0 Character in other agents
Questions about Ideogram 3.0 Character in Gemini
Can Gemini use Ideogram 3.0 Character?
Yes. Add Spiral to Gemini as an MCP server, and Gemini can find and run Ideogram 3.0 Character like any built-in tool.
How much does Ideogram 3.0 Character cost in Gemini?
$0.065 per image. Billed on `num_images`, default 1. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini plan is separate.
Do I need a fal account to use Ideogram 3.0 Character in Gemini?
No. Spiral runs Ideogram 3.0 Character on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Ideogram 3.0 Character in Gemini?
About two minutes: open Connected Apps, then add Spiral as a custom app, then sign in to Spiral and approve.
Does Gemini wait while Ideogram 3.0 Character runs?
Ideogram 3.0 Character runs in the background. Gemini starts the run, checks on it and gives you the image when it's ready.
Which version should I use?
Use Character for a new scene built around your reference person. Use Character Edit to replace a masked region, or Character Remix to reinterpret an existing composition.
Can I supply several character reference photos?
These Character endpoints support one character reference image. Extra character references are ignored, so choose the clearest image of the character.
What kind of reference image works best?
Start with a clear image showing one character without heavy filters. Avoid blurry images, group photos, and heavily distorted faces.
What does the character mask do?
It defines which parts of the reference should carry into new images, such as the face, hair, or clothing. Character Edit also uses a separate scene mask to identify the area to replace.
How closely does Remix follow the original image?
Image strength controls how much of the source carries into the result. Raise it to retain more of the original, or lower it when you want a larger departure.
Start using Ideogram 3.0 Character in Gemini
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Gemini:
set up https://spiral.ai/SKILL.md


