[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [MiniMax H3 Image Text to Image](https://spiral.ai/integrations/opencode/minimax-h3-image-text-to-image)

# How to Use MiniMax H3 Image Text to Image in opencode

MiniMax H3 Image Text to Image creates scenes, illustrations, and visual designs from a written brief. Unlike MiniMax H3 Image Edit, it starts without reference images, making it useful for exploring a new visual direction.

|  |  |
| --- | --- |
| Model | MiniMax H3 Image Text to Image |
| Available through | fal |
| Category | Image |
| Price | Up to $0.1352 per run at the default inputs. $0.1352 per unit of `num_images`. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with MiniMax H3 Image Text to Image in opencode

- Read the game's art brief and use MiniMax H3 Image Text to Image to create a 5472 × 3072 cover concept: a lone courier crossing a salt flat toward a radio tower, low morning side light, worn canvas clothing, and open sky in the upper third for a title added later. Include no lettering.
- Read the character brief and use MiniMax H3 Image Text to Image for a 4096 × 4096 reference sheet with 2 rows and 3 columns: front, side, and rear views above three expressions. Describe the outfit and proportions consistently in every panel. Include no text.
- Use MiniMax H3 Image Text to Image to create a 4096 × 4096 illustrated cover for the project's gardening guide: two hands holding a seedling above dark soil, visible roots, restrained ink linework, and muted green washes. Leave the top quarter empty for typeset copy.
- Generate a product photo with MiniMax H3 Image Text to Image: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first. Save the result in ./assets.
- Make four logo concepts for a coffee brand called "Northline" with MiniMax H3 Image Text to Image.

## How to set up MiniMax H3 Image Text to Image in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 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 MiniMax H3 Image Text to Image**: 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": "minimax/h3-image/text-to-image",
    "input": {
      "prompt": "A rustic farm-to-table feast on a weathered wooden table, overhead food photograph, warm side light"
    }
  }'
```

Then paste one of the prompts above: opencode finds MiniMax H3 Image Text to Image on Spiral, shows the price and runs it.

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

## MiniMax H3 Image Text to Image tools and prices

- [MiniMax H3 Image Text to Image](https://spiral.ai/tools/fal/minimax/h3-image/text-to-image) (fal): Up to $0.1352 per run at the default inputs. $0.1352 per unit of `num_images`.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_size |  | {"width":2048,"height":2048} | The exact output size. Output area must be 655360 to 20000000 pixels, inclusive, with aspect ratio between 1:3 and 3:1, inclusive. |
| num_images | 1 to 10 | 1 | The number of images to generate, all from one expanded prompt. |
| enable_prompt_expansion |  | true | Rewrite the prompt with a language model into a detailed image description before generation. If expansion fails, the request fails instead of generating from the unexpanded prompt. |
| output_format | jpeg, png, webp, jpg | png | The format of the generated image. |

## What can you do with MiniMax H3 Image Text to Image in opencode?

Create artwork and visual design studies alongside the project that needs them. A coding agent can use project briefs and existing assets to specify composition, materials, and exact copy for MiniMax H3 Image.

### Game cover and store artwork

Bring a character, setting, and lighting direction together in one image for a game cover or store banner. Specify the subject placement and leave deliberate space for the title.

### Character reference sheets

Explore a character's silhouette, clothing, expressions, and proportions in a sheet with explicitly defined rows and columns. Check that the requested details agree across views.

### Packaging concepts

Explore a coordinated packaging design for several products. Supply the complete product names and label copy, then define which colors and graphics distinguish each product.

### Editorial image concepts

Turn an abstract article theme into a concrete photographic scene. Describe the subject, scale, viewpoint, light, and materials so the visual idea is easy to assess.

### Book and card illustrations

Develop cover art or illustrated cards with specified linework, texture, colors, and recurring motifs. State whether lettering belongs in the artwork or will be added later.

### Mechanical design studies

Explore vehicle, machine, or product shapes through multiple views and concept diagrams. Define the visible components and treat the result as a design study for review.

## Overview

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

## MiniMax H3 Image Text to Image in other agents

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

## More opencode guides

- [MiniMax H3 Image Highspeed Text to Image](https://spiral.ai/integrations/opencode/minimax-h3-image-highspeed-text-to-image)
- [MiniMax Image-01](https://spiral.ai/integrations/opencode/minimax-image-01)
- [MiniMax H3 Image Highspeed Edit](https://spiral.ai/integrations/opencode/minimax-h3-image-highspeed-edit)
- [MiniMax Image-01 Subject Reference](https://spiral.ai/integrations/opencode/minimax-image-01-subject-reference)
- [MiniMax H3 Image Edit](https://spiral.ai/integrations/opencode/minimax-h3-image-edit)
- [Muse Image Edit](https://spiral.ai/integrations/opencode/muse-image-edit)

## Questions about MiniMax H3 Image Text to Image in opencode

**Can opencode use MiniMax H3 Image Text to Image?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run MiniMax H3 Image Text to Image like any built-in tool.

**How much does MiniMax H3 Image Text to Image cost in opencode?**

Up to $0.1352 per run at the default inputs. $0.1352 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 opencode plan is separate.

**Do I need a fal account to use MiniMax H3 Image Text to Image in opencode?**

No. Spiral runs MiniMax H3 Image Text to Image on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up MiniMax H3 Image Text to Image in opencode?**

About two minutes: add the server, then sign in, then check it.

**Does opencode wait while MiniMax H3 Image Text to Image runs?**

MiniMax H3 Image Text to Image runs in the background. opencode starts the run, checks on it and gives you the image when it's ready.

**What is MiniMax H3 Image good at?**

MiniMax H3 Image suits detailed scenes, realistic textures, illustrations, and compositions with specific spatial instructions. MiniMax demonstrates uses including game art, character sheets, packaging, and product diagrams.

**What resolution should I use for a detailed final image?**

MiniMax recommends about 16 megapixels for best results. Examples include 4096 × 4096 for a square and 5472 × 3072 for a wide landscape.

**Can MiniMax H3 Image put readable text in an image?**

MiniMax provides guidance for posters, labels, charts, and other images containing text. Quote the exact wording, specify its position and line breaks, and check the rendered copy against your brief.

**How should I structure a MiniMax H3 Image prompt?**

Start with the intended image and its purpose, then specify the layout, subject positions, and visible details. MiniMax recommends writing the image description in English while keeping any visible lettering in its intended language.

**Can MiniMax H3 Image produce a transparent background?**

Transparent backgrounds are not supported. MiniMax also lists masked edits and preview images as unsupported.

