v1.0 to v1.0

27 added, 142 removed. Audit A to A.

---

name: midjourney-image

- description: Generate, edit, blend, upscale, and describe images with Midjourney via AceDataCloud API. Use when creating AI images from text prompts, editing existing images, generating 2x2 grids, upscaling, creating variations, blending multiple images, reverse-prompting from images, or generating video from images. Supports versions 5.2 through 8.

+ description: Generate and edit Midjourney images or videos through Ace Data Cloud. Use for imagine, edit, blend, variations, upscale, describe, video generation, and querying the exact task ID.

license: Apache-2.0

metadata:

author: acedatacloud

version: "1.0"

- compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-midjourney for tool-use.

+ compatibility: Requires an Ace Data Cloud API token with Midjourney access. Optionally use the hosted mcp-midjourney server for tool calls.

---

- # Midjourney Image Generation

+ # Midjourney via Ace Data Cloud

- Generate and manipulate AI images through AceDataCloud's Midjourney API.

+ Use the [Midjourney API](https://platform.acedata.cloud/documents/midjourney-imagine) or the hosted MCP server. Follow the [shared authentication guide](../_shared/authentication.md) for a private `ACEDATACLOUD_API_TOKEN`; never paste the token into a prompt or saved file.

- > **Setup:** See [authentication](../_shared/authentication.md) for token setup.

+ ## First image

- ## Quick Start — Generate an Image

+ Check your current Midjourney pricing and balance in the Ace Data Cloud console before submitting a generation. One imagine request can produce a 2×2 grid. Use `async: true` so the request returns a `task_id` promptly:

```bash

curl -X POST https://api.acedata.cloud/midjourney/imagine \

-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \

-H "Content-Type: application/json" \

- -d '{"prompt": "a futuristic city at sunset, cyberpunk style --ar 16:9", "callback_url": "https://api.acedata.cloud/health"}'

- ```

- > **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /midjourney/tasks` with `{"id": "..."}`.

- ## Generation Modes

- |------|-------|------|----------|

- ## Midjourney Versions

- | Version | Notes |

- |---------|-------|

- | `8` | Latest, best quality |

- | `7` | Great quality, fast |

- | `6.1` | Stable, well-tested |

- | `6` | Previous generation |

- | `5.2` | Legacy |

- ## Core Workflows

- ### 1. Generate Images (Imagine)

- Creates a 2x2 grid of 4 image variations.

- ```json

- POST /midjourney/imagine

- {

- "prompt": "a serene mountain lake at dawn, photorealistic --ar 16:9 --v 7",

- "mode": "fast",

- "translation": true,

- "split_images": true

- }

- ```

- Set `translation: true` to auto-translate non-English prompts. Set `split_images: true` to get individual images besides the grid.

- ### 2. Upscale / Vary / Pan / Zoom

- After generating a grid, use transform actions on individual images:

- ```json

- POST /midjourney/imagine

- {

- "action": "upscale1",

- "image_id": "grid-image-id"

- }

- ```

- **Available actions:**

- - `upscale1`–`upscale4`: Upscale individual quadrant

- - `variation1`–`variation4`: Create variation of a quadrant

- - `variation_subtle` / `variation_strong`: Subtle/strong variation of full image

- - `reroll`: Re-generate with same prompt

- - `zoom_out_2x` / `zoom_out_1_5x`: Zoom out

- - `pan_left` / `pan_right` / `pan_up` / `pan_down`: Extend canvas

- ### 3. Edit an Image

- Modify an existing image using a text prompt, optionally with a mask.

- ```json

- POST /midjourney/edits

- {

- "image_url": "https://example.com/photo.jpg",

- "prompt": "add a rainbow in the sky",

- "mode": "fast"

- }

- ```

- ### 4. Blend Images

- Combine 2–5 images into a new composition.

- ```json

- POST /midjourney/imagine

- {

- "action": "blend",

- "image_urls": [

- "https://example.com/image1.jpg",

- "https://example.com/image2.jpg"

- ]

- }

- ```

- ### 5. Describe an Image (Reverse Prompt)

- Get AI-generated text descriptions of an image (returns 4 options).

- ```json

- POST /midjourney/describe

- {"image_url": "https://example.com/photo.jpg"}

+ -d '{"prompt":"A small red sailboat on a calm lake at sunrise --ar 1:1","mode":"fast","async":true}'

```

- ### 6. Generate Video from Image

- Create a video with a reference image and text prompt.

+ Save the returned `task_id`. Poll **that same ID**; do not repeat the imagine call to check progress:

- ```json

- POST /midjourney/videos

- {

- "image_url": "https://example.com/photo.jpg",

- "prompt": "the city comes alive with moving traffic",

- "resolution": "720p"

- }

+ ```bash

+ curl -X POST https://api.acedata.cloud/midjourney/tasks \

+ -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \

+ -H "Content-Type: application/json" \

+ -d '{"action":"retrieve","id":"TASK_ID_FROM_FIRST_CALL"}'

```

- ## Prompt Parameters

- Append these to your prompt text:

+ An accepted task is not a finished image. Only present the final artifact after the retrieved task contains `response.success: true` and a usable `response.image_url` or `response.raw_image_url`. Stop and report the error when the task fails. Keep the task ID when a query or network connection is interrupted; querying the same ID does not submit another generation. See the [task API guide](https://platform.acedata.cloud/documents/midjourney-tasks).

- | Parameter | Example | Description |

- |-----------|---------|-------------|

- | `--ar` | `--ar 16:9` | Aspect ratio |

- | `--v` | `--v 7` | Midjourney version |

- | `--q` | `--q 2` | Quality (0.25, 0.5, 1, 2) |

- | `--s` | `--s 750` | Stylization (0–1000) |

- | `--c` | `--c 50` | Chaos/variety (0–100) |

- | `--no` | `--no text, watermark` | Negative prompt |

- | `--seed` | `--seed 12345` | Reproducible generation |

+ ## Other actions

- ## API-Level Parameters (Billing Impact)

+ - Transform a completed grid with its `image_id` and an action such as `upscale1`, `variation1`, or `reroll` through `POST /midjourney/imagine`. These are new billable actions, not task queries.

+ - Edit an input image with a prompt through `POST /midjourney/edits`.

+ - Describe an image through `POST /midjourney/describe`.

+ - Generate or extend video through `POST /midjourney/videos`. Save its task ID and query the same task.

+ - Use the `version` parameter or prompt flags only for a version documented by the live API. Midjourney V8.1 supports `fast` and `relax`, not `turbo`, and does not accept a `quality` parameter.

- These top-level fields on `POST /midjourney/imagine` affect billing and are separate from inline prompt parameters:

+ ## MCP tools

- | Parameter | Type | Description |

- |-----------|------|-------------|

- | `version` | string | Midjourney version (`"8"`, `"7"`, `"6.1"`, etc.) — used for billing calculation |

- | `hd` | boolean | Enable HD 2K resolution (V8 only) — costs 4× GPU time |

- | `quality` | string | Quality level: `".25"`, `".5"`, `"1"`, `"2"`, `"4"` — quality `"4"` is V8 only and costs 4× GPU time |

- | `style_reference` | boolean | Whether prompt uses `--sref` style references (V8: costs 4× GPU time) |

- | `moodboard` | boolean | Whether prompt uses moodboard image references (V8: costs 4× GPU time) |

+ The hosted Streamable HTTP server is `https://midjourney.mcp.acedata.cloud/mcp`. Configure `Authorization: Bearer <Ace token>` privately in the MCP client. Its named tools include `midjourney_imagine`, `midjourney_edit`, `midjourney_blend`, `midjourney_describe`, `midjourney_generate_video`, `midjourney_get_task`, and `midjourney_get_tasks_batch`. Use `midjourney_get_task` with the exact ID returned by a generation tool until the final success or failure is clear. The [MCP server source](https://github.com/AceDataCloud/MidjourneyMCP) documents the full tool surface.

- ## Gotchas

+ The server can also run locally from the published `mcp-midjourney` package. Do not add a substitute model or service if an operation fails.

- - Imagine returns a **2x2 grid** — use upscale/variation actions to work with individual images

- - Use `split_images: true` to also receive individual cropped images alongside the grid

- - Prompt parameters (`--ar`, `--v`, etc.) go **inside the prompt string**, not as separate fields

- - `translation: true` auto-translates Chinese/other languages to English before sending to Midjourney

- - Video generation requires a reference `image_url` — it cannot generate from text alone

- - Available transform actions depend on the image — check `available_actions` in the response

- - Get the seed with `POST /midjourney/seed` using the image_id for reproducible results

+ ## Troubleshooting

- > **MCP:** `pip install mcp-midjourney` | Hosted: `https://midjourney.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)

+ - `401`: check the token value and expiry. `403`: check Midjourney access or content policy. `429`: wait for the advised rate-limit interval. A `5xx` or transport timeout after task submission is not a reason to create another task; query the saved ID first.

+ - If the task is complete but no URL is present, inspect the full task response and report the missing artifact; do not treat the task ID as a result.

+ - Review the Ace Data Cloud usage or billing record for the completed action. Task queries do not create another imagine request.