Skill: germey/acedatacloud-midjourney-image (version 1.0.0)

--- 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. license: Apache-2.0 metadata: author: acedatacloud version: "1.0" compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-midjourney for tool-use. --- # Midjourney Image Generation Generate and manipulate AI images through AceDataCloud's Midjourney API. ## Authentication ```bash export ACEDATACLOUD_API_TOKEN="your-token-here" ``` ## Quick Start — Generate an Image ```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", "wait": true}' ``` ## Generation Modes | Mode | Speed | Cost | Best For | |------|-------|------|----------| | `fast` | Fast | Standard | Most tasks (default) | | `relax` | Slow | Cheaper | Batch generation | | `turbo` | Fastest | Premium | Time-sensitive work | ## 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"} ``` ### 6. Generate Video from Image Create a video with a reference image and text prompt. ```json POST /midjourney/videos { "image_url": "https://example.com/photo.jpg", "prompt": "the city comes alive with moving traffic", "resolution": "720p" } ``` ## Prompt Parameters Append these to your prompt text: | 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 | ## Task Polling ```json POST /midjourney/tasks {"task_id": "your-task-id"} ``` ## MCP Server ```bash pip install mcp-midjourney ``` Or hosted: `https://midjourney.mcp.acedata.cloud/mcp` Key tools: `midjourney_imagine`, `midjourney_transform`, `midjourney_edit`, `midjourney_blend`, `midjourney_describe`, `midjourney_generate_video` ## Gotchas - 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


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)