APIMart
图像

Muse Image API

使用 Muse Image API,通过提示词或最多九张参考图生成图片。选择支持的画面比例,或跟随参考图比例,再通过任务接口获取一张 WebP 图片。

图像生成

服务亮点

  • 官方折扣
  • 按量计费
  • 高速低延
Input
参考图像

可选,最多 9 张参考图,原始大小合计不超过 11 MiB。自动比例跟随参考图比例。

输出

暂无生成记录。

Muse Image API 价格

透明定价,无隐藏费用。按量付费,用多少付多少。

型号黄金价当前价格铂金价钻石价官方价为你节省
muse-image-ext0.048Credits(~$0.0048)/张0.0456Credits(~$0.0046)/张0.0432Credits(~$0.0043)/张0.1Credits(~$0.01)/张52%

* 实际费用以最终输出为准。

使用 Muse Image API 开始创作

使用 Muse Image API,通过提示词或最多九张参考图生成图片。选择支持的画面比例,或跟随参考图比例,再通过任务接口获取一张 WebP 图片。

Muse Image API 支持的功能

了解生成模式、输入要求和输出规格,规划应用接入。

使用 Muse Image API 文生图

在非空提示词中描述主体、场景、构图和光线。不附带参考图时,使用文生图模式。

为 Muse Image API 提供参考图

提示词可搭配最多九张图片,支持 URL、Data URI 和 base64;原始图片合计不能超过 11 MiB。

Muse Image 的七种画面比例

支持 1:1、16:9、9:16、4:3、3:4、3:2 和 2:3。选择自动时省略 aspect_ratio,让带参考图的请求跟随参考图比例。

Muse Image Model 输出单张 WebP

每个请求生成一张图片。输出尺寸由模型决定,不能选择像素尺寸或清晰度档位。

使用 muse-image-ext 调用模型

向 /v1/images/generations 发送完整型号 muse-image-ext,发起生成任务。

Muse Image API 异步任务

提交一次并保存任务 ID,再查询状态。提交中断后重试时,复用同一幂等键和请求体。

Muse Image API 实时价格

生成前查看当前账户的实时价格,最终费用以任务 cost 和账户账单为准。 每个请求按张计费。

获取并保存 Muse Image 结果

任务状态为 completed 后读取结果地址。如果响应提供 expires_at,请在对应时间前下载或归档。

Muse Image API 使用场景

围绕目标内容准备简报,并对照需求审核生成结果。

使用 Muse Image API 构建商品场景

描述商品环境、光线和构图,按需添加参考图,发布前检查商品细节。

使用 Muse Image 探索活动创意

通过主体、色彩和视觉风格探索活动方向,并对照创意简报审核图片。

使用 Muse Image API 制作文章配图

将文章主题转化为视觉简报,明确画面焦点,并为排版工具添加文字预留空间。

使用 muse-image-ext 开展参考图设计

结合文字简报与参考图描述目标场景,检查输出是否符合关键设计细节。

使用 Muse Image 制作社交素材

根据投放位置选择竖版、方形或横版画面,并在发布流程中调整最终素材。

使用 Muse Image API 构建图像工具

将提示词提交、任务跟踪和图片获取整合到应用中,并在服务端保存 API Key。

如何获取 Muse Image API Key 并开始接入

创建密钥、准备简报,并整理你的创作结果。

1

获取 Muse Image API Key

登录 APIMart,在 API Keys 中创建密钥。将密钥保存在服务端,不要放入浏览器代码或公开仓库。

2

准备清晰的创意简报

描述预期结果及其使用背景。将简报与请求一起保存,方便比较不同版本。

3

审核并整合生成结果

使用前对照简报检查结果。整理选定素材,方便进入下一阶段制作。

Muse Image API 调用示例与接入

向 /v1/images/generations 提交 muse-image-ext,保存任务 ID,再通过 GET /v1/tasks/{task_id} 查询结果。

  1. 1

    为 Muse Image API 请求鉴权

    在服务端保存 API Key,并发送 Authorization: Bearer <key>;每次新的生成操作创建一个 Idempotency-Key。

  2. 2

    提交 muse-image-ext 任务

    向 /v1/images/generations POST model 与 prompt,默认从 data[0].task_id 获取任务 ID;提交中断后重试须保留原键与请求体。

  3. 3

    获取 Muse Image 结果

    通过 GET /v1/tasks/{task_id} 查询至 completed 或 failed;成功读取 data.result.images[0].url[0],失败读取 data.error.message,本地等待超时不等于任务失败。

    完整请求和响应说明见Muse Image API 文档。

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": "一只红色陶瓷杯放在白色桌面上,柔和棚拍灯光,产品摄影,无文字",
    "n": 1,
    "aspect_ratio": "1:1"
  }'

Muse Image API 参数说明

参数类型必填默认值说明
modelstring必填默认值: —必填的模型标识:muse-image-ext。
promptstring必填默认值: —去除首尾空白后不能为空,支持中英文;有无参考图都必须提供。
image_urlsstring[]可选默认值: —最多九个可访问图片 URL、Data URI 或 base64 字符串,原始图片合计不超过 11 MiB;无参考图时省略。
aspect_ratiostring可选默认值: —支持 1:1、16:9、9:16、4:3、3:4、3:2、2:3。自动时省略该字段,不发送 "auto";无图默认 1:1,有图跟随参考图比例。
ninteger可选默认值: 1只支持数值 1,每个请求返回一个结果。
nsfw_checkboolean可选默认值: false启用平台提交前内容审核;成功提交不代表已保证通过所有审核。

探索 Muse API

根据项目所需的内容类型,选择对应的 Muse 页面。

Muse Video API

Muse Image API 常见问题

什么是 Muse Image API?

Muse Image API 通过 APIMart 提供文生图与参考图生图。muse-image-ext 每个异步任务返回一张 WebP 图片。

Muse Image API 使用哪个模型 ID?

请求的 model 字段填写完整的 muse-image-ext,包括 -ext 后缀。

如何获取 Muse Image API Key?

登录 APIMart,在 API Keys 创建密钥,将其保存在服务端。提交和查询任务时均使用 Authorization: Bearer <key>。

Muse Image 支持多少张参考图?

支持零至九张参考图,原始大小合计不超过 11 MiB。通过 image_urls 发送可访问 URL、Data URI 或 base64;有参考图也必须填写提示词。

Muse Image API 支持哪些比例?

支持 1:1、16:9、9:16、4:3、3:4、3:2、2:3。自动表示省略 aspect_ratio:有图时跟随参考图比例,纯文字请求默认 1:1。

能否选择 Muse Image 清晰度或像素尺寸?

不能。尺寸由模型决定,结果为 WebP;不要发送清晰度档位或 1024x1024 这类像素尺寸。

Muse Image API 能批量出图或使用遮罩吗?

每个请求只生成一张图片,n 只能是数值 1。本次接入不支持遮罩、参考视频或参考音频。

Muse Image API 任务超过页面等待时间怎么办?

保留任务 ID,稍后继续查询。浏览器超时或停止轮询不代表服务端任务取消,不要自动新建生成请求。

Muse Image API 如何计费?

生成前查看当前账户的实时价格,最终费用以任务 cost 和账户账单为准。 每个请求按张计费。

可以保存 Muse Image 的生成结果吗?

可以下载或归档生成文件。响应提供 expires_at 时,请在对应时间前保存;链接失效不应自动触发新的付费生成。