# Muse Image 1.0

> Meta's Muse Image model over the Meta developer API - text-to-image with built-in web and image search grounding, up to 10 images per request, webp/png/jpeg output. To edit an existing image use meta/muse-image-1.0/edit.

- **Provider**: meta-image
- **Model ID**: meta/muse-image-1.0
- **Category**: image_generation
- **Credits**: 24 per request
- **Pricing Type**: input_based

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `size` (string, optional): Aspect ratio as "WxH". Sets the ratio only - the image is rendered at the model's native resolution, so returned dimensions are not exactly these numbers. Omit to let the model choose. (Options: `1024x1024`, `1792x1024`, `1024x1792`, `1536x1024`, `1024x1536`, `1280x720`, `720x1280`)
- `output_format` (string, optional): Output image format. (Default: `webp`; Options: `webp`, `png`, `jpeg`)
- `prompt` (string, **required**): Text prompt describing the image to generate.
- `n` (integer, optional): Number of images to generate (1-10). Billed per image. (Default: `1`; Range: min: 1, max: 10)

## Example Request

```json
{
  "model": "meta/muse-image-1.0",
  "input": {
    "size": "1792x1024",
    "prompt": "A cozy Seoul street cafe at dusk, warm window light, rain-slick pavement, cinematic photo"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

url

## Tags

meta, muse, image-generation, text-to-image

## Documentation

https://dev.meta.ai/docs/image-generation