request_typerequired
Typeselect
Use async to poll statusTask, or callback to receive a webhook when the result is ready.async · callback
callback_urlconditional
Typetext
Public HTTPS URL for callback delivery.Only in request_type=callback
moderequired
Typeselect
Choose whether to create a new image or run a follow-up action on a previous Midjourney result.text-to-image · image-to-image · image-edit · vary · upscale
promptconditional
Typestring
Describe the subject, composition, style, lighting, and details you want in the final image.Only in mode=text-to-image | image-to-image | image-edit
aspect_ratioconditional
Typeselect
Choose the output frame ratio when creating new images.1:1 · 1:2 · 2:1 · 2:3 · 3:2 · 3:4 · 4:3 · 5:6 · 6:5 · 9:16 · 16:9Only in mode=text-to-image | image-to-image | image-edit
speedrequired
Typeselect
Choose generation speed. Draft is lowest cost, Fast is standard, and Turbo returns faster.draft · fast · turboOnly in mode=text-to-image | image-to-image | image-edit
versionconditional
Typeselect
Choose the Midjourney model version. Niji variants are best for anime and illustration styles.8.1 · 7 · 6.1 · 6 · niji7 · niji6Only in mode=text-to-image | image-to-image | image-edit
cwconditional
Typeslider
Controls how strongly Midjourney follows character references. Active only when character references are provided.Only in mode=text-to-image | image-to-image
swconditional
Typeslider
Controls style reference strength. Active only when style references are provided.Only in mode=text-to-image | image-to-image
svconditional
Typetext
Optional style reference version for compatible Midjourney routes.Only in mode=text-to-image | image-to-image
owconditional
Typeslider
Controls object reference strength. Active only when an object reference is provided.Only in mode=text-to-image | image-to-image
iwconditional
Typetext
Optional numeric weight for image prompts in text-to-image or image-to-image mode.Only in mode=text-to-image | image-to-image
negative_promptconditional
Typestring
Describe what to avoid. This maps to Midjourney negative prompting.Only in mode=text-to-image | image-to-image
varietyconditional
Typeslider
Controls result diversity. Higher values produce more varied and unexpected outputs.Only in mode=text-to-image | image-to-image | image-edit
stylizationconditional
Typeslider
Controls artistic stylization strength.Only in mode=text-to-image | image-to-image | image-edit
weirdnessconditional
Typeslider
Adds surreal or unconventional effects.Only in mode=text-to-image | image-to-image | image-edit
expconditional
Typeslider
Experimental Midjourney control for supported versions.Only in mode=text-to-image | image-to-image
is_hdconditional
Typeboolean
Enable optional 2K HD output for Midjourney v8.1 when supported.Only in mode=text-to-image | image-to-image + version=8.1
enableTranslationconditional
Typeboolean
Request prompt translation to English for compatible routes.Only in mode=text-to-image | image-to-image | image-edit
watermarkconditional
Typetext
Optional watermark text for compatible routes.Only in mode=text-to-image | image-to-image | image-edit
taskIdconditional
Typetext
Use the APIXO task ID from a previous successful Midjourney generation.Only in mode=vary | upscale
imageIndexconditional
Typeselect
Select one image from the previous four-image Midjourney result.0 · 1 · 2 · 3Only in mode=vary | upscale
typeconditional
Typeselect
For vary, 0 is subtle and 1 is strong. For upscale, 0 is standard, 1 is creative, 2 is 2x, and 3 is 4x.0 · 1 · 2 · 3Only in mode=vary | upscale
remixPromptconditional
Typestring
Optional text guidance for variation workflows on compatible routes.Only in mode=vary
File parameters (URL arrays)
image_urls[mode=text-to-image | image-to-image | image-edit]Image prompts for text-to-image or image-to-image, or exactly one source image for image-edit.Only in mode=text-to-image | image-to-image | image-edit
cref_urls[mode=text-to-image | image-to-image]Optional character reference images for text-to-image or image-to-image. Use these to preserve character identity across generations.Only in mode=text-to-image | image-to-image
sref_urls[mode=text-to-image | image-to-image]Optional style reference images for text-to-image or image-to-image. Uploaded files are sent as style reference URL objects.Only in mode=text-to-image | image-to-image
oref_urls[mode=text-to-image | image-to-image]Optional object reference image for text-to-image or image-to-image. At most one image is allowed.Only in mode=text-to-image | image-to-image