Midjourney v8.2 / Niji 7 圖片生成

使用位於 https://apimaster.ai/v1 的非同步圖片 API，並搭配 midjourney-v8.2 或 midjourney-niji-7。模型 ID 會決定版本；請勿新增版本覆寫欄位。

建立任務

POST https://apimaster.ai/v1/midjourney/generations

curl -s "https://apimaster.ai/v1/midjourney/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "midjourney-v8.2",
    "prompt": "a quiet Japanese garden at dawn, cinematic composition",
    "size": "16:9",
    "speed": "relax"
  }'

若使用 Niji 7，請將 model 設為 midjourney-niji-7：

{"model":"midjourney-niji-7","prompt":"anime character under cherry blossoms","size":"9:16","speed":"fast"}

欄位	類型	必填	說明
model	字串	是	midjourney-v8.2 或 midjourney-niji-7
prompt	字串	是	圖片描述，可包含支援的 Midjourney 參數
size	字串	否	長寬比，例如 1:1 或 16:9；預設為 1:1
speed	字串	否	relax、fast 或 turbo；預設為 relax
image_urls	字串陣列	否	1–20 個參考圖片 URL；也接受支援的圖片 Data URL
iw	數字	否	參考圖片權重 0–3；需要 image_urls
quality	字串	否	0.25、0.5、1 或 2；Niji 7 不支援
stylize / chaos / weird	整數	否	範圍分別為 0–1000、0–100 與 0–3000
seed	整數	否	隨機種子 0–4294967295
negative_prompt	字串	否	要排除的內容
sref / sw	字串 / 整數	否	公開風格參考 URL 與權重 0–1000；sw 需要 sref
dref / dw	字串或字串陣列 / 數字	否	參考 URL（最多 20 個）與權重 0–100；dw 需要 dref
raw / tile / hd	布林值	否	原始風格、拼貼與 HD；tile 與 hd 僅限 v8.2
extra	字串	否	支援的參數字串，例如 --ar 16:9 --s 750；結構化欄位優先
metadata	物件	否	自訂業務中繼資料
repeat	整數	否	2–40，用於建立多個任務

Niji 7 不支援 quality、tile=true 或 hd=true。兩個模型都會拒絕 draft=true、cref、cw、stop，以及請求欄位 version 與 niji。style=raw 會正規化為 raw=true。請勿在 prompt 或 extra 中使用 --v 或 --niji 來覆寫模型版本。

回應會包含批次 ID 與任務 ID：

{
  "id": "imagine_batch_xxxxxxxx",
  "request_id": "req_xxxxxxxx",
  "model": "midjourney-v8.2",
  "status": "queued",
  "data": [{"id": "imagine_xxxxxxxx", "task_id": "imagine_xxxxxxxx", "status": "submitted"}]
}

檢查任務狀態

curl -s "https://apimaster.ai/v1/tasks/imagine_batch_xxxxxxxx" \
  -H "Authorization: Bearer YOUR_API_KEY"

完成的回應會在 data 中包含圖片 URL；tasks 會包含每個子任務：

{
  "id": "imagine_batch_xxxxxxxx",
  "status": "completed",
  "progress": 100,
  "data": [{"url": "https://example.com/generated.png"}],
  "tasks": [{"task_id": "imagine_xxxxxxxx", "status": "completed", "progress": 100, "data": [{"url": "https://example.com/generated.png"}]}]
}

當狀態為 queued 或 processing 時持續輪詢。若失敗，請讀取 tasks[].error，且不要重新提交相同請求。請儘速下載回傳的 URL，因為它們可能會過期。

若提交時傳回帶有 X-Task-ID 標頭的 502，或查詢傳回 pending_timeout，請儲存該 ID 並持續檢查其狀態，而不要自動再次提交。批次中可能同時包含成功與失敗的任務；請個別檢查 tasks[]。建議每 15 秒輪詢一次。

錯誤與定價

model 與非空的 prompt 為必填。不支援的版本、無效的比例、無法存取的參考，以及不支援的參數會傳回 400。401 表示金鑰無效，402 表示餘額不足，429 表示受到速率限制。請參閱 Midjourney v8.2 卡片 與 Niji 7 卡片，以取得最新定價與路由。