Claude Opus 5.5 已在 SeedRouter 上線
LogoSeedRouter

Image

MiniMax H3 Image

View Markdown

產生與編輯圖片，支援最多 16 張參考圖片、精確尺寸、1–10 張輸出，並依 token 計費。

快速範例

提交一個圖片請求，儲存回傳的 id，並輪詢直到任務狀態為 completed 或 failed。此 API 使用非同步任務，並以 URL 回傳輸出。

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"minimax-h3-image","prompt":"An amber bottle on pale limestone in soft morning light","area":"1K","aspect_ratio":"3:2"}'

端點與標頭

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

標頭值
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

將金鑰保存在伺服器端。HTTP 成功回應表示任務已被接收，並不代表圖片已準備就緒。

參數

共接受 13 個欄位。只有 model 和 prompt 為必填。省略選填欄位即可使用預設值；所有欄位均不接受 null。Playground 提供固定模型和十個可編輯的輸入項目。回應格式固定為 URL，任務交付固定為非串流。

欄位型別預設值限制
model字串必填minimax-h3-image
prompt字串必填去除前後空白後為 1–32,000 個 Unicode 字元
images物件陣列省略1–16 個依序排列的物件，每個物件均包含 image_url
disable_prompt_enhanced布林值false僅適用於產生圖片；請參閱下方的相依關係
n整數11–10
size字串autoauto 或 WIDTHxHEIGHT；使用小寫 x
aspect_ratio字串autoauto 或 X:Y；X 和 Y 為 1–300 的整數；比例為 1:3–3:1
area字串4K1K、2K、4K；近似目標面積為 1,024²、2,048²、4,096² 像素
output_format字串jpegjpeg、jpg 別名、png
output_compression整數950–100；JPEG 品質；PNG 會忽略此項
aigc_watermark布林值false加入 AI 產生內容浮水印
response_format字串url僅限 url
stream布林值false僅限 false；使用任務 ID 輪詢

尺寸與提示詞的相依關係

明確指定的 size 必須包含正整數尺寸，面積須介於 655,360 至 20,000,000 像素之間，包含邊界值。寬度除以高度須介於 1/3 至 3 之間。例如，2048x1152 是有效值。使用明確尺寸時，必須同時省略 aspect_ratio 和 area，即使其值為 auto 也不例外。

省略尺寸或將尺寸設為 auto 時，請搭配使用 aspect_ratio 和 area。面積是目標尺寸；請檢查交付的檔案以確認精確尺寸。它並不代表固定的單張圖片價格。

設定 disable_prompt_enhanced: true 時，必須提供明確的像素尺寸或固定長寬比。停用增強後，模型會讀取提示詞中大約前 4,096 個 token。32,000 個字元的提交上限仍然適用。編輯圖片時一律會增強提示詞，因此存在 images 時不接受 true。

不接受遮罩、種子、風格、品質、負面提示詞、背景或獨立的解析度欄位。未知參數會在提交前傳回錯誤。此 API 不提供串流、base64 圖片或 WebP 輸出。

參考圖片

請使用可公開存取且未內嵌憑證的 HTTP(S) URL。每張圖片必須為 JPEG、PNG、WebP、HEIC 或 HEIF 格式；大小不超過 64 MiB；每條邊為 128–8,192 像素；長邊與短邊之比不超過 4。JSON 本文須不超過 64 MiB。圖片檔案透過 URL 引用，其位元組內容不內嵌於 JSON 本文。

為每張參考圖片指定明確用途，並說明哪些內容應保持不變。陣列順序對應 <Picture 1>、<Picture 2>，依此類推。

{
  "model": "minimax-h3-image",
  "prompt": "Use <Picture 1> as the product and <Picture 2> as the setting. Preserve the product's shape and label. Match the setting's light and perspective.",
  "images": [
    {"image_url": "https://example.com/product.jpg"},
    {"image_url": "https://example.com/setting.jpg"}
  ],
  "aspect_ratio": "3:2",
  "area": "2K",
  "n": 1,
  "output_format": "png"
}

請將範例 URL 替換為你自己可存取的圖片檔案。

計費

計費包含三類 token：文字輸入、圖片輸入和圖片輸出。將各類別的實際用量乘以其即時費率。輸出數量、圖片尺寸與參考圖片會影響用量；解析度名稱並不決定固定帳單金額。失敗的請求不收費。請參閱即時價格。

任務回應與輪詢

被接收的請求會傳回一個非同步任務：

{"id":"task_example","model":"minimax-h3-image","status":"processing"}
curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

已完成的回應在 output.data 中包含圖片 URL。每張交付的圖片均包含其 size，並且可能包含 revised_prompt（增強後的描述）。output.created 是以 Unix 秒表示的建立時間，output.output_format 表示交付格式。output.usage 提供文字輸入、圖片輸入和圖片輸出的 token 數，以及已交付的 generated_images 數量。以下 URL 和 ID 僅為範例：

{
  "id": "task_example",
  "model": "minimax-h3-image",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.jpg"}]}
}

每隔 10–20 秒輪詢一次。用戶端逾時不代表任務失敗：請保留任務 ID 並繼續輪詢，不要提交重複請求。公開回應不包含帳戶餘額或費用。

錯誤

HTTP 錯誤使用 {"error":{"code":integer,"message":string}} 格式。失敗的任務包含 status: "failed" 和錯誤。再次提交前，請修正無效參數。請參閱共用錯誤目錄與任務生命週期。

相關頁面

MiniMax H3 Image Highspeed

Previous Page

Muse Image

Next Page

On this page

快速範例端點與標頭參數尺寸與提示詞的相依關係參考圖片計費任務回應與輪詢錯誤相關頁面