Muse Image Image-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/image-to-image
Type	Image editing
Endpoint	POST /v1/tasks
Pricing	Live pricing

Muse Image API edits subjects, colors and layouts from references for covers and posters. Try online and see image comparisons, 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/image-to-image",
  "input": {
    "prompt": "Transform the reference illustration into a nocturnal travel poster artwork. Preserve the terracotta observatory dome, geometric building forms and winding river. Change the sky to deep indigo with a silver crescent moon and a few tiny stars, illuminate the windows with soft warm amber light, make the river glow turquoise, retain the tactile paper grain and clear architectural silhouette, no text.",
    "image_urls": [
      "https://static.hiapi.ai/model-onboarding/flux-muse-20261014/49470f4787401b4f-muse-ratio-4-3-display.webp"
    ],
    "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/image-to-image",
  "input": {
    "prompt": "Transform the reference illustration into a nocturnal travel poster artwork. Preserve the terracotta observatory dome, geometric building forms and winding river. Change the sky to deep indigo with a silver crescent moon and a few tiny stars, illuminate the windows with soft warm amber light, make the river glow turquoise, retain the tactile paper grain and clear architectural silhouette, no text.",
    "image_urls": [
      "https://static.hiapi.ai/model-onboarding/flux-muse-20261014/49470f4787401b4f-muse-ratio-4-3-display.webp"
    ],
    "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/image-to-image",
  "input": {
    "prompt": "Transform the reference illustration into a nocturnal travel poster artwork. Preserve the terracotta observatory dome, geometric building forms and winding river. Change the sky to deep indigo with a silver crescent moon and a few tiny stars, illuminate the windows with soft warm amber light, make the river glow turquoise, retain the tactile paper grain and clear architectural silhouette, no text.",
    "image_urls": [
      "https://static.hiapi.ai/model-onboarding/flux-muse-20261014/49470f4787401b4f-muse-ratio-4-3-display.webp"
    ],
    "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/image-to-image.

example muse-image-1.0/image-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

image_urls string[] required

Provide 1–10 public HTTP(S) image URLs and assign each role in the prompt.

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

Change time of day and light around a landmark

Use a daytime architectural reference to change the sky, windows and river into a night scene.

Request body

{
  "model": "muse-image-1.0/image-to-image",
  "input": {
    "prompt": "Transform the reference illustration into a nocturnal travel poster artwork. Preserve the terracotta observatory dome, geometric building forms and winding river. Change the sky to deep indigo with a silver crescent moon and a few tiny stars, illuminate the windows with soft warm amber light, make the river glow turquoise, retain the tactile paper grain and clear architectural silhouette, no text.",
    "image_urls": [
      "https://static.hiapi.ai/model-onboarding/flux-muse-20261014/49470f4787401b4f-muse-ratio-4-3-display.webp"
    ],
    "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

Are references required?

Provide 1–10 references. Choose text-to-image to start without an existing picture.

How many edited images are returned?

Each task returns one edited image with no count selector. Submit separate tasks for different revisions.

How do I preserve a subject while changing its setting?

List the recognizable subject cues to retain, then describe the new setting, light and placement. Inspect scale, occlusion and edges.

Will every reference appear in the result?

No. References can guide the subject, layout, palette or style. Assign their roles and specify what should stay out.

How can I replace old lettering?

Specify old wording to remove and new text to include, then describe placement, hierarchy and whitespace. Check the text and layout before use.

How should I choose framing and file format?

Choose landscape, portrait or square framing for the placement, then JPEG, PNG or WebP. There are no resolution tiers; inspect the generated dimensions.

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.