APIMart
Image

Muse Image API

Generate an image from a prompt or up to nine reference images with Muse Image API. Choose a supported aspect ratio or follow the reference aspect ratio, then retrieve one WebP image through the task API.

Image generation

Service Highlights

  • Official Discounts
  • Pay-as-you-go
  • Fast & Low Latency
Input
Reference Image

Optional: up to 9 images, 11 MiB total. Auto follows the reference aspect ratio.

Output

No generations yet.

Muse Image API Pricing

Transparent pricing with no hidden fees. Pay only for what you use.

VariantGoldCurrent pricePlatinumDiamondOfficialYour savings
muse-image-ext0.048Credits(~$0.0048)/pic0.0456Credits(~$0.0046)/pic0.0432Credits(~$0.0043)/pic0.06Credits(~$0.006)/pic20%

* Actual costs are subject to final output.

Build with Muse Image API

Generate an image from a prompt or up to nine reference images with Muse Image API. Choose a supported aspect ratio or follow the reference aspect ratio, then retrieve one WebP image through the task API.

What Muse Image API supports

Generation modes, inputs and output specifications for your application.

Text to image with Muse Image API

Describe the subject, scene, composition and lighting in a nonempty prompt. Submit without reference images for text-to-image generation.

Reference images with Muse Image API

Supply up to nine images alongside a prompt. URL, Data URI and base64 inputs are supported; the original images must total no more than 11 MiB.

Seven aspect ratios for Muse Image

Choose 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 or 2:3. Auto omits aspect_ratio so reference-image requests can follow the reference aspect ratio.

One WebP image from the Muse Image Model

Each request produces one image. The model determines the output dimensions; pixel size and resolution tiers cannot be selected.

Use muse-image-ext in your requests

Send the complete model ID muse-image-ext to /v1/images/generations to start a generation task.

Asynchronous tasks with Muse Image API

Submit once and save the task ID, then query its status. Reuse the same idempotency key and request body if an interrupted submission needs to be retried.

Muse Image API pricing

Review the live pricing for your account before generating. Final task cost and your account statement determine the charge. Each request is billed per image.

Retrieve and save Muse Image results

Read the result URL after the task reaches completed. If the response includes expires_at, download or archive the file before that time.

What you can create with Muse Image API

Plan each brief around the content you want to produce and review the delivered result.

Product scenes with Muse Image API

Describe a product setting, lighting and composition, with reference images when useful. Review product details before publishing.

Campaign concepts with Muse Image

Explore a campaign idea through subjects, palettes and visual styles. Review each image against the creative brief.

Editorial images with Muse Image API

Translate an article or story into a visual brief. Specify the focal point and leave room for text added in your layout tool.

Reference-led design with muse-image-ext

Combine a written brief with selected reference images to guide the scene. Check the output against the details that matter to your design.

Social visuals with Muse Image

Choose portrait, square or landscape framing for the intended placement. Adapt the final image in your publishing workflow.

Image tools powered by Muse Image API

Add prompt submission, task tracking and image retrieval to your application. Keep API keys on your server.

How to get a Muse Image API key and start building

Set up your key, prepare your brief and organize your results.

1

Get your Muse Image API key

Sign in to APIMart and create a key in API Keys. Keep the key on your server, outside browser code and public repositories.

2

Prepare a focused creative brief

Describe the intended result and its context. Keep the brief with your request so you can compare revisions.

3

Review and integrate the output

Check the output against your brief before using it. Keep your selected assets organized for the next stage of production.

Muse Image API examples and integration

Submit muse-image-ext to /v1/images/generations, save the task ID and query GET /v1/tasks/{task_id} for the result.

  1. 1

    Authenticate Muse Image API requests

    Store your API key on the server and send it as Authorization: Bearer <key>. Create one Idempotency-Key for each new generation operation.

  2. 2

    Submit a muse-image-ext task

    POST to /v1/images/generations with model and prompt. The default response provides data[0].task_id; preserve the same key and body when retrying an interrupted submission.

  3. 3

    Retrieve the Muse Image result

    Query GET /v1/tasks/{task_id} until completed or failed. Read data.result.images[0].url[0] on success, or data.error.message on failure; a local wait timeout is not task failure.

    See the Muse Image API reference for request and response details.

POST /v1/images/generations
IDEMPOTENCY_KEY="${IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.apimart.ai/v1/images/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
    "model": "muse-image-ext",
    "prompt": "A red ceramic cup on a white table, soft studio lighting, product photograph, no text",
    "n": 1,
    "aspect_ratio": "1:1"
  }'

Muse Image API parameters

ParameterTypeRequiredDefaultDescription
modelstringRequiredDefault: —Required model identifier: muse-image-ext.
promptstringRequiredDefault: —A nonempty text prompt after trimming whitespace; required with or without references. Chinese and English are supported.
image_urlsstring[]OptionalDefault: —Up to nine accessible image URLs, Data URIs or base64 strings; original images total at most 11 MiB. Omit when there are no references.
aspect_ratiostringOptionalDefault: —1:1, 16:9, 9:16, 4:3, 3:4, 3:2 or 2:3. For Auto, omit this field; do not send "auto". Without references the default is 1:1; with references it follows their aspect ratio.
nintegerOptionalDefault: 1Only the number 1 is supported. One request produces one result.
nsfw_checkbooleanOptionalDefault: falseEnable platform content screening before submission. Successful submission does not guarantee that every moderation check has passed.

Explore the Muse APIs

Choose the Muse page for the type of content your project needs.

Muse Video API

Muse Image API FAQ

What is Muse Image API?

Muse Image API supports text-to-image and reference-image generation through APIMart. The muse-image-ext model returns one WebP image per asynchronous task.

Which model ID does Muse Image API use?

Use muse-image-ext, including -ext, as the model value in your request.

How do I get a Muse Image API key?

Sign in to APIMart and create an API key in API Keys. Keep it on your server and send Authorization: Bearer <key> when submitting and querying tasks.

How many reference images does Muse Image support?

Use zero to nine reference images, with a combined original size of at most 11 MiB. Send them in image_urls as accessible URLs, Data URIs or base64; a prompt is required even with references.

Which aspect ratios does Muse Image API support?

Supported ratios are 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 and 2:3. Auto means omitting aspect_ratio: with references the composition follows them, while text-only requests default to 1:1.

Can I choose a Muse Image resolution or pixel size?

No. The model determines the dimensions, and the result is WebP. Do not send a resolution tier or a pixel size such as 1024x1024.

Can Muse Image API generate several images or use a mask?

Each request generates one image; n can only be the number 1. Masks and reference video or audio are not supported by this integration.

What if a Muse Image API task takes longer than the page wait?

Keep its task ID and query it again later. A browser timeout or stopped polling does not cancel the server task; do not create another generation request automatically.

How is Muse Image API pricing calculated?

Review the live pricing for your account before generating. Final task cost and your account statement determine the charge. Each request is billed per image.

Can I keep the results from Muse Image?

Download or archive the delivered files if you need to keep them. If expires_at is returned, save them before that time; an expired link should not trigger another paid generation automatically.