Muse Image Image-to-Image
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型名称 | muse-image-1.0/image-to-image |
|---|---|
| 类型 | 图片编辑 |
| 接口 | POST /v1/tasks |
| 价格 | 实时价格 |
使用 Muse Image API 围绕已有图片调整主体、配色与版式，适合封面改稿、海报设计和素材组合。在线试用参考图编辑，查看输入与输出对照、作品细节、实时价格及异步 API 接入示例。
请求参数
model string 必填 固定填写 muse-image-1.0/image-to-image。
input object 必填 图片创作参数。
prompt string 必填 描述画面，或写清参考图中要修改与保留的内容，最多 5000 字符
image_urls string[] 必填 提供 1–10 张公开 HTTP(S) 图片 URL，在提示词中说明各张图片的作用。
aspect_ratio enum 可选 选择输出图片的宽高比；省略时由画面内容确定构图。
output_format enum 可选 选择下载图片的文件格式
callback object 可选 任务完成或失败时接收通知的配置。
url string 必填 接收任务终态通知的 HTTPS 地址。
when enum 可选 在任务进入终态时通知。
用例示例
以日间建筑为参考，将天空、窗光与河流变成夜景。
{
"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"
}
}获取结果
- 保存提交响应 data.taskId。
- 使用 GET /v1/tasks/{taskId} 查询任务，直到 data.status 为 success 或 failed。
- 成功后读取 data.output 中每张图片的 URL；在 expireAt 前保存需要长期使用的文件。
常见问题
必须提供参考图吗？
需要提供 1–10 张参考图。没有现成图片、只想从文字开始时，请选择文生图入口。
每次会返回几张编辑结果？
每次任务返回一张编辑结果，没有张数选择。若需要比较不同修改方向，请分别提交任务。
怎样同时保留主体并改变背景？
明确列出主体必须沿用的识别要素，再单独描述新环境、光线和摆放位置。完成后检查尺度、遮挡和边缘。
多张图一定都会出现在结果中吗？
不一定。参考图可以分别提供主体、版式、配色或风格。请说明各自作用，以及不希望带入的内容。
如何替换图片里的旧文字？
写清要移除的旧文字与需要出现的新内容，再说明标题位置、大小关系和留白。使用前逐字核对并检查版式。
怎样选择画幅与文件格式？
先按最终版位选择横图、竖图或方图，再选择 JPEG、PNG 或 WebP。没有分辨率档位，宽高以生成文件为准。
怎样保存需要长期使用的图片？
生成的图片链接有有效期。需要长期使用时，请及时下载保存，或在创建任务时选择永久存储。已经生成的图片也可以按存储管理页面的说明转存。
可以在生成后继续修改吗？
可以下载并保存结果，再把它作为新任务的参考图。每次任务独立处理，请重新说明要保留的内容和这一步要改变的部分。
怎样让图片里的标题更容易检查？
用引号写清短标题，说明主标题和副标题的位置、大小关系与留白。使用前逐字核对，必要时在设计工具中完成最终排版。
自动画幅适合什么情况？
不需要固定版位时可以使用自动画幅。已经确定横幅、竖版海报或方形卡片时，明确选择比例，并检查下载图片的实际宽高。
生成前在哪里查看费用？
选择参数后查看 Playground 的预估费用和实时价格。完成后可在任务记录中查看生成结果与对应消费。
为什么同一描述不一定得到同一张图？
生成结果可能在构图和细节上变化。需要沿用一个已经选定的主体或版式时，用结果图片作为参考，并明确列出保留要求。