@acedatacloud/skills 2026.622.4 → 2026.627.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +0 -1
- package/README.md +2 -4
- package/package.json +1 -2
- package/skills/_shared/mcp-servers.md +0 -1
- package/skills/acedatacloud-api/SKILL.md +1 -1
- package/skills/midjourney-image/SKILL.md +0 -170
package/AGENTS.md
CHANGED
|
@@ -12,7 +12,6 @@ Skills are located in the `skills/` directory (also mirrored to `.agents/skills/
|
|
|
12
12
|
- **fish-audio** — Text-to-speech and voice synthesis with Fish Audio
|
|
13
13
|
|
|
14
14
|
### AI Image Generation
|
|
15
|
-
- **midjourney-image** — Generate, edit, blend, describe, and upscale images with Midjourney
|
|
16
15
|
- **flux-image** — Generate and edit images with Flux (Black Forest Labs)
|
|
17
16
|
- **seedream-image** — Generate and edit images with ByteDance Seedream
|
|
18
17
|
- **nano-banana-image** — Generate and edit images with Google Gemini (NanoBanana)
|
package/README.md
CHANGED
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
|
|
13
13
|
Compatible with **30+ AI coding agents** via the [agentskills.io](https://agentskills.io/) open standard: Claude Code, GitHub Copilot, Gemini CLI, OpenAI Codex, Cursor, Roo Code, Goose, and more.
|
|
14
14
|
|
|
15
|
-
## Available Skills (
|
|
15
|
+
## Available Skills (29)
|
|
16
16
|
|
|
17
17
|
### AI Music & Audio
|
|
18
18
|
|
|
@@ -26,7 +26,6 @@ Compatible with **30+ AI coding agents** via the [agentskills.io](https://agents
|
|
|
26
26
|
|
|
27
27
|
| Skill | Description |
|
|
28
28
|
|-------|-------------|
|
|
29
|
-
| [midjourney-image](skills/midjourney-image/) | Generate, edit, blend, describe, and upscale images with Midjourney |
|
|
30
29
|
| [flux-image](skills/flux-image/) | Generate and edit images with Flux (Black Forest Labs) |
|
|
31
30
|
| [seedream-image](skills/seedream-image/) | Generate and edit images with ByteDance Seedream |
|
|
32
31
|
| [nano-banana-image](skills/nano-banana-image/) | Generate and edit images with Google Gemini (NanoBanana) |
|
|
@@ -92,7 +91,7 @@ export ACEDATACLOUD_API_TOKEN="your-token-here"
|
|
|
92
91
|
npx skills add acedatacloud/skills --skill '*' --yes
|
|
93
92
|
|
|
94
93
|
# Install specific skills only
|
|
95
|
-
npx skills add acedatacloud/skills --skill suno-music --skill
|
|
94
|
+
npx skills add acedatacloud/skills --skill suno-music --skill flux-image --yes
|
|
96
95
|
```
|
|
97
96
|
|
|
98
97
|
The [`skills` CLI](https://github.com/vercel-labs/skills) auto-detects your agent and installs to the correct path.
|
|
@@ -197,7 +196,6 @@ Skills provide **knowledge** (when to use, parameters, gotchas). MCP servers pro
|
|
|
197
196
|
| Skill | MCP Server | Install | Hosted Endpoint |
|
|
198
197
|
|-------|-----------|---------|-----------------|
|
|
199
198
|
| suno-music | [mcp-suno](https://pypi.org/project/mcp-suno/) | `pip install mcp-suno` | `https://suno.mcp.acedata.cloud/mcp` |
|
|
200
|
-
| midjourney-image | [mcp-midjourney](https://pypi.org/project/mcp-midjourney/) | `pip install mcp-midjourney` | `https://midjourney.mcp.acedata.cloud/mcp` |
|
|
201
199
|
| google-search | [mcp-serp](https://pypi.org/project/mcp-serp/) | `pip install mcp-serp` | `https://serp.mcp.acedata.cloud/mcp` |
|
|
202
200
|
| flux-image | [mcp-flux-pro](https://pypi.org/project/mcp-flux-pro/) | `pip install mcp-flux-pro` | `https://flux.mcp.acedata.cloud/mcp` |
|
|
203
201
|
| luma-video | [mcp-luma](https://pypi.org/project/mcp-luma/) | `pip install mcp-luma` | `https://luma.mcp.acedata.cloud/mcp` |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@acedatacloud/skills",
|
|
3
|
-
"version": "2026.
|
|
3
|
+
"version": "2026.627.0",
|
|
4
4
|
"description": "Agent Skills for AceDataCloud AI services — music, image, video generation, LLM chat, web search. Compatible with Claude Code, GitHub Copilot, Gemini CLI, OpenAI Codex, and 30+ AI coding agents.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"agent-skills",
|
|
@@ -12,7 +12,6 @@
|
|
|
12
12
|
"openai-codex",
|
|
13
13
|
"ai-tools",
|
|
14
14
|
"suno",
|
|
15
|
-
"midjourney",
|
|
16
15
|
"flux",
|
|
17
16
|
"luma",
|
|
18
17
|
"sora",
|
|
@@ -8,7 +8,6 @@ Each AceDataCloud service has a corresponding MCP server that provides tool-use
|
|
|
8
8
|
|-------|---------|-----------------|
|
|
9
9
|
| suno-music | `pip install mcp-suno` | `https://suno.mcp.acedata.cloud/mcp` |
|
|
10
10
|
| producer-music | — | — |
|
|
11
|
-
| midjourney-image | `pip install mcp-midjourney` | `https://midjourney.mcp.acedata.cloud/mcp` |
|
|
12
11
|
| google-search | `pip install mcp-serp` | `https://serp.mcp.acedata.cloud/mcp` |
|
|
13
12
|
| flux-image | `pip install mcp-flux-pro` | `https://flux.mcp.acedata.cloud/mcp` |
|
|
14
13
|
| luma-video | `pip install mcp-luma` | `https://luma.mcp.acedata.cloud/mcp` |
|
|
@@ -112,7 +112,7 @@ Error response format:
|
|
|
112
112
|
| Category | Services | Base Path |
|
|
113
113
|
|----------|----------|-----------|
|
|
114
114
|
| **AI Chat** | GPT, Claude, Gemini, Kimi, Grok | `/v1/chat/completions` |
|
|
115
|
-
| **Image Gen** |
|
|
115
|
+
| **Image Gen** | Flux, Seedream, NanoBanana | `/flux/*`, `/seedream/*`, etc. |
|
|
116
116
|
| **Video Gen** | Luma, Sora, Veo, Kling, Hailuo, Seedance, Wan | `/luma/*`, `/sora/*`, etc. |
|
|
117
117
|
| **Music Gen** | Suno, Producer, Fish Audio | `/suno/*`, `/producer/*`, `/fish/*` |
|
|
118
118
|
| **Search** | Google Search (web/images/news/maps) | `/serp/*` |
|
|
@@ -1,170 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: midjourney-image
|
|
3
|
-
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.
|
|
4
|
-
license: Apache-2.0
|
|
5
|
-
metadata:
|
|
6
|
-
author: acedatacloud
|
|
7
|
-
version: "1.0"
|
|
8
|
-
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-midjourney for tool-use.
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# Midjourney Image Generation
|
|
12
|
-
|
|
13
|
-
Generate and manipulate AI images through AceDataCloud's Midjourney API.
|
|
14
|
-
|
|
15
|
-
> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
|
|
16
|
-
|
|
17
|
-
## Quick Start — Generate an Image
|
|
18
|
-
|
|
19
|
-
```bash
|
|
20
|
-
curl -X POST https://api.acedata.cloud/midjourney/imagine \
|
|
21
|
-
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
|
|
22
|
-
-H "Content-Type: application/json" \
|
|
23
|
-
-d '{"prompt": "a futuristic city at sunset, cyberpunk style --ar 16:9", "callback_url": "https://api.acedata.cloud/health"}'
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
> **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /midjourney/tasks` with `{"id": "..."}`.
|
|
27
|
-
|
|
28
|
-
## Generation Modes
|
|
29
|
-
|
|
30
|
-
| Mode | Speed | Cost | Best For |
|
|
31
|
-
|------|-------|------|----------|
|
|
32
|
-
| `fast` | Fast | Standard | Most tasks (default) |
|
|
33
|
-
| `relax` | Slow | Cheaper | Batch generation |
|
|
34
|
-
| `turbo` | Fastest | Premium | Time-sensitive work |
|
|
35
|
-
|
|
36
|
-
## Midjourney Versions
|
|
37
|
-
|
|
38
|
-
| Version | Notes |
|
|
39
|
-
|---------|-------|
|
|
40
|
-
| `8` | Latest, best quality |
|
|
41
|
-
| `7` | Great quality, fast |
|
|
42
|
-
| `6.1` | Stable, well-tested |
|
|
43
|
-
| `6` | Previous generation |
|
|
44
|
-
| `5.2` | Legacy |
|
|
45
|
-
|
|
46
|
-
## Core Workflows
|
|
47
|
-
|
|
48
|
-
### 1. Generate Images (Imagine)
|
|
49
|
-
|
|
50
|
-
Creates a 2x2 grid of 4 image variations.
|
|
51
|
-
|
|
52
|
-
```json
|
|
53
|
-
POST /midjourney/imagine
|
|
54
|
-
{
|
|
55
|
-
"prompt": "a serene mountain lake at dawn, photorealistic --ar 16:9 --v 7",
|
|
56
|
-
"mode": "fast",
|
|
57
|
-
"translation": true,
|
|
58
|
-
"split_images": true
|
|
59
|
-
}
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
Set `translation: true` to auto-translate non-English prompts. Set `split_images: true` to get individual images besides the grid.
|
|
63
|
-
|
|
64
|
-
### 2. Upscale / Vary / Pan / Zoom
|
|
65
|
-
|
|
66
|
-
After generating a grid, use transform actions on individual images:
|
|
67
|
-
|
|
68
|
-
```json
|
|
69
|
-
POST /midjourney/imagine
|
|
70
|
-
{
|
|
71
|
-
"action": "upscale1",
|
|
72
|
-
"image_id": "grid-image-id"
|
|
73
|
-
}
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
**Available actions:**
|
|
77
|
-
- `upscale1`–`upscale4`: Upscale individual quadrant
|
|
78
|
-
- `variation1`–`variation4`: Create variation of a quadrant
|
|
79
|
-
- `variation_subtle` / `variation_strong`: Subtle/strong variation of full image
|
|
80
|
-
- `reroll`: Re-generate with same prompt
|
|
81
|
-
- `zoom_out_2x` / `zoom_out_1_5x`: Zoom out
|
|
82
|
-
- `pan_left` / `pan_right` / `pan_up` / `pan_down`: Extend canvas
|
|
83
|
-
|
|
84
|
-
### 3. Edit an Image
|
|
85
|
-
|
|
86
|
-
Modify an existing image using a text prompt, optionally with a mask.
|
|
87
|
-
|
|
88
|
-
```json
|
|
89
|
-
POST /midjourney/edits
|
|
90
|
-
{
|
|
91
|
-
"image_url": "https://example.com/photo.jpg",
|
|
92
|
-
"prompt": "add a rainbow in the sky",
|
|
93
|
-
"mode": "fast"
|
|
94
|
-
}
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
### 4. Blend Images
|
|
98
|
-
|
|
99
|
-
Combine 2–5 images into a new composition.
|
|
100
|
-
|
|
101
|
-
```json
|
|
102
|
-
POST /midjourney/imagine
|
|
103
|
-
{
|
|
104
|
-
"action": "blend",
|
|
105
|
-
"image_urls": [
|
|
106
|
-
"https://example.com/image1.jpg",
|
|
107
|
-
"https://example.com/image2.jpg"
|
|
108
|
-
]
|
|
109
|
-
}
|
|
110
|
-
```
|
|
111
|
-
|
|
112
|
-
### 5. Describe an Image (Reverse Prompt)
|
|
113
|
-
|
|
114
|
-
Get AI-generated text descriptions of an image (returns 4 options).
|
|
115
|
-
|
|
116
|
-
```json
|
|
117
|
-
POST /midjourney/describe
|
|
118
|
-
{"image_url": "https://example.com/photo.jpg"}
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
### 6. Generate Video from Image
|
|
122
|
-
|
|
123
|
-
Create a video with a reference image and text prompt.
|
|
124
|
-
|
|
125
|
-
```json
|
|
126
|
-
POST /midjourney/videos
|
|
127
|
-
{
|
|
128
|
-
"image_url": "https://example.com/photo.jpg",
|
|
129
|
-
"prompt": "the city comes alive with moving traffic",
|
|
130
|
-
"resolution": "720p"
|
|
131
|
-
}
|
|
132
|
-
```
|
|
133
|
-
|
|
134
|
-
## Prompt Parameters
|
|
135
|
-
|
|
136
|
-
Append these to your prompt text:
|
|
137
|
-
|
|
138
|
-
| Parameter | Example | Description |
|
|
139
|
-
|-----------|---------|-------------|
|
|
140
|
-
| `--ar` | `--ar 16:9` | Aspect ratio |
|
|
141
|
-
| `--v` | `--v 7` | Midjourney version |
|
|
142
|
-
| `--q` | `--q 2` | Quality (0.25, 0.5, 1, 2) |
|
|
143
|
-
| `--s` | `--s 750` | Stylization (0–1000) |
|
|
144
|
-
| `--c` | `--c 50` | Chaos/variety (0–100) |
|
|
145
|
-
| `--no` | `--no text, watermark` | Negative prompt |
|
|
146
|
-
| `--seed` | `--seed 12345` | Reproducible generation |
|
|
147
|
-
|
|
148
|
-
## API-Level Parameters (Billing Impact)
|
|
149
|
-
|
|
150
|
-
These top-level fields on `POST /midjourney/imagine` affect billing and are separate from inline prompt parameters:
|
|
151
|
-
|
|
152
|
-
| Parameter | Type | Description |
|
|
153
|
-
|-----------|------|-------------|
|
|
154
|
-
| `version` | string | Midjourney version (`"8"`, `"7"`, `"6.1"`, etc.) — used for billing calculation |
|
|
155
|
-
| `hd` | boolean | Enable HD 2K resolution (V8 only) — costs 4× GPU time |
|
|
156
|
-
| `quality` | string | Quality level: `".25"`, `".5"`, `"1"`, `"2"`, `"4"` — quality `"4"` is V8 only and costs 4× GPU time |
|
|
157
|
-
| `style_reference` | boolean | Whether prompt uses `--sref` style references (V8: costs 4× GPU time) |
|
|
158
|
-
| `moodboard` | boolean | Whether prompt uses moodboard image references (V8: costs 4× GPU time) |
|
|
159
|
-
|
|
160
|
-
## Gotchas
|
|
161
|
-
|
|
162
|
-
- Imagine returns a **2x2 grid** — use upscale/variation actions to work with individual images
|
|
163
|
-
- Use `split_images: true` to also receive individual cropped images alongside the grid
|
|
164
|
-
- Prompt parameters (`--ar`, `--v`, etc.) go **inside the prompt string**, not as separate fields
|
|
165
|
-
- `translation: true` auto-translates Chinese/other languages to English before sending to Midjourney
|
|
166
|
-
- Video generation requires a reference `image_url` — it cannot generate from text alone
|
|
167
|
-
- Available transform actions depend on the image — check `available_actions` in the response
|
|
168
|
-
- Get the seed with `POST /midjourney/seed` using the image_id for reproducible results
|
|
169
|
-
|
|
170
|
-
> **MCP:** `pip install mcp-midjourney` | Hosted: `https://midjourney.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)
|