# Meta Muse Image Text to Image

Generate images from text with Meta Muse Image 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.

- Provider: fal
- Category: Image
- Runs: In the background
- Returns: image
- Tool id: `fal` / `meta/muse-image/text-to-image`
- Page: https://spiral.ai/tools/fal/meta/muse-image/text-to-image

## Pricing

$0.013 per image. Billed on `num_images`, default 1.

## Limits

- 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 | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `prompt` (required) | text |  | — | The text prompt used to generate or edit the image. |
| `aspect_ratio` | text |  | — | Any custom output aspect ratio as "width:height", for example "16:9", "5:4", or "1920:1200". Common presets are "21:9", "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16", "9:21". The ratio must be between 1:16 and 16:1, the range Muse supports. Only the ratio is used: Muse renders it at its own fixed resolution of roughly 2.5 megapixels, so "1920:1200" and "960:600" both return the same 1920x1200 image. If omitted, Muse chooses the output dimensions automatically. |
| `num_images` | number (whole) | 1 to 10 | 1 | The number of images to generate. |
| `output_format` | one of | jpeg, png, webp | webp | The format of the generated image. |

## Example

```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": "meta/muse-image/text-to-image",
    "input": {
      "prompt": "A cinematic editorial portrait in soft window light with crisp typography"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=meta%2Fmuse-image%2Ftext-to-image

## Common questions

### Meta Muse Image Text to Image

**How much does Meta Muse Image Text to Image cost?**

$0.013 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 Meta Muse Image Text to Image through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "meta/muse-image/text-to-image"` 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 Meta Muse Image Text to Image?**

No. Spiral runs it on its own fal account and charges your Spiral balance.

**Can my AI agent use Meta Muse Image Text to Image?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

