Muse Image

Muse Image でプロンプトまたは最大 9 枚の参照画像から、7 種類のアスペクト比で画像を生成。1 リクエストで画像 1 枚、画像単位の課金でタスクとして受け取れます。

Muse Image は Meta Superintelligence Labs の画像モデルです。1 回のリクエストで、プロンプトから、またはプロンプトと最大 9 枚の参照画像から、7 種類のアスペクト比のいずれかで画像を 1 枚生成します。リクエストを送信し、返されたタスク ID を保持して、完成した画像をタスクから読み取ってください。参照画像は URL で渡します。

モデル ID	入力	アスペクト比	リクエストあたりの画像数
`muse-image`	テキスト、画像 0–9 枚	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`	1

クイックサンプル

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

ヘッダー	値
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

レスポンスはタスク（{"id": "task_...", "status": "processing"}）であり、完成した画像ではありません。結果は GET /v1/tasks/{task_id} をポーリングして取得してください。API キーはサーバー側のコードで保持してください。参照画像は同じリクエストの image_urls で渡します。このモデルでは /v1/images/edits は使いません。

パラメータ

フィールド	型	デフォルト	説明
`model`	string	必須	`muse-image`
`prompt`	string	必須	前後の空白を除いた後に空であってはなりません。参照画像を使う場合も必須。
`image_urls`	URL リスト	なし	公開画像 URL を 0–9 件、合計 11 MB。指定しない場合はテキストから画像を生成。
`aspect_ratio`	enum	auto	`1:1`、`16:9`、`9:16`、`4:3`、`3:4`、`3:2` または `2:3`。省略すると自動となり、参照画像が形を決め、テキストのみでは `1:1` になります。`"auto"` は送信しないでください。
`size`	enum	なし	`aspect_ratio` の互換用別名。上記の比率または `auto`。`1024x1024` などのピクセル寸法は拒否されます。両方が有効な場合は `aspect_ratio` が優先されます。
`n`	integer	`1`	`1` のみ。各リクエストで画像を 1 枚返します。

この一覧にないフィールドはリクエスト転送前に削除され、エラーの原因にも出力の変更にもなりません。解像度、シード、ネガティブプロンプト、マスク、出力形式の設定はありません。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 は画像 1 枚あたりの定額料金です：

cost = price per image × 1

テキストのみのリクエスト、参照画像を使うリクエスト、すべてのアスペクト比で同じ料金です。タスク受理時に確保される金額がそのまま課金額になります。最終的な課金額はアカウントの利用履歴で確認できます。失敗したタスクは課金されません。

出力スキーマ

送信するとタスクが返されます:

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

タスクを取得する

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

status が completed または failed になるまで、10〜20 秒ごとにポーリングしてください。ポーリング中のネットワークタイムアウトは生成の失敗を意味しません。タスク 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 を加えてください。

モデル ID