Docs
All model guides

Midjourney

Midjourney

midjourney

A distinctive look. One route for prompts, optional references, and size or --ar.

Text-to-imageImage-to-imageImage editUpscale
WorkbenchGenerate with Midjourney
Sign in to generate · 5 Credits

Credits are reserved before generation and released automatically if it fails.

Output

Completed images appear here after a successful Credit debit.

Midjourney

Midjourney prices

Official Midjourney has no per-image API list. The official column converts extra Fast GPU at $4/hour.

Midjourney
From$0.055 Credits

Official Fast extra time is $4/hour. Versus that conversion: Imagine 6% below, Edits & fast 10% below, Turbo 7% below. Upload has no official per-image price.

SpecOur priceOfficialSaving
Imagine$0.055 Credits$0.0536%
Edits & fast$0.066 Credits$0.06710%
Turbo$0.1010 Credits$0.1077%
Upload$0.0454.5 Credits——
API

Call Midjourney

ImgRouter uses one request contract. Send this model ID to POST /v1/images/generations. Examples below match the recommended defaults on this page.

POST/v1/images/generations
cURL
curl https://api.imgrouter.com/v1/images/generations \
  -H "Authorization: Bearer $IMGROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: midjourney-generate-001" \
  -d '{
  "model": "midjourney",
  "prompt": "A cozy coffee shop interior with warm lighting, wooden tables, and plants by the window on a rainy afternoon.",
  "size": "16:9",
  "n": 1
}'
Request body

Parameters and usage notes

These are the ImgRouter fields. Official upstream names such as image_urls are mapped from reference_images.

modelstring · requiredDefault and required: midjourney.
promptstring · requiredText instruction, 1–5,000 characters. Describe the image or the edit you want.
sizestring · default 16:9Aspect ratio. Supported: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3. Prefer an explicit ratio instead of auto when you need predictable framing.
ninteger · 1–1Number of output images. Send a number, not a quoted string. Defaults to 1 and cannot exceed 1.
reference_imagesstring[] · max 4Public HTTPS image URLs for image-to-image or edit. Send this field to POST /v1/images/edits. Official docs may call this image_urls.
Controls

Size, resolution, and output

Aspect ratio or size

1:14:33:416:99:163:22:3

Output format

url

Route notes

Native Midjourney flags may be included in the prompt, such as --ar 16:9 or --style raw.

The explicit size field takes precedence over an aspect-ratio flag in the prompt.

Use reference_images for image-guided generation.

Reference workflow

Edit with reference images

Send public HTTPS source images with the same core controls. This route accepts up to 4 reference images.

POST/v1/images/edits
cURL
curl https://api.imgrouter.com/v1/images/edits \
  -H "Authorization: Bearer $IMGROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: midjourney-edit-001" \
  -d '{
  "model": "midjourney",
  "prompt": "Preserve the subject and composition. Change the scene to soft blue hour.",
  "size": "16:9",
  "n": 1,
  "reference_images": [
    "https://example.com/reference.jpg"
  ]
}'
Response

Read the completed output

Successful requests return completed image URLs and a request ID. Store the assets you need permanently; routed output URLs may expire.

200 · JSON
{
  "id": "req_01K4…",
  "object": "image.generation",
  "created": 1787424152,
  "data": [
    { "url": "https://static.imgrouter.com/images/req_01K4.webp" }
  ],
  "usage": { "images": 1 }
}

Use GET /v1/requests/{request_id} for reconciliation and GET /v1/balance for the authenticated key's current Credit position.