English

Midjourney V8.2 API

Find Midjourney V8.2 model IDs, request examples, and current availability on ModelPort.

Model details and pricing

Call GET /v1/models with your key and check available before submitting.

Request parameters

ParameterAccepted valuesDefault
resolution1K1K
aspect_ratio1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:31:1
n44

Optional parameters

ParameterAccepted valuesRequired input
seed0 to 4294967295—
stylize0 to 1000—
chaos0 to 100—
weird0 to 3000—
rawtrue or false—
tiletrue or false—
negative_promptUp to 500 characters—
style_referenceText—
style_weight0 to 1000style_reference
image_weight0 to 3Reference images

Send one to four space-separated numeric style codes in style_reference. Each job returns four candidate images. Use parameters in the jobs API or send these fields at the top level of the compatible image request.

Reference files

Input modeRoles and allowed counts
imagereference_image (1–4)
Upload reference files

Quote and submit

Set MODELPORT_API_KEY. The cURL example uses Bash and jq, Python uses its standard library, and Node.js uses a .mjs file. These examples submit a job after retrieving a quote.

cURL (Bash)

cURL (Bash)

set -eu
: "${MODELPORT_API_KEY:?Set MODELPORT_API_KEY}"
base='https://api.apimodel.store'
request='{"model":"midjourney-v8.2","prompt":"A ceramic cup in soft morning light.","parameters":{"resolution":"1K","aspect_ratio":"1:1","n":4}}'
request_id=${MODELPORT_REQUEST_ID:-modelport-example-$(date +%s)-$$}

quote=$(curl --fail-with-body --max-time 45 -sS 'https://api.apimodel.store/v1/quotes' \
  -H "Authorization: Bearer $MODELPORT_API_KEY" \
  -H "Content-Type: application/json" --data "$request")
quoted_cap=$(printf '%s' "$quote" | jq -er '.billing_price_usd | strings')
cap=${MODELPORT_MAX_PRICE_USD:-$quoted_cap}
printf 'Request ID: %s, maximum charge: %s USD\n' "$request_id" "$cap" >&2
payload=$(printf '%s' "$request" | jq -ce --arg cap "$cap" '. + {max_price_usd: $cap}')

job=$(curl --fail-with-body --max-time 45 -sS "$base/v1/jobs" \
  -H "Authorization: Bearer $MODELPORT_API_KEY" -H "Idempotency-Key: $request_id" \
  -H "Content-Type: application/json" --data "$payload")
job_id=$(printf '%s' "$job" | jq -er '.id | strings')
printf 'Job ID: %s\n' "$job_id" >&2

attempt=0
while [ "$attempt" -lt 90 ]; do
  status=$(printf '%s' "$job" | jq -er '.status')
  case "$status" in succeeded|failed) break ;; esac
  sleep 2
  job=$(curl --fail-with-body --max-time 45 -sS "$base/v1/jobs/$job_id" -H "Authorization: Bearer $MODELPORT_API_KEY")
  attempt=$((attempt + 1))
done
printf '%s\n' "$job"
Python

Python

import json
import os
import time
import uuid
from urllib.request import Request, urlopen

BASE = "https://api.apimodel.store"
KEY = os.environ["MODELPORT_API_KEY"]
request_id = os.getenv("MODELPORT_REQUEST_ID") or str(uuid.uuid4())
payload = json.loads("{\"model\":\"midjourney-v8.2\",\"prompt\":\"A ceramic cup in soft morning light.\",\"parameters\":{\"resolution\":\"1K\",\"aspect_ratio\":\"1:1\",\"n\":4}}")

def api(path, data=None, request_key=None):
    headers = {"Authorization": f"Bearer {KEY}"}
    if data is not None:
        headers["Content-Type"] = "application/json"
    if request_key:
        headers["Idempotency-Key"] = request_key
    body = json.dumps(data).encode("utf-8") if data is not None else None
    with urlopen(Request(BASE + path, data=body, headers=headers), timeout=45) as response:
        return json.load(response)

quote = api("/v1/quotes", payload)
cap = os.getenv("MODELPORT_MAX_PRICE_USD") or quote["billing_price_usd"]
print(f"Request ID: {request_id}, maximum charge: {cap} USD", flush=True)
job = api("/v1/jobs", {**payload, "max_price_usd": cap}, request_id)
job_id = job["id"]
print("Job ID:", job_id, flush=True)
for _ in range(90):
    if job["status"] in ("succeeded", "failed"):
        break
    time.sleep(2)
    job = api(f"/v1/jobs/{job_id}")
print(json.dumps(job, indent=2, ensure_ascii=False))
Node.js

Node.js

import { randomUUID } from "node:crypto";
import { setTimeout as sleep } from "node:timers/promises";

const base = "https://api.apimodel.store";
const key = process.env.MODELPORT_API_KEY;
if (!key) throw new Error("Set MODELPORT_API_KEY");
const requestId = process.env.MODELPORT_REQUEST_ID || randomUUID();
const payload = {
  "model": "midjourney-v8.2",
  "prompt": "A ceramic cup in soft morning light.",
  "parameters": {
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "n": 4
  }
};

async function api(path, data, requestKey) {
  const headers = { Authorization: `Bearer ${key}` };
  if (data) headers["Content-Type"] = "application/json";
  if (requestKey) headers["Idempotency-Key"] = requestKey;
  const response = await fetch(base + path, {
    method: data ? "POST" : "GET", headers,
    body: data && JSON.stringify(data), signal: AbortSignal.timeout(45_000),
  });
  if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
  return response.json();
}

const quote = await api("/v1/quotes", payload);
const cap = process.env.MODELPORT_MAX_PRICE_USD || quote.billing_price_usd;
console.log(`Request ID: ${requestId}, maximum charge: ${cap} USD`);
let job = await api("/v1/jobs", { ...payload, max_price_usd: cap }, requestId);
const jobId = job.id;
console.log("Job ID:", jobId);
for (let attempt = 0; attempt < 90 && !["succeeded", "failed"].includes(job.status); attempt++) {
  await sleep(2_000);
  job = await api(`/v1/jobs/${jobId}`);
}
console.log(JSON.stringify(job, null, 2));

To retry the same submission, keep the payload and set MODELPORT_REQUEST_ID and MODELPORT_MAX_PRICE_USD to the values printed on the first run.

Use the quote to set max_price_usd on the same request to POST /v1/jobs.

Submit and poll a job