midjourney_imagine
Generate AI images from text prompts, delivering a 2x2 grid of four variations for visualization and creative illustration.
Instructions
Generate AI images from a text prompt using Midjourney.
This is the primary way to create images - describe what you want and Midjourney
will generate a 2x2 grid of 4 image variations.
Use this when:
- You want to create new images from a text description
- You have a creative vision to visualize
- You need AI-generated artwork or illustrations
For image transformations like upscaling or variations, use midjourney_transform instead.
Returns:
Task ID and generated image information including URLs, dimensions, and available actions.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hd | No | Enable 2K HD output. V8.1 uses separate SD and HD resolution-based rates; V8.0 Alpha uses different premium rules. | |
| mode | No | Generation mode. 'fast' is recommended and 'relax' is slower but cheaper. 'turbo' is faster on supported versions, but V8.1 only supports fast and relax. | fast |
| prompt | Yes | Description of the image to generate. Be descriptive about style, subject, lighting, and composition. Examples: 'A majestic lion in a savanna at sunset, cinematic lighting', 'Cyberpunk city street at night, neon lights, rain, photorealistic', 'Abstract watercolor painting of mountains and clouds' | |
| quality | No | Image quality level for versions that support --quality / --q. This parameter is not supported in V8.1; use hd for higher-resolution V8.1 output. | |
| timeout | No | Timeout in seconds for the API to return data. Default is 480. | |
| version | No | Midjourney model version to use, e.g. '8.1', '8', '7', '6.1'. '8.1' is the latest version and is recommended. Leave unset to use Midjourney's default. | |
| moodboard | No | Whether the prompt uses a moodboard. V8.1 bills it at the selected SD/HD resolution rate; V8.0 Alpha uses different premium rules. | |
| translation | No | If true, automatically translate non-English prompts to English for better results. | |
| callback_url | No | Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the image is generated. | |
| split_images | No | If true, split the 2x2 grid result into 4 separate images returned via sub_image_urls. | |
| style_reference | No | Whether the prompt includes --sref style reference. V8.1 bills it at the selected SD/HD resolution rate; V8.0 Alpha uses different premium rules. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |