Muse Image API for Low-Cost Image Generation

Muse Image is Meta's image model. POST to /api/v1/images/generations with model: muse-image and a prompt, optionally guided by up to 9 reference images in image_list. Every job returns a single WebP image at a flat price per image.
Get API Key
Photo studio table with a ceramic cup under soft window light

Text or References In, One Image Out

Guided by up to 9 references

Pass up to 9 images in image_list as [{"url": "https://…"}]. Describe in the prompt what to keep from them and what to change, for example keeping a product and placing it in a new scene.
Mood board of printed photos spread on a designer's desk

Seven aspect ratios

Set ratio to 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 or 2:3. The default auto means 1:1 for text to image and follows the reference images when image_list is given.
Blank picture frames of different proportions on a gallery wall
Only model and prompt are required; the output size is chosen by the model.

Muse Image Request Fields and Limits

model

Always muse-image.

prompt (required)

What to generate, up to 4,000 characters. With reference images, describe what to keep and what to change.

image_list

Optional, up to 9 objects like {"url": "https://…"}. Public JPG, PNG or WebP, up to 30MB each. Large images are downscaled automatically.

ratio

auto (default), 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 or 2:3.

Not accepted

image_size and resolution, and more than 9 reference images. These are rejected before any tokens are charged.

Result

A single WebP image per job. The size is picked by the model.

custom_callback_url

Optional public HTTPS URL. When the task status changes (processing / success / failed), GoEnhance POSTs the job-detail body to it. Return HTTP 200 to acknowledge; otherwise delivery is retried up to 3 times, with a 3-second timeout per attempt.
One flat price per image, with or without reference images.

Muse Image API Pricing

0.5 tokens ($0.01) per image

Every job returns one image for the same price, whatever the aspect ratio.

Reference images are free

Adding 1 to 9 images in image_list does not change the price.

Refunded on failure

Tokens are deducted when the task is accepted and refunded automatically if the generation fails.

Quote before you submit

Call POST /api/v1/pricing/quote with model: muse-image to confirm the price for free.

Integrate the Muse Image API

1

Create an API key

Generate a key at /keys and send it as Authorization: Bearer <key> from your server.
2

Submit the prompt

POST {"model": "muse-image", "prompt": "…"} to /api/v1/images/generations; add image_list and ratio if needed.
3

Store img_uuid

Save data.img_uuid and data.cost from the response, then poll GET /api/v1/jobs/detail?img_uuid=<img_uuid> or wait for your callback.
4

Download the image

On success, read the WebP link from the job detail and download it before the link expires.
Create an API Key
Image generation at a low flat price per image.

What Developers Build with Muse Image

Product scenes

Keep a product from a reference photo and place it in new settings for listings and ads.

Drafts and variations

Generate many options for a prompt cheaply before picking one to refine.

Social and blog visuals

Create square, vertical or wide images to match each channel.

High-volume generation

A flat price per image makes batch jobs easy to budget.
Endpoint, inputs, pricing and results.

Muse Image API FAQ

What is the Muse Image API endpoint?

POST https://api.goenhance.ai/api/v1/images/generations with model: muse-image.

Can I choose the output resolution?

No. The model picks the output size, so there is no image_size or resolution tier. Use ratio to set the shape.

How many reference images can I send?

Up to 9 in image_list. More than 9 is rejected before any tokens are charged.

What format is the result?

A single WebP image per job.

How is it priced?

0.5 tokens ($0.01) per image, flat. Reference images are not charged.

How do I know when the job is done?

Poll GET /api/v1/jobs/detail?img_uuid=… or pass custom_callback_url; failed jobs are refunded automatically.

Start Building with the Muse Image API