# Meta Muse Image Text to Image

Meta Muse Image Text-to-Image creates detailed images from prompts with strong instruction following, accurate text rendering, and flexible aspect ratios.

## API Information

- **Model Slug:** meta-muse-image-text-to-image
- **Branded URL:** https://www.eachlabs.ai/meta/muse-image/meta-muse-image-text-to-image
- **Provider:** Meta
- **Category:** Text to Image
- **Output Type:** image
- **Status:** active
- **Base Cost:** $0.01 per image
- **Estimated Processing Time:** 60 seconds
- **Interactive Demo:** https://www.eachlabs.ai/ai-models/meta-muse-image-text-to-image

## Pricing

- **Charge Type:** dynamic
- **Estimate:** $0.01 per image
- **Pricing Details:** default: $0.01

## Input Schema

| Parameter | Type | Required | Default | Constraints | Description |
|-----------|------|----------|---------|-------------|-------------|
| prompt | string | Yes | - | - | Text description of the image to generate. Include subject, scene, style, composition, and any text that should appear in the image. |
| aspect_ratio | string | No | - | 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21 | Output aspect ratio. If omitted, the model chooses dimensions automatically from the prompt. Use 1:1 for square images, 16:9 or 21:9 for wide layouts, and 9:16 or 9:21 for vertical formats. |
| num_images | integer | No | 1 | 1–10 | Number of images to generate. Range: 1 to 10. Default: 1. |
| output_format | string | No | webp | jpeg, png, webp | Output image format. webp is the default for compact delivery, png is useful for lossless workflows, and jpeg is useful for broad compatibility. |

## Example Request

```bash
curl -X POST https://api.eachlabs.ai/v1/prediction/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "meta-muse-image-text-to-image",
  "input": {
    "prompt": "cinematic wildflower meadow during late golden hour, tall soft grasses and delicate burgundy, peach and cream flowers moving gently in the breeze, an old wooden chair placed alone among the flowers with an open sketchbook resting on it, distant rolling hills fading into warm atmospheric haze, dreamy but highly realistic photography, rich autumn-inspired colors, soft natural sunlight, subtle film grain, poetic editorial aesthetic, sophisticated composition"
  }
}'
```

## Output Schema

Response returned by `GET /v1/prediction/{id}` when the job completes:

```json
{
  "status": "success",
  "predictionID": "string",
  "output": "string (URL of generated image)",
  "metrics": {
    "predict_time": "number (seconds)"
  }
}
```

## Polling

```bash
curl https://api.eachlabs.ai/v1/prediction/{PREDICTION_ID} \
  -H "Authorization: Bearer YOUR_API_KEY"
```

| Status | Meaning |
|--------|---------|
| `processing` | Still running — poll again |
| `success` | Done — read `output` |
| `error` | Failed — read `message` / `details` |

## Webhook (alternative to polling)

Pass `"webhook_url": "https://your.host/path"` in the create request. Eachlabs POSTs this payload when the job ends:

```json
{
  "exec_id": "prediction-uuid",
  "status": "succeeded",
  "output": "https://...",
  "error": ""
}
```

`status` is `"succeeded"` or `"failed"`. `exec_id` equals the `predictionID` from create. Return 2xx within 30 seconds.

## Errors

Error body: `{ "status": "error", "message": "...", "details": "..." }`

| Code | Meaning |
|------|---------|
| `400` | Invalid input |
| `401` | Missing / invalid `Authorization` bearer token |
| `404` | Unknown model or prediction id |
| `429` | Rate limit — 100 creates / min, 10 concurrent per key |
| `5xx` | Retry with backoff |

## Overview

**Meta Muse Image Text to Image Overview**

Meta Muse Image Text to Image is Meta’s in-house generative image model that creates and edits rich visuals directly from natural language prompts. Built by **Meta Superintelligence Labs** as part of the broader Muse family, it focuses on instruction-following fidelity, accurate text rendering inside images, and multi-step “agentic” reasoning over complex requests. Within a few weeks of launch, Muse Image ranked among the top models on community text-to-image leaderboards, making it a strong choice for high-quality visuals where prompt precision and layout control matter. On each::labs, the **Meta Muse Image Text to Image** endpoint provides convenient access to this capability, so developers and creators can generate on-brand ads, posters, and concept art from concise prompts without managing Meta’s consumer interfaces.

## Usage Notes

- API Base URL: `https://api.eachlabs.ai/v1`
- Authentication: send `Authorization: Bearer YOUR_API_KEY`. Generate a key from the Eachlabs dashboard at https://www.eachlabs.ai/dashboard/api-keys.
- File-typed parameters (`*_url`, `image_url`, `video_url`, `audio_url`, etc.) accept publicly-reachable HTTPS URLs only. Upload your asset first (GCS / S3 / your CDN) and pass the resulting URL. Data-URIs and localhost URLs are rejected.
- For structured parameters (arrays / objects) send real JSON values, not stringified payloads.
- Monetary values are reported in USD; per-token / per-megapixel rates may be billed in micro-cents internally.
- Prefer `webhook_url` over polling for long-running predictions — see the Webhook Callback section.