Midjourney 生圖 API

Essevin 上的 Midjourney 是非同步介面：先提交任務，再輪詢 Essevin 任務 ID。請使用 Midjourney 分組的金鑰，正式發付費請求前先用 GET /v1/models 確認完整模型 ID。

介面

所有請求使用 Authorization: Bearer sk-你的金鑰 和 Content-Type: application/json。模型 ID 是 midjourney-v8-2。

請求契約

curl https://api.essevin.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的金鑰" \
  -H "Content-Type: application/json" \
  -d '{"model":"midjourney-v8-2","prompt":"a red apple on a wooden table, studio light --ar 16:9"}'

尺寸與畫幅

圖片尺寸不是請求欄位，而是由提示詞裡的 --ar 決定；--hd 會原生出約兩倍邊長的圖。下表是實測尺寸，不是推算出來的——--hd 並不是精確的兩倍。

--ar 只接受整數比例，--ar 1.5:1 會被拒絕。比例在兩個方向上都不能超過 14:1，而且 --hd 會把這個上限壓到 4:1，所以 --hd --ar 14:1 會被拒絕，--hd --ar 4:1 則會出 4096 × 1184。

提示詞參數

以下參數會被接受並原樣傳遞：

這個模型版本不接受的參數

以下參數會在提交時直接回傳 400，錯誤訊息裡會寫明原因。之所以擋下而不是照樣轉發，是因為官方要嘛靜默忽略它們——讓你為一個根本沒拿到的效果付錢——要嘛在數分鐘後才讓任務失敗。

提交與輪詢

提交成功回傳 202，任務 ID 在 id 欄位，另外還帶 images_per_task。輪詢方式與其他非同步媒體任務相同，查詢時不要傳計費標頭：

  -H "Authorization: Bearer sk-你的金鑰"

status 依序經過 queued → processing → completed 或 failed，只有後兩者是終態，其他任何值都按進行中處理。完成的任務會在 outputs 裡帶四個輸出位址，位址在 console.essevin.com 網域下，是自任務完成起 6 小時有效的簽名連結；再次查詢會回傳同一位址、不會延長，過期存取回傳 410，請在 6 小時內下載保存。只有成功完成的任務才計費，失敗的任務不計費。

失敗情形

價格

Midjourney 按回傳張數計費，因此一個任務就是四張圖乘上該檔位的單價：預設出圖與 --hd 的 2K 出圖分屬兩個價格檔。官方牌價見價格頁。你的實際單價以登入後的模型廣場為準，每次請求的實際扣費見用量記錄。