{"id":"0e647b87-0bdd-4416-b211-1e4db353bfd4","shortId":"gWWsjk","kind":"skill","title":"midjourney-image","tagline":"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 gene","description":"# Midjourney Image Generation\n\nGenerate and manipulate AI images through AceDataCloud's Midjourney API.\n\n> **Setup:** See [authentication](../_shared/authentication.md) for token setup.\n\n## Quick Start — Generate an Image\n\n```bash\ncurl -X POST https://api.acedata.cloud/midjourney/imagine \\\n  -H \"Authorization: Bearer $ACEDATACLOUD_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"prompt\": \"a futuristic city at sunset, cyberpunk style --ar 16:9\", \"callback_url\": \"https://api.acedata.cloud/health\"}'\n```\n\n> **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /midjourney/tasks` with `{\"task_id\": \"...\"}`.\n\n## Generation Modes\n\n| Mode | Speed | Cost | Best For |\n|------|-------|------|----------|\n| `fast` | Fast | Standard | Most tasks (default) |\n| `relax` | Slow | Cheaper | Batch generation |\n| `turbo` | Fastest | Premium | Time-sensitive work |\n\n## Midjourney Versions\n\n| Version | Notes |\n|---------|-------|\n| `8` | Latest, best quality |\n| `7` | Great quality, fast |\n| `6.1` | Stable, well-tested |\n| `6` | Previous generation |\n| `5.2` | Legacy |\n\n## Core Workflows\n\n### 1. Generate Images (Imagine)\n\nCreates a 2x2 grid of 4 image variations.\n\n```json\nPOST /midjourney/imagine\n{\n  \"prompt\": \"a serene mountain lake at dawn, photorealistic --ar 16:9 --v 7\",\n  \"mode\": \"fast\",\n  \"translation\": true,\n  \"split_images\": true\n}\n```\n\nSet `translation: true` to auto-translate non-English prompts. Set `split_images: true` to get individual images besides the grid.\n\n### 2. Upscale / Vary / Pan / Zoom\n\nAfter generating a grid, use transform actions on individual images:\n\n```json\nPOST /midjourney/imagine\n{\n  \"action\": \"upscale1\",\n  \"image_id\": \"grid-image-id\"\n}\n```\n\n**Available actions:**\n- `upscale1`–`upscale4`: Upscale individual quadrant\n- `variation1`–`variation4`: Create variation of a quadrant\n- `variation_subtle` / `variation_strong`: Subtle/strong variation of full image\n- `reroll`: Re-generate with same prompt\n- `zoom_out_2x` / `zoom_out_1_5x`: Zoom out\n- `pan_left` / `pan_right` / `pan_up` / `pan_down`: Extend canvas\n\n### 3. Edit an Image\n\nModify an existing image using a text prompt, optionally with a mask.\n\n```json\nPOST /midjourney/edits\n{\n  \"image_url\": \"https://example.com/photo.jpg\",\n  \"prompt\": \"add a rainbow in the sky\",\n  \"mode\": \"fast\"\n}\n```\n\n### 4. Blend Images\n\nCombine 2–5 images into a new composition.\n\n```json\nPOST /midjourney/imagine\n{\n  \"action\": \"blend\",\n  \"image_urls\": [\n    \"https://example.com/image1.jpg\",\n    \"https://example.com/image2.jpg\"\n  ]\n}\n```\n\n### 5. Describe an Image (Reverse Prompt)\n\nGet AI-generated text descriptions of an image (returns 4 options).\n\n```json\nPOST /midjourney/describe\n{\"image_url\": \"https://example.com/photo.jpg\"}\n```\n\n### 6. Generate Video from Image\n\nCreate a video with a reference image and text prompt.\n\n```json\nPOST /midjourney/videos\n{\n  \"image_url\": \"https://example.com/photo.jpg\",\n  \"prompt\": \"the city comes alive with moving traffic\",\n  \"resolution\": \"720p\"\n}\n```\n\n## Prompt Parameters\n\nAppend these to your prompt text:\n\n| Parameter | Example | Description |\n|-----------|---------|-------------|\n| `--ar` | `--ar 16:9` | Aspect ratio |\n| `--v` | `--v 7` | Midjourney version |\n| `--q` | `--q 2` | Quality (0.25, 0.5, 1, 2) |\n| `--s` | `--s 750` | Stylization (0–1000) |\n| `--c` | `--c 50` | Chaos/variety (0–100) |\n| `--no` | `--no text, watermark` | Negative prompt |\n| `--seed` | `--seed 12345` | Reproducible generation |\n\n## API-Level Parameters (Billing Impact)\n\nThese top-level fields on `POST /midjourney/imagine` affect billing and are separate from inline prompt parameters:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `version` | string | Midjourney version (`\"8\"`, `\"7\"`, `\"6.1\"`, etc.) — used for billing calculation |\n| `hd` | boolean | Enable HD 2K resolution (V8 only) — costs 4× GPU time |\n| `quality` | string | Quality level: `\".25\"`, `\".5\"`, `\"1\"`, `\"2\"`, `\"4\"` — quality `\"4\"` is V8 only and costs 4× GPU time |\n| `style_reference` | boolean | Whether prompt uses `--sref` style references (V8: costs 4× GPU time) |\n| `moodboard` | boolean | Whether prompt uses moodboard image references (V8: costs 4× GPU time) |\n\n## Gotchas\n\n- Imagine returns a **2x2 grid** — use upscale/variation actions to work with individual images\n- Use `split_images: true` to also receive individual cropped images alongside the grid\n- Prompt parameters (`--ar`, `--v`, etc.) go **inside the prompt string**, not as separate fields\n- `translation: true` auto-translates Chinese/other languages to English before sending to Midjourney\n- Video generation requires a reference `image_url` — it cannot generate from text alone\n- Available transform actions depend on the image — check `available_actions` in the response\n- Get the seed with `POST /midjourney/seed` using the image_id for reproducible results\n\n> **MCP:** `pip install mcp-midjourney` | Hosted: `https://midjourney.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)","tags":["midjourney","image","skills","acedatacloud","acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code"],"capabilities":["skill","source-acedatacloud","skill-midjourney-image","topic-acedata-cloud","topic-agent-skills","topic-agentskills","topic-ai-image","topic-ai-music","topic-ai-tools","topic-ai-video","topic-claude-code","topic-cursor","topic-gemini-cli","topic-github-copilot","topic-mcp"],"categories":["Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/AceDataCloud/Skills/midjourney-image","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add AceDataCloud/Skills","source_repo":"https://github.com/AceDataCloud/Skills","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 7 github stars · SKILL.md body (5,015 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:03.174Z","embedding":null,"createdAt":"2026-05-18T13:21:33.806Z","updatedAt":"2026-05-18T19:14:03.174Z","lastSeenAt":"2026-05-18T19:14:03.174Z","tsv":"'/_shared/async-tasks.md':108 '/_shared/authentication.md':59 '/_shared/mcp-servers.md':669 '/health':102 '/image1.jpg':350 '/image2.jpg':353 '/mcp':664 '/midjourney/describe':374 '/midjourney/edits':315 '/midjourney/imagine':74,179,239,343,479 '/midjourney/seed':647 '/midjourney/tasks':112 '/midjourney/videos':397 '/photo.jpg':320,379,402 '0':447,453 '0.25':439 '0.5':440 '1':165,283,441,522 '100':454 '1000':448 '12345':463 '16':96,189,426 '2':222,334,437,442,523 '25':520 '2k':508 '2x':280 '2x2':28,171,566 '3':297 '4':174,330,370,513,524,526,532,546,559 '5':335,354,521 '5.2':161 '50':451 '5x':284 '6':158,380 '6.1':153,498 '7':149,192,432,497 '720p':412 '750':445 '8':145,496 '9':97,190,427 'acedatacloud':14,52,78 'action':233,240,249,344,570,631,638 'add':322 'affect':480 'ai':19,49,362 'ai-gener':361 'aliv':407 'alon':628 'alongsid':586 'also':581 'api':15,55,79,467 'api-level':466 'api.acedata.cloud':73,101 'api.acedata.cloud/health':100 'api.acedata.cloud/midjourney/imagine':72 'append':415 'application/json':85 'ar':95,188,424,425,591 'aspect':428 'async':103,105 'authent':58 'author':76 'auto':205,606 'auto-transl':204,605 'avail':248,629,637 'bash':68 'batch':132 'bearer':77 'besid':219 'best':121,147 'bill':470,481,502 'blend':6,33,331,345 'boolean':505,537,550 'c':449,450 'calcul':503 'callback':98 'cannot':624 'canva':296 'chaos/variety':452 'cheaper':131 'check':636 'chinese/other':608 'citi':90,405 'combin':333 'come':406 'composit':340 'content':83 'content-typ':82 'core':163 'cost':120,512,531,545,558 'creat':18,31,169,257,385 'crop':584 'curl':69 'cyberpunk':93 'd':86 'dawn':186 'default':128 'depend':632 'describ':9,355 'descript':365,423,491 'edit':5,24,298 'enabl':506 'english':209,611 'etc':499,593 'exampl':422 'example.com':319,349,352,378,401 'example.com/image1.jpg':348 'example.com/image2.jpg':351 'example.com/photo.jpg':318,377,400 'exist':25,303 'extend':295 'fast':123,124,152,194,329 'fastest':135 'field':476,602 'full':269 'futurist':89 'gene':42 'generat':4,27,45,46,65,116,133,160,166,228,274,363,381,465,617,625 'get':216,360,642 'go':594 'gotcha':562 'gpu':514,533,547,560 'great':150 'grid':29,172,221,230,245,567,588 'grid-image-id':244 'h':75,81 'hd':504,507 'host':661 'id':115,243,247,651 'imag':3,10,20,26,35,40,44,50,67,167,175,198,213,218,236,242,246,270,300,304,316,332,336,346,357,368,375,384,391,398,555,575,578,585,621,635,650 'imagin':168,563 'impact':471 'individu':217,235,253,574,583 'inlin':486 'insid':595 'instal':657 'json':177,237,313,341,372,395 'lake':184 'languag':609 'latest':146 'left':288 'legaci':162 'level':468,475,519 'manipul':48 'mask':312 'mcp':655,659,667 'mcp-midjourney':658 'midjourney':2,12,43,54,141,433,494,615,660 'midjourney-imag':1 'midjourney.mcp.acedata.cloud':663 'midjourney.mcp.acedata.cloud/mcp':662 'mode':117,118,193,328 'modifi':301 'moodboard':549,554 'mountain':183 'move':409 'multipl':34 'negat':459 'new':339 'non':208 'non-english':207 'note':144 'option':309,371 'pan':225,287,289,291,293 'paramet':414,421,469,488,489,590 'photorealist':187 'pip':656 'poll':107,109 'post':71,111,178,238,314,342,373,396,478,646 'premium':136 'previous':159 'prompt':23,38,87,180,210,277,308,321,359,394,403,413,419,460,487,539,552,589,597 'q':435,436 'quadrant':254,261 'qualiti':148,151,438,516,518,525 'quick':63 'rainbow':324 'ratio':429 're':273 're-gener':272 'receiv':582 'refer':390,536,543,556,620 'relax':129 'reproduc':464,653 'requir':618 'rerol':271 'resolut':411,509 'respons':641 'result':654 'return':369,564 'revers':37,358 'reverse-prompt':36 'right':290 'see':57,104,665 'seed':461,462,644 'send':613 'sensit':139 'separ':484,601 'seren':182 'server':668 'set':200,211 'setup':56,62 'skill' 'skill-midjourney-image' 'sky':327 'slow':130 'source-acedatacloud' 'speed':119 'split':197,212,577 'sref':541 'stabl':154 'standard':125 'start':64 'string':493,517,598 'strong':265 'style':94,535,542 'styliz':446 'subtl':263 'subtle/strong':266 'sunset':92 'task':106,114,127 'test':157 'text':22,307,364,393,420,457,627 'time':138,515,534,548,561 'time-sensit':137 'token':61,80 'top':474 'top-level':473 'topic-acedata-cloud' 'topic-agent-skills' 'topic-agentskills' 'topic-ai-image' 'topic-ai-music' 'topic-ai-tools' 'topic-ai-video' 'topic-claude-code' 'topic-cursor' 'topic-gemini-cli' 'topic-github-copilot' 'topic-mcp' 'traffic':410 'transform':232,630 'translat':195,201,206,603,607 'true':196,199,202,214,579,604 'turbo':134 'type':84,490 'upscal':7,30,223,252 'upscale/variation':569 'upscale1':241,250 'upscale4':251 'url':99,317,347,376,399,622 'use':16,231,305,500,540,553,568,576,648 'v':191,430,431,592 'v8':510,528,544,557 'vari':224 'variat':32,176,258,262,264,267 'variation1':255 'variation4':256 'version':142,143,434,492,495 'via':13,110 'video':382,387,616 'watermark':458 'well':156 'well-test':155 'whether':538,551 'work':140,572 'workflow':164 'x':70 'zoom':226,278,281,285","prices":[{"id":"ea8ce8e6-c77c-4a46-8bea-e5e7cb07b80a","listingId":"0e647b87-0bdd-4416-b211-1e4db353bfd4","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"AceDataCloud","category":"Skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:21:33.806Z"}],"sources":[{"listingId":"0e647b87-0bdd-4416-b211-1e4db353bfd4","source":"github","sourceId":"AceDataCloud/Skills/midjourney-image","sourceUrl":"https://github.com/AceDataCloud/Skills/tree/main/skills/midjourney-image","isPrimary":false,"firstSeenAt":"2026-05-18T13:21:33.806Z","lastSeenAt":"2026-05-18T19:14:03.174Z"}],"details":{"listingId":"0e647b87-0bdd-4416-b211-1e4db353bfd4","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"AceDataCloud","slug":"midjourney-image","github":{"repo":"AceDataCloud/Skills","stars":7,"topics":["acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code","cursor","gemini-cli","github-copilot","mcp","npm","openai-codex","roo-code"],"license":"other","html_url":"https://github.com/AceDataCloud/Skills","pushed_at":"2026-05-18T07:35:03Z","description":"Agent Skills for AceDataCloud AI services — music, image, video generation, web search, and more. Compatible with Claude Code, GitHub Copilot, Gemini CLI, and all agentskills.io-compatible agents.","skill_md_sha":"0d7a911352dfbc4be83bc2a73fabbe9812f48348","skill_md_path":"skills/midjourney-image/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/AceDataCloud/Skills/tree/main/skills/midjourney-image"},"layout":"multi","source":"github","category":"Skills","frontmatter":{"name":"midjourney-image","license":"Apache-2.0","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.","compatibility":"Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-midjourney for tool-use."},"skills_sh_url":"https://skills.sh/AceDataCloud/Skills/midjourney-image"},"updatedAt":"2026-05-18T19:14:03.174Z"}}