Muse Image Text-to-Image

POST Base URL: https://api.hiapi.ai /v1/tasks

Image, video, and audio models are called through theUnified Async API POST /v1/tasks endpoint; only the input fields differ (see input parameters below).

Model summary

Model	muse-image-1.0/text-to-image
Type	Image generation
Endpoint	POST /v1/tasks
Pricing	Live pricing

Muse Image API creates illustrations and layouts for book covers, posters and content. Try online and explore images, live pricing and API guides.

Request parameters

POST https://api.hiapi.ai/v1/tasks

# Create an async task — returns taskId immediately (generation runs async)
# Replace YOUR_API_KEY with your account API key
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "muse-image-1.0/text-to-image",
  "input": {
    "prompt": "Premium skincare campaign photograph of a matte coral glass bottle with a cream label reading DAWN, a folded sandstone paper panel and a delicate olive branch on pale travertine, soft morning side light, restrained editorial styling, crisp material texture, generous cream negative space, no other text.",
    "aspect_ratio": "4:3",
    "output_format": "webp"
  }
}'

import requests, json

# Business params — fields vary by model (see the model page)
payload = json.loads(r'''
{
  "model": "muse-image-1.0/text-to-image",
  "input": {
    "prompt": "Premium skincare campaign photograph of a matte coral glass bottle with a cream label reading DAWN, a folded sandstone paper panel and a delicate olive branch on pale travertine, soft morning side light, restrained editorial styling, crisp material texture, generous cream negative space, no other text.",
    "aspect_ratio": "4:3",
    "output_format": "webp"
  }
}
''')

# Create an async task — returns taskId immediately (generation runs async)
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # Returns { code, message, data: { taskId } }

// Create an async task — returns taskId immediately (generation runs async)
// Replace YOUR_API_KEY with your account API key
const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "muse-image-1.0/text-to-image",
  "input": {
    "prompt": "Premium skincare campaign photograph of a matte coral glass bottle with a cream label reading DAWN, a folded sandstone paper panel and a delicate olive branch on pale travertine, soft morning side light, restrained editorial styling, crisp material texture, generous cream negative space, no other text.",
    "aspect_ratio": "4:3",
    "output_format": "webp"
  }
}),
});
console.log(await resp.json()); // Returns { code, message, data: { taskId } }

model string required

Use muse-image-1.0/text-to-image.

example muse-image-1.0/text-to-image

input object required

Image creation parameters.

prompt string required

Describe the scene or the changes and details to preserve, up to 5000 characters

aspect_ratio enum optional

Choose the output aspect ratio; omission lets the image content guide framing.

enum: 1:14:33:416:99:163:22:321:99:21

output_format enum optional

Choose the file format for downloaded images

default webp enum: jpegpngwebp

callback object optional

Receive a notification when the task completes or fails.

url string required

HTTPS address for task completion notifications.

example https://your-domain.com/hiapi/callback

when enum optional

Notify when the task reaches a final state.

default final enum: final

Example requests

Bring lettering, materials and light into a product visual

Arrange lettering, materials, light and whitespace around a product.

Request body

{
  "model": "muse-image-1.0/text-to-image",
  "input": {
    "prompt": "Premium skincare campaign photograph of a matte coral glass bottle with a cream label reading DAWN, a folded sandstone paper panel and a delicate olive branch on pale travertine, soft morning side light, restrained editorial styling, crisp material texture, generous cream negative space, no other text.",
    "aspect_ratio": "4:3",
    "output_format": "webp"
  }
}

Getting the result

Save data.taskId from the submission response.
Retrieve GET /v1/tasks/{taskId} until data.status is success or failed.
Read each image URL in data.output and save files you need before expireAt.

FAQ

How do I choose generation or editing?

Choose generation to start from a written brief, or editing with references to build on an existing subject or layout.

How many images can I get per task?

Each task returns one image with no count selector. Submit a new task with an adjusted prompt for another composition.

Can I select 1K, 2K or 4K?

This entry has no resolution tiers. Choose framing; the model determines dimensions, typically around 2.5MP. Inspect the downloaded file.

Which file formats can I choose?

Choose JPEG, PNG or WebP; the default is WebP. Select a format for your web or design workflow.

How can I leave room for a cover title?

Describe subject placement and which side needs whitespace, then choose framing for the final cover. Avoid relying entirely on a later crop.

What should a product brief start with?

Start with the subject, materials and placement, then add light, background and a few props. State short label text separately and inspect the silhouette and lettering.

How should I keep images long term?

Generated image links have an expiry date. Download files you need to keep, or select permanent storage when creating the task. Existing images can also be re-stored by following the storage management guide.

Can I continue editing a result?

Save the result and supply it as a reference in a new task. Tasks are independent, so describe what to retain and what this revision should change.

How can I make lettering easier to inspect?

Put a short heading in quotes and describe its position, hierarchy and surrounding space. Check the lettering before use and finish typography in a design tool if needed.

When should I leave framing automatic?

Use automatic framing when the placement is flexible. Choose a ratio for a fixed banner, portrait poster or square card, then check the downloaded dimensions.

Where can I check the cost before generating?

Choose your parameters and check the Playground estimate and live pricing. Task records show the completed image and its charge.

Why can the same brief produce a different picture?

Composition and details can vary between results. Use a selected picture as a reference and specify preservation requirements when continuity matters.