Midjourney 8.2 API

Parameters

Model parameters go inside settings. Omitted optional fields take their default values.

promptRequired

What to draw. Plain text only: Midjourney parameters (--ar, --v and others), links and options in curly braces are not accepted, there are fields for the settings and pictures. Versions 8.2 and 8.1 shorten a description longer than about 1000 characters before generating, version 7 takes the whole text.

Type: StringMinimum characters: 1Maximum characters: 6000

aspect_ratioOptional

Aspect ratio: width and height as whole numbers with a colon, digits only and no spaces, for example 1:1, 16:9, 9:16, 4:5, 2:3, 21:9.

Type: StringMaximum characters: 11Default: "1:1"

speedOptional

Speed. Relaxed is cheaper but waits in a queue, Fast is quicker and costs more. The price depends on it.

Type: StringAllowed values: relaxedfastDefault: "relaxed"

stylizationOptional

How artistic: 0 sticks to the description, 1000 adds the most beauty but drifts from the description. Not set: 100.

Type: IntegerMinimum: 0Maximum: 1000

chaosOptional

How different the four pictures are: 0 similar, 100 the most different.

Type: IntegerMinimum: 0Maximum: 100

weirdnessOptional

Weirdness: 0 an ordinary picture, 3000 surrealism and abstraction.

Type: IntegerMinimum: 0Maximum: 3000

raw_modeOptional

Without Midjourney artistic processing: the result is closer to an ordinary photo.

Type: BooleanDefault: false

tileOptional

A seamless pattern that repeats in every direction: wallpapers, fabrics, backgrounds.

Type: BooleanDefault: false

seedOptional

The starting number. The same number and description give a similar result. Not set: random.

Type: IntegerMinimum: 0Maximum: 4294967295

exclusionsOptional

What must not be in the picture, words separated by commas, for example: text, people, blur.

Type: StringMaximum characters: 500

image_promptsOptional

Image prompts: Midjourney takes the subject, composition and colors from them. Up to 4 URLs.

Type: List (String, uri)Maximum items: 4

iwOptional

Strength of the image prompts: 0 barely matter, 3 the strongest. Not set: 1. Works only together with image prompts.

Type: NumberMinimum: 0Maximum: 3

style_ref_imagesOptional

Style samples: the manner, colors and mood carry over, but not the objects. Up to 3 URLs.

Type: List (String, uri)Maximum items: 3

sref_codeOptional

A Midjourney style code, digits only, for example 123456789. Can go together with style samples.

Type: String

swOptional

Style strength: 0 barely matters, 1000 the strongest. Not set: 100. Works only together with style samples or a style code.

Type: IntegerMinimum: 0Maximum: 1000

enable_translationOptional

Translate the description into English before generating. If the translation fails or contains parameters, links or options in braces, the original description goes instead.

Type: BooleanDefault: false

edit_imagesOptional

Photos Midjourney draws a new picture from: it moves a person, a character or an object into a new scene, changes the clothes or the background, shows it from another side, puts several photos together in one scene. Say what to do in prompt. Up to 4 URLs. The proportions of the result come from aspect_ratio, not from the photos. Does not go together with tile.

Type: List (String, uri)Maximum items: 4

Parameters not listed here are not accepted: the response is 422 unknown_setting.

The API sets these settings itself, do not send them: plain_text = true rework_button = false

Input

• Pictures are URLs of JPEG, PNG or WebP files up to 10 MB each, a picture for the mask edit must be a PNG. A link must open without signing in and without redirects.
• The description and exclusions are plain text only: no Midjourney parameters, links or options in curly braces. Settings and pictures are set with fields.

Request example

Send this JSON to POST /v1/tasks with your API key. To check the price first, send the same JSON to POST /v1/price.

{
  "model": "midjourney",
  "settings": {
    "version": "8.2",
    "prompt": "A cozy reading nook by a rainy window, warm lamp light, film photo",
    "aspect_ratio": "3:2",
    "speed": "fast",
    "stylization": 250
  }
}

{
  "model": "midjourney",
  "settings": {
    "version": "8.2",
    "prompt": "Рыжий кот спит на подоконнике, за окном вечерний город",
    "aspect_ratio": "4:5",
    "enable_translation": true,
    "exclusions": "text, watermark"
  }
}

{
  "model": "midjourney",
  "settings": {
    "version": "8.2",
    "prompt": "A lighthouse on a cliff at dusk, waves crashing below",
    "aspect_ratio": "16:9",
    "style_ref_images": [
      "https://example.com/style-sample.jpg"
    ],
    "sw": 300
  }
}

{
  "model": "midjourney",
  "settings": {
    "version": "8.2",
    "prompt": "Make this woman wear a red silk gown on a seaside terrace at sunset, full body",
    "aspect_ratio": "2:3",
    "raw_mode": true,
    "edit_images": [
      "https://example.com/person.jpg"
    ]
  }
}

{
  "model": "midjourney",
  "settings": {
    "version": "8.2",
    "prompt": "Make the jacket yellow and turn the background into a snowy forest",
    "aspect_ratio": "4:5",
    "edit_images": [
      "https://example.com/photo.jpg"
    ]
  }
}

The price is calculated when the task is accepted, currency RUB.

Output

• Four JPEG pictures per run, each as a separate file.
• With Fast the result usually comes in about a minute, Relaxed waits in a queue longer.
• Upscaling and variations of finished pictures are only available in the bot.

A finished task as GET /v1/tasks/{id} returns it (some fields left out). The caption may sit on the task or on a single file and may be empty; the model picks the file name.

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Caption of the result: the model and its settings",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "image",
        "filename": "image.jpg",
        "size": 1843200,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      },
      {
        "index": 1,
        "kind": "image",
        "filename": "image.jpg",
        "size": 1843200,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/1"
      },
      {
        "index": 2,
        "kind": "image",
        "filename": "image.jpg",
        "size": 1843200,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/2"
      },
      {
        "index": 3,
        "kind": "image",
        "filename": "image.jpg",
        "size": 1843200,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/3"
      }
    ]
  }
}