Muse Image Text-to-Image
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型名称 | muse-image-1.0/text-to-image |
|---|---|
| 类型 | 图片生成 |
| 接口 | POST /v1/tasks |
| 价格 | 实时价格 |
使用 Muse Image API 将场景描述转成插画与版式图片，适合图书封面、活动海报和内容配图。在线试用不同构图，查看作品细节、输出选择、实时价格与异步 API 接入示例，按创作目标准备图片素材。
请求参数
model string 必填 固定填写 muse-image-1.0/text-to-image。
input object 必填 图片创作参数。
prompt string 必填 描述画面，或写清参考图中要修改与保留的内容，最多 5000 字符
aspect_ratio enum 可选 选择输出图片的宽高比；省略时由画面内容确定构图。
output_format enum 可选 选择下载图片的文件格式
callback object 可选 任务完成或失败时接收通知的配置。
url string 必填 接收任务终态通知的 HTTPS 地址。
when enum 可选 在任务进入终态时通知。
用例示例
围绕商品陈列组织标签、材质、光线与留白。
{
"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"
}
}获取结果
- 保存提交响应 data.taskId。
- 使用 GET /v1/tasks/{taskId} 查询任务，直到 data.status 为 success 或 failed。
- 成功后读取 data.output 中每张图片的 URL；在 expireAt 前保存需要长期使用的文件。
常见问题
文生图与改图怎么选？
只有文字、从零开始时选择文生图；需要沿用已有主体或版式时，选择改图并提供参考图片。
每次可以得到多少张图片？
每次任务返回一张图片，没有张数选择。需要比较另一种构图时，调整提示词并提交新任务。
可以选择 1K、2K 或 4K 吗？
这个入口不提供分辨率档位。画幅由你选择，像素尺寸由模型决定，通常约 2.5MP；请以下载文件的实际尺寸为准。
可以选择哪些文件格式？
可以选择 JPEG、PNG 或 WebP，未选择时使用 WebP。根据后续网页素材或设计工具的需要选择。
怎样为封面预留标题空间？
在描述里说明主角的位置与需要留白的一侧，再选适合最终版位的画幅。不要只依赖生成后裁切来挪出标题位置。
商品图片应该先描述什么？
先写主体、材质和摆放位置，再补光线、背景与少量道具。标签上的短文字应单独写清，完成后检查产品轮廓和排版。
怎样保存需要长期使用的图片？
生成的图片链接有有效期。需要长期使用时，请及时下载保存，或在创建任务时选择永久存储。已经生成的图片也可以按存储管理页面的说明转存。
可以在生成后继续修改吗？
可以下载并保存结果，再把它作为新任务的参考图。每次任务独立处理，请重新说明要保留的内容和这一步要改变的部分。
怎样让图片里的标题更容易检查？
用引号写清短标题，说明主标题和副标题的位置、大小关系与留白。使用前逐字核对，必要时在设计工具中完成最终排版。
自动画幅适合什么情况？
不需要固定版位时可以使用自动画幅。已经确定横幅、竖版海报或方形卡片时，明确选择比例，并检查下载图片的实际宽高。
生成前在哪里查看费用？
选择参数后查看 Playground 的预估费用和实时价格。完成后可在任务记录中查看生成结果与对应消费。
为什么同一描述不一定得到同一张图？
生成结果可能在构图和细节上变化。需要沿用一个已经选定的主体或版式时，用结果图片作为参考，并明确列出保留要求。