Muse Image

Muse Image 是 Meta Superintelligence Labs 的图像模型。每次请求根据提示词，或提示词加最多 9 张参考图，生成一张图片，可选七种宽高比。发送请求后，保留返回的任务 ID，再从任务中读取完成的图片。参考图以 URL 形式传入。

模型 ID

当前价格见模型页面。

快速示例

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-image",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "aspect_ratio": "1:1"
  }'

端点

POST https://api.seedrouter.ai/v1/images/generations

响应返回的是任务（{"id": "task_...", "status": "processing"}），而非完成的图片。轮询 GET /v1/tasks/{task_id} 获取结果。请将 API Key 保存在服务端代码中。参考图通过 image_urls 随同一次请求传入；此模型不使用 /v1/images/edits。

参数

此列表之外的字段会在转发请求前被丢弃，不会导致错误，也不会改变输出。不提供分辨率、种子、负面提示词、遮罩或输出格式设置。不支持 callback_url，请改为轮询任务。

参考图

通过 image_urls 传入最多 9 张图片，并在 prompt 中说明需要保留和修改的内容。Muse Image 将其作为生成新图片的参考；省略 aspect_ratio 时，结果沿用参考图的画幅。

{
  "model": "muse-image",
  "prompt": "Keep this exact jacket; show it folded in a flat lay of hiking gear on pine boards, soft morning light.",
  "image_urls": ["https://example.com/jacket.png"],
  "aspect_ratio": "9:16"
}

媒体输入

每张参考图均使用公开的 HTTP(S) URL。不接受 Base64 data URI：请将文件上传到自己的存储空间，并传入其 URL。使用 PNG、JPEG 或 WebP 图片；所有参考图的原始文件总大小不得超过 11 MB。超过此限制的任务会在受理后失败，不收费。

计费维度

当前费率见模型价格区块。Muse Image 按张统一定价：

cost = price per image × 1

纯文本请求、参考图请求以及所有宽高比的价格相同。任务受理时预留的金额即为扣费金额。最终费用可在账户用量记录中查看。失败的任务不收费。

输出结构

提交后返回任务：

{"id": "task_...", "model": "muse-image", "status": "processing", "created_at": 1789689600}

查询任务

GET https://api.seedrouter.ai/v1/tasks/{task_id}

每隔 10–20 秒轮询一次，直到 status 为 completed 或 failed。轮询时发生网络超时并不表示生成失败：保留任务 ID，继续查询。不要为了查看进度而创建新任务。

已完成的任务

{
  "id": "task_...",
  "model": "muse-image",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689680,
  "output": {
    "created": 0,
    "data": [
      { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.webp" }
    ]
  }
}

图片以模型原生的 WebP 格式交付，不提供输出格式设置。像素尺寸由模型决定。我们的测试中，纯文本请求返回 1600 × 1600，16:9 返回 2048 × 1152，3:4 返回 1344 × 1792，9:16 返回 1152 × 2048，提交后约 50–180 秒完成。

错误

任务创建前被拒绝的请求会返回带有 error 对象的 HTTP 错误，不收费。任务受理后若失败，查询时仍返回 HTTP 200，并包含 status: "failed" 和 error 对象。

错误码、HTTP 状态及重试建议见公共错误目录。

{
  "id": "task_...",
  "model": "muse-image",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

如果提交本身超时，请先查询任务，再决定是否重新提交：第一次请求可能已经受理。

使用提示

• 明确主体、场景、光线和构图；Muse Image 能紧密遵循具体描述。
• 使用参考图时，明确说明必须保持不变的内容，例如产品颜色或形状。
• 省略 aspect_ratio 可沿用参考图画幅；指定该字段可裁切为适合发布渠道的比例。
• 加入 no text, no logos，避免生成虚构文字或标识。

相关内容

• Muse Image Playground 与价格
• Muse Video API 参考
• 下载 OpenAPI
• 可复制的 Markdown