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 金鑰保存在伺服器端程式碼中。參考圖透過 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 秒。

錯誤

在任務建立之前就被拒絕的請求，會回傳 HTTP 錯誤狀態碼和一個 error 物件，且不收費。受理之後才失敗的任務，在查詢時回傳 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