[Integrations](https://spiral.ai/integrations) › [Muse](https://spiral.ai/integrations/muse) › [MOSS Image](https://spiral.ai/integrations/muse/moss-image)

# How to Use MOSS Image in Muse

MOSS Image creates text-heavy graphics such as bilingual posters, signs, and illustrated explainers. It runs MOSS-Image-SFT, with control over where text and objects appear through structured layout prompts.

|  |  |
| --- | --- |
| Model | MOSS Image |
| Available through | fal |
| Category | Image |
| Price | $0.065 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with MOSS Image in Muse

- Use MOSS Image to make a 1024 × 1536 community book-swap poster. Put 'BOOK SWAP' on the first line and '旧书交换' on the second, with an illustration of stacked books underneath. Use dark lettering on a white background and leave the bottom quarter empty.
- Create a 1024 × 1024 bakery notice with MOSS Image. Show exactly 'Fresh bread' above '每日新鲜面包', with a watercolor loaf centered below the text. Keep both lines separate and make the lettering the main focus.
- Use MOSS Image to create a 1536 × 1024 classroom graphic showing a seed, a seedling, and a mature sunflower from left to right. Label them exactly 'Seed', 'Seedling', and 'Flower'. Use a simple illustrated style and keep the labels below their objects.
- Make a 1024 × 1536 book cover concept with MOSS Image. The exact title is 'The Last Lighthouse' and the author is 'Maya Reed'. Show a photorealistic lighthouse in fog, put the title at the top on two lines, and place the author name at the bottom.
- Use MOSS Image to create a 1536 × 1024 anime-style travel illustration of a quiet mountain railway at sunrise. Place the exact words 'Take the slow route' in the open sky, with 'Take the' on the first line and 'slow route' on the second.

## How to set up MOSS Image in Muse

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

### Use the Muse connector

1. **Create an API key**: Create one under API keys in the Spiral console.

2. **Send Muse this message**: Muse reads Spiral's skill and asks for an API key.

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

3. **Give Muse the key**: Paste the key when Muse asks for it, never in the chat itself.

### Use the Spiral skill

1. **Send Muse 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 MOSS 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": "fal-ai/moss-image",
    "input": {
      "prompt": "A wide view of a refrigerator beside a kitchen counter with a fruit bowl. A small sticky note on the refrigerator door is handwritten in…"
    }
  }'
```

Then paste one of the prompts above: Muse finds MOSS Image on Spiral, shows the price and runs it.

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

## MOSS Image tools and prices

- [MOSS Image · Text to Image](https://spiral.ai/tools/fal/fal-ai/moss-image) (fal): $0.065 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| negative_prompt |  |  | Negative prompt. When empty, guidance uses transformer layer skipping for the negative branch. |
| enable_prompt_expansion |  | true | Plan a structured layout from your prompt before generation. Preserves requested visible text and uses the selected image dimensions. If enhancement is unavailable, uses the original prompt. |
| image_size |  | square_hd | Output image size. Width and height are rounded to multiples of 16 between 512 and 2048 pixels. |
| num_inference_steps | 1 to 100 | 50 | Number of denoising steps. |
| guidance_scale | 0 to 10 | 3 | Classifier-free guidance scale. |
| seed |  | — | Random seed for reproducible generation. |

## What can you do with MOSS Image in Muse?

Turn a written idea into a poster, sign, or illustration with Chinese and English text placed inside the image. A chat app can help settle the wording and composition before asking for the graphic.

### Bilingual event posters

Create a new poster from approved Chinese and English copy, with separate areas for the headline, illustration, date, and location.

### Educational explainers

Turn a short explanation into an illustrated graphic with a title, labeled objects, and clearly separated reading sections. Check the labels against the source material.

### Store signs and notices

Draft opening-hours signs, pickup instructions, and bilingual notices from exact text. Specify line breaks and the relative size of each message.

### Product launch graphics

Generate promotional concepts from a written product description, a short headline, and a planned composition. Review the depicted product details before use.

### Editorial illustrations

Create an article illustration from a written brief, using a photorealistic or anime treatment and deliberate space for a short title.

### Book cover concepts

Explore cover compositions with an exact title, author name, and described scene. Specify the hierarchy and placement of the text before generating.

### Social campaign concepts

Generate separate square and portrait concepts from the same approved message. Adapt the composition to each canvas rather than assuming a crop will preserve the text.

## Overview

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

## MOSS Image in other agents

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

## More Muse guides

- [MAI Image 2.5](https://spiral.ai/integrations/muse/mai-image-2-5)
- [Makeup Changer](https://spiral.ai/integrations/muse/makeup-changer)
- [Luma Uni-1 Text to Image](https://spiral.ai/integrations/muse/luma-uni-1-text-to-image)
- [Marigold V2](https://spiral.ai/integrations/muse/marigold-v2)
- [Luma Uni-1 Max Edit](https://spiral.ai/integrations/muse/luma-uni-1-max-edit)
- [MiniMax H3 Image Edit](https://spiral.ai/integrations/muse/minimax-h3-image-edit)

## Questions about MOSS Image in Muse

**Can Muse use MOSS Image?**

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

**How much does MOSS Image cost in Muse?**

$0.065 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. 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 Muse plan is separate.

**Do I need a fal account to use MOSS Image in Muse?**

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

**How long does it take to set up MOSS Image in Muse?**

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

**Does Muse wait while MOSS Image runs?**

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

**What is MOSS Image useful for?**

Consider MOSS Image for graphics where words and composition both matter: bilingual posters, signs, illustrated explainers, and promotional concepts. Chinese and English text rendering and controlled element placement are its documented specialties.

**Can MOSS Image put Chinese and English in the same graphic?**

MOSS Image specializes in both Chinese and English text rendering. Provide the exact copy for each language and describe where each text block should appear.

**How should I prompt MOSS Image for a specific layout?**

Describe the scene, exact visible text, and positions of the main elements. MOSS Image accepts natural language and structured JSON layouts, so an agent can turn a detailed brief into a layout prompt.

**How large can MOSS Image outputs be?**

Each dimension can range from 512 to 2048 pixels, rounded to a multiple of 16. A 1024 × 1536 poster or 1536 × 1024 landscape graphic fits those limits.

**Can MOSS Image edit a photo or follow an uploaded reference?**

MOSS Image does not directly condition generation on reference images or support image editing. Use it to generate a new composition from a text description.

