[Integrations](https://spiral.ai/integrations) › [dots](https://spiral.ai/integrations/dots) › [MAI Image 2.5](https://spiral.ai/integrations/dots/mai-image-2-5)

# How to Use MAI Image 2.5 in dots

Use MAI Image 2.5 for product imagery, realistic scenes, and posters with text inside the image. It is the base model in the 2.5 series; Pro adds higher fidelity for demanding artwork.

|  |  |
| --- | --- |
| Model | MAI Image 2.5 |
| Available through | fal |
| Category | Image |
| Price | Up to $0.078 per run at the default inputs. $0.078 per unit of `num_images`. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with MAI Image 2.5 in dots

- Every Monday, use MAI Image 2.5 to create a square coffee image for review. Rotate between a ceramic cup, roasted beans, and a paper bag, keeping a walnut surface and soft morning light in every brief.
- Each Friday, use MAI Image 2.5 to prepare a vertical farmers market poster concept. Show seasonal produce under natural light and the quoted headline "SATURDAY MARKET" at the top. Use a three-to-four shape and flag spelling errors.
- On the first day of each month, use MAI Image 2.5 to draft a wide gardening newsletter image. Choose a seasonal planting scene, specify the camera view and light source, and keep the left third open for separate text.
- Every Wednesday, use MAI Image 2.5 to create a square concept photograph of a fictional ceramic vase. Rotate the glaze color, keep a pale stone background, and describe soft side lighting and visible surface texture.
- Each Monday, use MAI Image 2.5 to draft a landscape illustration for a small-business newsletter. Alternate between a bakery, a flower shop, and a repair workshop. Use realistic materials and natural light, then collect the image for review.

## How to set up MAI Image 2.5 in dots

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send dots this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for your dot. Copy it.

2. **Send your dot this message**: Your dot reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give your dot the key**: When your dot asks for the key, add it where your dot keeps secrets, never in the chat itself.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run MAI Image 2.5**: One request; the result comes back by polling or a webhook.

```bash
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": "microsoft/mai-image-2.5",
    "input": {
      "prompt": "A photorealistic concept-art poster of a university campus at sunset, cinematic lighting, a banner reading \"LOUISVILLE\" in bold serif type."
    }
  }'
```

Then paste one of the prompts above: dots finds MAI Image 2.5 on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/dots

## MAI Image 2.5 tools and prices

- [Mai Image 2.5 Text to Image](https://spiral.ai/tools/fal/microsoft/mai-image-2.5) (fal): Up to $0.078 per run at the default inputs. $0.078 per unit of `num_images`.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| num_images | 1 to 4 | 1 | The number of images to generate. |
| aspect_ratio | auto, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 | auto | The aspect ratio of the generated image. Use "auto" to let the model decide based on the prompt. |
| output_format | jpeg, png, webp | png | The format of the generated image. |

## What can you do with MAI Image 2.5 in dots?

Prepare recurring product and editorial image drafts from a written content calendar. A scheduled agent can keep the creative brief consistent and collect outputs for review.

### Product campaign concepts

Create a product scene with a specific material, camera angle, and light source. Use it to compare visual directions before commissioning final photography.

### Posters with embedded text

Explore event posters or packaging concepts with quoted headlines and explicit text placement. Review every word before using the artwork.

### Realistic editorial illustrations

Generate a scene for an article or presentation by describing its subject, setting, lighting, and mood. Use the result as an illustration and check any factual details.

### Brand imagery

Turn a written creative brief into image concepts with defined colors, materials, and composition. Keep those directions explicit when comparing alternatives.

### Presentation visuals

Create a realistic scene with a deliberately open area for slide copy. Describe the image composition separately from any words you want rendered inside it.

### Packaging studies

Explore how a fictional product could look with different materials, label layouts, and lighting. Quote the label wording and inspect the resulting typography.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All dots guides](https://spiral.ai/integrations/dots)

## MAI Image 2.5 in other agents

- [Amp](https://spiral.ai/integrations/amp/mai-image-2-5)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/mai-image-2-5)
- [Claude](https://spiral.ai/integrations/claude-desktop/mai-image-2-5)
- [Claude Code](https://spiral.ai/integrations/claude-code/mai-image-2-5)
- [Cline](https://spiral.ai/integrations/cline/mai-image-2-5)
- [Codex](https://spiral.ai/integrations/codex/mai-image-2-5)
- [Cursor](https://spiral.ai/integrations/cursor/mai-image-2-5)
- [Devin](https://spiral.ai/integrations/devin/mai-image-2-5)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/mai-image-2-5)
- [Gemini](https://spiral.ai/integrations/gemini/mai-image-2-5)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/mai-image-2-5)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/mai-image-2-5)
- [goose](https://spiral.ai/integrations/goose/mai-image-2-5)
- [Grok](https://spiral.ai/integrations/grok/mai-image-2-5)
- [Grok Build](https://spiral.ai/integrations/grok-build/mai-image-2-5)
- [Hermes](https://spiral.ai/integrations/hermes/mai-image-2-5)
- [Instinct](https://spiral.ai/integrations/instinct/mai-image-2-5)
- [Manus](https://spiral.ai/integrations/manus/mai-image-2-5)
- [Muse](https://spiral.ai/integrations/muse/mai-image-2-5)
- [Muse Code](https://spiral.ai/integrations/muse-code/mai-image-2-5)
- [n8n](https://spiral.ai/integrations/n8n/mai-image-2-5)
- [Notion](https://spiral.ai/integrations/notion/mai-image-2-5)
- [OpenClaw](https://spiral.ai/integrations/openclaw/mai-image-2-5)
- [opencode](https://spiral.ai/integrations/opencode/mai-image-2-5)
- [Perplexity](https://spiral.ai/integrations/perplexity/mai-image-2-5)
- [Raycast](https://spiral.ai/integrations/raycast/mai-image-2-5)
- [VS Code](https://spiral.ai/integrations/vscode/mai-image-2-5)
- [Windsurf](https://spiral.ai/integrations/windsurf/mai-image-2-5)
- [Zapier](https://spiral.ai/integrations/zapier/mai-image-2-5)

## More dots guides

- [Luma Uni-1 Text to Image](https://spiral.ai/integrations/dots/luma-uni-1-text-to-image)
- [MOSS Image](https://spiral.ai/integrations/dots/moss-image)
- [Luma Uni-1 Max Edit](https://spiral.ai/integrations/dots/luma-uni-1-max-edit)
- [Makeup Changer](https://spiral.ai/integrations/dots/makeup-changer)
- [Luma Uni-1 Max](https://spiral.ai/integrations/dots/luma-uni-1-max)
- [Marigold V2](https://spiral.ai/integrations/dots/marigold-v2)

## Questions about MAI Image 2.5 in dots

**Can dots use MAI Image 2.5?**

Yes. Add Spiral to dots as an MCP server, and dots can find and run MAI Image 2.5 like any built-in tool.

**How much does MAI Image 2.5 cost in dots?**

Up to $0.078 per run at the default inputs. $0.078 per unit of `num_images`. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your dots plan is separate.

**Do I need a fal account to use MAI Image 2.5 in dots?**

You need no fal account. dots uses one Spiral API key for every tool, and Spiral runs MAI Image 2.5 on its own fal account.

**How long does it take to set up MAI Image 2.5 in dots?**

About two minutes: create an API key, then send your dot this message, then give your dot the key.

**Does dots wait while MAI Image 2.5 runs?**

MAI Image 2.5 runs in the background. dots starts the run, checks on it and gives you the image when it's ready.

**What is MAI Image 2.5 good at?**

Start with product shots, realistic scenes, and promotional artwork. Lighting, reflections, and text inside posters or packaging are documented strengths.

**Can MAI Image 2.5 put readable text in an image?**

Yes. Microsoft specifically documents labels, posters, packaging, and signage as supported text-rendering uses. Check the wording before publishing.

**What is its maximum image resolution?**

The model card specifies a maximum area of 1,048,576 pixels, equivalent to 1024 × 1024 for a square image. Plan larger deliverables around that pixel budget.

**How should I write a prompt?**

Describe the subject, camera view, lighting, layout, and mood. Put any words that should appear inside the image in quotation marks and state where they belong.

**What should I check in the output?**

Check visual details against your brief, especially anything readers might treat as factual. Microsoft warns that plausible-looking details can still be inaccurate or misleading.

