skills/acedatacloud__skills
1
0
Fork 0
mirror of https://github.com/AceDataCloud/Skills.git synced 2026-09-14 20:06:53 +08:00
Code Issues Packages Projects Releases Wiki Activity

feat: initial release of 11 AceDataCloud Agent Skills

Browse Source
This commit is contained in:
Ace Data Cloud Dev
2026-03-22 10:17:08 +08:00
committed by Germey
commit 7b12b1f850
15 changed files with 1503 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.claude-plugin/marketplace.json
+40
View File
@@ -0,0 +1,40 @@
{
"name": "acedatacloud-skills",
"owner": {
"name": "Ace Data Cloud",
"email": "dev@acedata.cloud"
},
"metadata": {
"description": "AI-powered data services skills for music, image, video generation, web search, and more",
"version": "1.0.0"
},
"plugins": [
{
"name": "acedatacloud-ai-media",
"description": "AI media generation skills: music (Suno), images (Midjourney, Flux, Seedream, NanoBanana), video (Luma, Sora, Veo, Seedance)",
"source": "./",
"strict": false,
"skills": [
"./skills/suno-music",
"./skills/midjourney-image",
"./skills/flux-image",
"./skills/luma-video",
"./skills/sora-video",
"./skills/veo-video",
"./skills/seedream-image",
"./skills/seedance-video",
"./skills/nano-banana-image"
]
},
{
"name": "acedatacloud-ai-tools",
"description": "AI utility skills: web search and short URLs",
"source": "./",
"strict": false,
"skills": [
"./skills/google-search",
"./skills/short-url"
]
}
]
}
LICENSE
+17
View File
@@ -0,0 +1,17 @@
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Copyright 2026 Ace Data Cloud
README.md
+111
View File
@@ -0,0 +1,111 @@
# AceDataCloud Agent Skills
[Agent Skills](https://agentskills.io/) for [AceDataCloud](https://platform.acedata.cloud) AI services — music, image, video generation, web search, and more.
Works with **Claude Code**, **GitHub Copilot (VS Code)**, **Gemini CLI**, **OpenHands**, **Roo Code**, **TRAE**, **Goose**, and all [agentskills.io](https://agentskills.io/)-compatible agents.
## Available Skills
### AI Music
| Skill | Description |
|-------|-------------|
| [suno-music](skills/suno-music/) | Generate AI music, lyrics, covers, and vocal extraction with Suno |
### AI Image Generation
| Skill | Description |
|-------|-------------|
| [midjourney-image](skills/midjourney-image/) | Generate, edit, blend, describe, and upscale images with Midjourney |
| [flux-image](skills/flux-image/) | Generate and edit images with Flux (Black Forest Labs) |
| [seedream-image](skills/seedream-image/) | Generate and edit images with ByteDance Seedream |
| [nano-banana-image](skills/nano-banana-image/) | Generate and edit images with Google Gemini (Nano Banana) |
### AI Video Generation
| Skill | Description |
|-------|-------------|
| [luma-video](skills/luma-video/) | Generate videos with Luma Dream Machine |
| [sora-video](skills/sora-video/) | Generate videos with OpenAI Sora |
| [veo-video](skills/veo-video/) | Generate videos with Google Veo |
| [seedance-video](skills/seedance-video/) | Generate videos with ByteDance Seedance |
### Web & Utilities
| Skill | Description |
|-------|-------------|
| [google-search](skills/google-search/) | Search the web, images, news, maps, places, and videos via Google |
| [short-url](skills/short-url/) | Create and manage short URLs |
## Installation
### Claude Code (Plugin Marketplace)
```bash
/plugin marketplace add AceDataCloud/Skills
/plugin install acedatacloud-ai-media@acedatacloud-skills
/plugin install acedatacloud-ai-tools@acedatacloud-skills
```
### Claude Code (Manual)
```bash
claude --add-dir /path/to/Skills/skills
```
### GitHub Copilot / VS Code
Copy the skill folders into your project:
```bash
cp -r skills/* .github/skills/
# or
cp -r skills/* .agents/skills/
```
### Any agentskills.io-compatible agent
Clone and point your agent to the skills directory:
```bash
git clone https://github.com/AceDataCloud/Skills.git
```
## Authentication
All skills require an AceDataCloud API token. Get yours at [platform.acedata.cloud](https://platform.acedata.cloud).
```bash
export ACEDATACLOUD_API_TOKEN="your-token-here"
```
## MCP Server Integration
Each skill works standalone via direct API calls, but for best results, pair with the corresponding [MCP server](https://platform.acedata.cloud/services) for tool-use capabilities:
| Skill | MCP Server | Install |
|-------|-----------|---------|
| suno-music | [mcp-suno](https://pypi.org/project/mcp-suno/) | `pip install mcp-suno` |
| midjourney-image | [mcp-midjourney](https://pypi.org/project/mcp-midjourney/) | `pip install mcp-midjourney` |
| google-search | [mcp-serp](https://pypi.org/project/mcp-serp/) | `pip install mcp-serp` |
| flux-image | [mcp-flux](https://pypi.org/project/mcp-flux/) | `pip install mcp-flux` |
| luma-video | [mcp-luma](https://pypi.org/project/mcp-luma/) | `pip install mcp-luma` |
| sora-video | [mcp-sora](https://pypi.org/project/mcp-sora/) | `pip install mcp-sora` |
| veo-video | [mcp-veo](https://pypi.org/project/mcp-veo/) | `pip install mcp-veo` |
| seedream-image | [mcp-seedream](https://pypi.org/project/mcp-seedream/) | `pip install mcp-seedream` |
| seedance-video | [mcp-seedance](https://pypi.org/project/mcp-seedance/) | `pip install mcp-seedance` |
| nano-banana-image | [mcp-nano-banana](https://pypi.org/project/mcp-nano-banana/) | `pip install mcp-nano-banana` |
| short-url | [mcp-shorturl](https://pypi.org/project/mcp-shorturl/) | `pip install mcp-shorturl` |
## Contributing
We welcome contributions! To add a new skill:
1. Create a directory under `skills/` matching the skill name
2. Add a `SKILL.md` following the [Agent Skills specification](https://agentskills.io/specification)
3. Optionally add `scripts/`, `references/`, and `examples/` directories
4. Submit a pull request
## License
[Apache-2.0](LICENSE)
skills/flux-image/SKILL.md
+99
View File
@@ -0,0 +1,99 @@
---
name: flux-image
description: Generate and edit images with Flux (Black Forest Labs) via AceDataCloud API. Use when creating images from text prompts, editing existing images with text instructions, or when high-quality image generation is needed. Supports multiple Flux models including dev, pro, ultra, and kontext for editing.
license: Apache-2.0
metadata:
author: acedatacloud
version: "1.0"
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-flux for tool-use.
---
# Flux Image Generation
Generate and edit images through AceDataCloud's Flux API.
## Authentication
```bash
export ACEDATACLOUD_API_TOKEN="your-token-here"
```
## Quick Start
```bash
curl -X POST https://api.acedata.cloud/flux/images \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "a cat wearing a space helmet, photorealistic", "model": "flux-dev", "wait": true}'
```
## Models
| Model | Quality | Speed | Sizes | Best For |
|-------|---------|-------|-------|----------|
| `flux-dev` | Good | Fast | 256–1440px | Quick generation (default) |
| `flux-pro` | High | Medium | 256–1440px | Production work |
| `flux-pro-1.1` | Higher | Medium | 256–1440px | Better prompt following |
| `flux-pro-1.1-ultra` | Highest | Slow | Aspect ratios | Maximum quality |
| `flux-kontext-pro` | High | Medium | Aspect ratios | Image editing |
| `flux-kontext-max` | Highest | Slow | Aspect ratios | Complex editing |
## Generate Images
```json
POST /flux/images
{
"prompt": "a minimalist logo of a mountain",
"action": "generate",
"model": "flux-pro-1.1",
"size": "1024x1024",
"count": 1
}
```
### Size Options
**For dev/pro/pro-1.1** (pixel dimensions):
- `"1024x1024"`, `"1344x768"`, `"768x1344"`, `"1024x576"`, `"576x1024"`
**For ultra/kontext** (aspect ratios):
- `"1:1"`, `"16:9"`, `"9:16"`, `"4:3"`, `"3:4"`, `"3:2"`, `"2:3"`, `"21:9"`, `"9:21"`
## Edit Images
Use kontext models for text-guided image editing:
```json
POST /flux/images
{
"prompt": "change the background to a beach sunset",
"action": "edit",
"image_url": "https://example.com/photo.jpg",
"model": "flux-kontext-pro"
}
```
## Task Polling
```json
POST /flux/tasks
{"task_id": "your-task-id"}
```
## MCP Server
```bash
pip install mcp-flux
```
Or hosted: `https://flux.mcp.acedata.cloud/mcp`
Key tools: `flux_generate_image`, `flux_edit_image`
## Gotchas
- Use pixel dimensions (e.g., `"1024x1024"`) with dev/pro models, aspect ratios (e.g., `"16:9"`) with ultra/kontext models
- Editing requires kontext models (`flux-kontext-pro` or `flux-kontext-max`) — other models only support generation
- `count` parameter generates multiple images in one request (increases cost proportionally)
- Ultra model produces highest quality but is slowest — use dev for iteration, ultra for final output
- All generation is async — use `"wait": true` or poll `/flux/tasks`
skills/google-search/SKILL.md
+100
View File
@@ -0,0 +1,100 @@
---
name: google-search
description: Search the web using Google via AceDataCloud API. Use when searching for web pages, images, news, maps, local places, or videos. Supports localization, time filtering, and pagination. Returns structured results with titles, snippets, URLs, and rich data.
license: Apache-2.0
metadata:
author: acedatacloud
version: "1.0"
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-serp for tool-use.
---
# Google Search (SERP)
Search the web through AceDataCloud's Google SERP API.
## Authentication
```bash
export ACEDATACLOUD_API_TOKEN="your-token-here"
```
## Quick Start
```bash
curl -X POST https://api.acedata.cloud/serp/google \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"query": "latest AI news", "search_type": "search"}'
```
## Search Types
| Type | Description | Returns |
|------|-------------|---------|
| `search` | Web search (default) | Organic results, knowledge graph, rich snippets |
| `images` | Image search | Image URLs, titles, sources |
| `news` | News articles | Headlines, sources, publish dates |
| `maps` | Map results | Locations, coordinates |
| `places` | Local businesses/places | Name, address, rating, reviews |
| `videos` | Video results | Video URLs, thumbnails, duration |
## Parameters
```json
POST /serp/google
{
"query": "your search query",
"search_type": "search",
"country": "us",
"language": "en",
"time_range": "qdr:w",
"number": 10,
"page": 1
}
```
| Parameter | Type | Description |
|-----------|------|-------------|
| `query` | string | Search query (required) |
| `search_type` | string | One of: search, images, news, maps, places, videos |
| `country` | string | Country code (e.g., "us", "uk", "cn", "jp") |
| `language` | string | Language code (e.g., "en", "zh", "ja") |
| `time_range` | string | Time filter (see below) |
| `number` | int | Number of results per page |
| `page` | int | Page number for pagination |
## Time Range Options
| Value | Period |
|-------|--------|
| `qdr:h` | Past hour |
| `qdr:d` | Past 24 hours |
| `qdr:w` | Past week |
| `qdr:m` | Past month |
| `qdr:y` | Past year |
## Response Structure
Web search returns structured data including:
- `organic_results`: Main search results with title, link, snippet
- `knowledge_graph`: Entity information panel (when available)
- `related_searches`: Related query suggestions
## MCP Server
```bash
pip install mcp-serp
```
Or hosted: `https://serp.mcp.acedata.cloud/mcp`
Key tool: `serp_google_search`
## Gotchas
- Default search type is `"search"` (web). Always specify `search_type` for non-web searches
- Country and language codes affect result localization significantly
- `number` controls results per page, not total results — use `page` for pagination
- Time range only applies to web search and news, not images or places
- Image search returns thumbnail and full-size URLs — use full-size for downloads
- Places search works best with location-specific queries (e.g., "restaurants near Times Square")
skills/luma-video/SKILL.md
+124
View File
@@ -0,0 +1,124 @@
---
name: luma-video
description: Generate AI videos with Luma Dream Machine via AceDataCloud API. Use when creating videos from text prompts, generating videos from reference images, extending existing videos, or any video generation task with Luma. Supports text-to-video, image-to-video, and video extension.
license: Apache-2.0
metadata:
author: acedatacloud
version: "1.0"
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-luma for tool-use.
---
# Luma Video Generation
Generate AI videos through AceDataCloud's Luma Dream Machine API.
## Authentication
```bash
export ACEDATACLOUD_API_TOKEN="your-token-here"
```
## Quick Start
```bash
curl -X POST https://api.acedata.cloud/luma/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "a drone flying over a mountain lake at sunrise", "action": "generate", "wait": true}'
```
## Workflows
### 1. Text-to-Video
Generate video purely from a text description.
```json
POST /luma/videos
{
"prompt": "a timelapse of flowers blooming in a garden",
"action": "generate",
"aspect_ratio": "16:9",
"loop": false,
"enhancement": true
}
```
### 2. Image-to-Video
Use start and/or end reference images to guide generation.
```json
POST /luma/videos
{
"prompt": "the scene comes alive with gentle wind",
"action": "generate",
"start_image_url": "https://example.com/scene.jpg",
"end_image_url": "https://example.com/scene-end.jpg",
"aspect_ratio": "16:9"
}
```
### 3. Extend a Video
Continue an existing video with a new prompt.
```json
POST /luma/videos
{
"action": "extend",
"video_id": "existing-video-id",
"prompt": "the camera continues forward through the forest"
}
```
## Aspect Ratios
| Ratio | Use Case |
|-------|----------|
| `16:9` | Landscape (default) — YouTube, TV |
| `9:16` | Portrait — TikTok, Instagram Stories |
| `1:1` | Square — Social media |
| `4:3` | Classic — Presentations |
| `21:9` | Ultra-wide — Cinematic |
## Parameters
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `prompt` | string | — | Text description of the video (required) |
| `action` | string | `"generate"` | `"generate"` or `"extend"` |
| `aspect_ratio` | string | `"16:9"` | Video aspect ratio |
| `loop` | bool | `false` | Create seamless loop |
| `enhancement` | bool | `true` | Enhance prompt for better results |
| `start_image_url` | string | — | Reference image for first frame |
| `end_image_url` | string | — | Reference image for last frame |
| `video_id` | string | — | Required for extend action |
## Task Polling
```json
POST /luma/tasks
{"task_id": "your-task-id"}
```
Poll every 5 seconds. States: `pending` → `completed` or `failed`.
## MCP Server
```bash
pip install mcp-luma
```
Or hosted: `https://luma.mcp.acedata.cloud/mcp`
Key tools: `luma_generate_video`, `luma_generate_video_from_image`, `luma_extend_video`
## Gotchas
- `enhancement: true` (default) improves prompt quality but may alter your intent — set to `false` for literal prompts
- Start/end image URLs must be publicly accessible
- `loop: true` creates seamless looping video — good for backgrounds and social media
- Extend requires the `video_id` from a previously completed generation
- Video generation takes 1–5 minutes depending on complexity
- Both start and end images are optional — you can use just one for partial guidance
skills/midjourney-image/SKILL.md
+175
View File
@@ -0,0 +1,175 @@
---
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
skills/nano-banana-image/SKILL.md
+97
View File
@@ -0,0 +1,97 @@
---
name: nano-banana-image
description: Generate and edit AI images with NanoBanana (Gemini-based) via AceDataCloud API. Use when creating images from text prompts or editing existing images with text instructions. Supports nano-banana and nano-banana-pro models.
license: Apache-2.0
metadata:
author: acedatacloud
version: "1.0"
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-nano-banana for tool-use.
---
# NanoBanana Image Generation
Generate and edit AI images through AceDataCloud's NanoBanana (Gemini-based) API.
## Authentication
```bash
export ACEDATACLOUD_API_TOKEN="your-token-here"
```
## Quick Start
```bash
curl -X POST https://api.acedata.cloud/nano-banana/images \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "a watercolor painting of a French countryside village", "model": "nano-banana"}'
```
## Models
| Model | Best For |
|-------|----------|
| `nano-banana` | Standard image generation (default) |
| `nano-banana-pro` | Higher quality, more detailed output |
## Workflows
### 1. Text-to-Image
```json
POST /nano-banana/images
{
"prompt": "a photorealistic macro shot of morning dew on a spider web",
"model": "nano-banana-pro",
"aspect_ratio": "16:9"
}
```
### 2. Image Editing
Edit an existing image using natural language instructions — no mask needed.
```json
POST /nano-banana/images/edit
{
"prompt": "change the background to a starry night sky",
"image_url": "https://example.com/photo.jpg",
"model": "nano-banana"
}
```
## Parameters
### Generation
| Parameter | Values | Description |
|-----------|--------|-------------|
| `model` | `"nano-banana"`, `"nano-banana-pro"` | Model to use |
| `aspect_ratio` | `"1:1"`, `"3:4"`, `"4:3"`, `"9:16"`, `"16:9"` | Output aspect ratio |
### Editing
| Parameter | Required | Description |
|-----------|----------|-------------|
| `image_url` | Yes | URL of the source image |
| `prompt` | Yes | Natural language editing instruction |
| `model` | No | Model to use (defaults to `"nano-banana"`) |
| `aspect_ratio` | No | Output aspect ratio |
## MCP Server
```bash
pip install mcp-nano-banana
```
Or hosted: `https://nano-banana.mcp.acedata.cloud/mcp`
Key tools: `nano_banana_generate_image`, `nano_banana_edit_image`
## Gotchas
- Editing does **NOT** require a mask — just describe the change in natural language
- `nano-banana-pro` produces significantly more detailed results but costs more
- Results return a direct image URL — no task polling needed
- Aspect ratio uses colon notation (e.g., `"16:9"`) not pixel dimensions
- The Gemini-based model excels at understanding complex, conversational editing instructions
skills/seedance-video/SKILL.md
+106
View File
@@ -0,0 +1,106 @@
---
name: seedance-video
description: Generate AI dance and motion videos with Seedance (ByteDance) via AceDataCloud API. Use when creating videos from text prompts or animating images into motion videos. Supports multiple models with configurable resolution, duration, and service tiers.
license: Apache-2.0
metadata:
author: acedatacloud
version: "1.0"
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-seedance for tool-use.
---
# Seedance Video Generation
Generate AI dance and motion videos through AceDataCloud's Seedance (ByteDance) API.
## Authentication
```bash
export ACEDATACLOUD_API_TOKEN="your-token-here"
```
## Quick Start
```bash
curl -X POST https://api.acedata.cloud/seedance/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "a dancer performing contemporary ballet in a misty forest", "model": "seedance-1.0", "wait": true}'
```
## Models
| Model | Best For |
|-------|----------|
| `seedance-1.0` | General-purpose motion/dance video |
| `seedance-1.0-lite` | Faster, lighter generation |
| `seedance-1.0-pro` | Higher quality output |
| `seedance-1.5-pro` | Latest model, best quality |
| `seedance-acting-pro` | Character acting and expression |
## Workflows
### 1. Text-to-Video
```json
POST /seedance/videos
{
"prompt": "a street dancer doing breakdancing moves in an urban setting",
"model": "seedance-1.0-pro",
"resolution": "1080p",
"duration": 5,
"service_tier": "standard"
}
```
### 2. Image-to-Video
Animate a still image into a motion video.
```json
POST /seedance/videos
{
"prompt": "the person starts dancing gracefully",
"image_url": "https://example.com/dancer.jpg",
"model": "seedance-1.5-pro",
"resolution": "720p",
"duration": 5
}
```
## Parameters
| Parameter | Values | Description |
|-----------|--------|-------------|
| `model` | See models table | Model to use |
| `resolution` | `"360p"`, `"540p"`, `"720p"`, `"1080p"` | Output resolution |
| `duration` | `2` – `12` | Duration in seconds |
| `service_tier` | `"standard"`, `"premium"` | Quality tier (premium = faster, higher priority) |
| `seed` | integer | Seed for reproducible results |
## Task Polling
```json
POST /seedance/tasks
{"task_id": "your-task-id"}
```
States: `pending` → `succeeded` or `failed`.
## MCP Server
```bash
pip install mcp-seedance
```
Or hosted: `https://seedance.mcp.acedata.cloud/mcp`
Key tools: `seedance_generate_video`, `seedance_generate_video_from_image`
## Gotchas
- Duration range is **2–12 seconds** — values outside this range will fail
- Higher resolutions (1080p) combined with longer durations take significantly more time
- `premium` service tier costs more but generates faster
- `seedance-acting-pro` excels at facial expressions and character acting versus pure dance
- Image-to-video requires a single `image_url` — the person/subject in the image becomes the animated subject
- Task states use `"succeeded"` (not "completed") — check for this value when polling
skills/seedream-image/SKILL.md
+102
View File
@@ -0,0 +1,102 @@
---
name: seedream-image
description: Generate and edit AI images with Seedream (ByteDance) via AceDataCloud API. Use when creating images from text prompts, editing existing images with inpainting/outpainting, or working with ultra-high-resolution outputs. Supports Seedream 2.0, 2.1, 3.0, and 3.0 Turbo models.
license: Apache-2.0
metadata:
author: acedatacloud
version: "1.0"
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-seedream for tool-use.
---
# Seedream Image Generation
Generate and edit AI images through AceDataCloud's Seedream (ByteDance) API.
## Authentication
```bash
export ACEDATACLOUD_API_TOKEN="your-token-here"
```
## Quick Start
```bash
curl -X POST https://api.acedata.cloud/seedream/images \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "a cyberpunk cat wearing VR goggles in a neon city", "model": "seedream-3.0"}'
```
## Models
| Model | Resolution | Speed | Best For |
|-------|-----------|-------|----------|
| `seedream-2.0` | Standard | Fast | Quick drafts |
| `seedream-2.1` | Standard | Fast | Improved quality over 2.0 |
| `seedream-3.0` | Up to 2048×2048 | Standard | High-quality generation (default) |
| `seedream-3.0-turbo` | Up to 2048×2048 | Faster | Speed-optimized with near-3.0 quality |
## Workflows
### 1. Text-to-Image
```json
POST /seedream/images
{
"prompt": "a serene Japanese garden with cherry blossoms and a red bridge",
"model": "seedream-3.0",
"width": 1024,
"height": 1024
}
```
### 2. Image Editing (Inpainting / Outpainting)
Edit regions of an existing image using a mask.
```json
POST /seedream/images/edit
{
"prompt": "replace with a golden sunset sky",
"image_url": "https://example.com/photo.jpg",
"mask_url": "https://example.com/mask.png",
"model": "seedream-3.0"
}
```
## Parameters
### Generation
| Parameter | Values | Description |
|-----------|--------|-------------|
| `model` | `"seedream-2.0"`, `"seedream-2.1"`, `"seedream-3.0"`, `"seedream-3.0-turbo"` | Model to use |
| `width` | 512 – 2048 | Image width in pixels |
| `height` | 512 – 2048 | Image height in pixels |
| `seed` | integer | Seed for reproducible results |
### Editing
| Parameter | Required | Description |
|-----------|----------|-------------|
| `image_url` | Yes | URL of the source image to edit |
| `mask_url` | Yes | URL of the binary mask (white = edit region) |
| `prompt` | Yes | Describe what to place in the masked area |
## MCP Server
```bash
pip install mcp-seedream
```
Or hosted: `https://seedream.mcp.acedata.cloud/mcp`
Key tools: `seedream_generate_image`, `seedream_edit_image`
## Gotchas
- Maximum resolution is **2048×2048** — exceed this and requests fail
- Mask images must be **binary** (black/white) with the same dimensions as the source image
- `seedream-3.0-turbo` offers a good speed/quality trade-off for iterative workflows
- Results return a direct image URL — no task polling needed for generation
- Editing always requires both `image_url` and `mask_url`
skills/short-url/SKILL.md
+96
View File
@@ -0,0 +1,96 @@
---
name: short-url
description: Create short URLs via AceDataCloud API. Use when generating shortened links for sharing, or batch-creating multiple short URLs at once. Supports custom slugs and expiration.
license: Apache-2.0
metadata:
author: acedatacloud
version: "1.0"
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-short-url for tool-use.
---
# Short URL Service
Create short URLs through AceDataCloud's URL shortening API.
## Authentication
```bash
export ACEDATACLOUD_API_TOKEN="your-token-here"
```
## Quick Start
```bash
curl -X POST https://api.acedata.cloud/short-url \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/very-long-url-path?with=params"}'
```
## Workflows
### 1. Create a Single Short URL
```json
POST /short-url
{
"url": "https://example.com/article/2024/awesome-content",
"expires_in": 86400
}
```
Response:
```json
{
"short_url": "https://acda.cc/abc123",
"url": "https://example.com/article/2024/awesome-content"
}
```
### 2. Batch Create Short URLs
Create multiple short URLs in one request.
```json
POST /short-url/batch
{
"urls": [
"https://example.com/page1",
"https://example.com/page2",
"https://example.com/page3"
]
}
```
## Parameters
### Single
| Parameter | Required | Description |
|-----------|----------|-------------|
| `url` | Yes | The original long URL to shorten |
| `expires_in` | No | Expiration in seconds (omit for permanent) |
### Batch
| Parameter | Required | Description |
|-----------|----------|-------------|
| `urls` | Yes | Array of URLs to shorten |
## MCP Server
```bash
pip install mcp-short-url
```
Or hosted: `https://short-url.mcp.acedata.cloud/mcp`
Key tools: `create_short_url`, `batch_create_short_urls`
## Gotchas
- Short URLs use the `acda.cc` domain
- Results are returned synchronously — no task polling needed
- Batch endpoint accepts an array and returns an array in the same order
- If `expires_in` is omitted, the short URL is permanent
skills/sora-video/SKILL.md
+114
View File
@@ -0,0 +1,114 @@
---
name: sora-video
description: Generate AI videos with OpenAI Sora via AceDataCloud API. Use when creating videos from text prompts, generating videos from reference images, or using character references from existing videos. Supports text-to-video, image-to-video, and character-driven generation with multiple models and resolutions.
license: Apache-2.0
metadata:
author: acedatacloud
version: "1.0"
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-sora for tool-use.
---
# Sora Video Generation
Generate AI videos through AceDataCloud's OpenAI Sora API.
## Authentication
```bash
export ACEDATACLOUD_API_TOKEN="your-token-here"
```
## Quick Start
```bash
curl -X POST https://api.acedata.cloud/sora/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "a golden retriever running on a beach at sunset", "model": "sora-2", "wait": true}'
```
## Models
| Model | Duration | Quality | Best For |
|-------|----------|---------|----------|
| `sora-2` | 10–15s | Standard | Most tasks (default) |
| `sora-2-pro` | 10–25s | Higher | Premium quality, longer videos |
## Workflows
### 1. Text-to-Video
```json
POST /sora/videos
{
"prompt": "a busy Tokyo street at night with neon signs reflecting in rain puddles",
"model": "sora-2",
"size": "small",
"duration": 10,
"orientation": "landscape"
}
```
### 2. Image-to-Video
Use reference images to guide generation.
```json
POST /sora/videos
{
"prompt": "the scene gradually comes alive with gentle motion",
"image_urls": ["https://example.com/scene.jpg"],
"model": "sora-2",
"orientation": "landscape"
}
```
### 3. Character-Driven Video
Extract a character from an existing video and use them in a new scene.
```json
POST /sora/videos
{
"prompt": "the character walks through a futuristic city",
"character_url": "https://example.com/source-video.mp4",
"character_start": 2.0,
"character_end": 5.0,
"model": "sora-2-pro"
}
```
## Parameters
| Parameter | Values | Description |
|-----------|--------|-------------|
| `size` | `"small"`, `"large"` | Video resolution |
| `duration` | `10`, `15`, `25` | Duration in seconds (25 only with sora-2-pro) |
| `orientation` | `"landscape"` (16:9), `"portrait"` (9:16), `"square"` (1:1) | Video orientation |
## Task Polling
```json
POST /sora/tasks
{"task_id": "your-task-id"}
```
States: `pending` → `succeeded` or `failed`.
## MCP Server
```bash
pip install mcp-sora
```
Or hosted: `https://sora.mcp.acedata.cloud/mcp`
Key tools: `sora_generate_video`, `sora_generate_video_from_image`, `sora_generate_video_with_character`
## Gotchas
- Duration of **25 seconds** is only available with `sora-2-pro` model
- `size: "large"` produces higher resolution but costs more and takes longer
- Character-driven generation requires `character_start` and `character_end` timestamps (in seconds) from the source video
- `orientation` sets the aspect ratio — use `"portrait"` for mobile-first content
- Task states use `"succeeded"` (not "completed") — check for this value when polling
skills/suno-music/SKILL.md
+177
View File
@@ -0,0 +1,177 @@
---
name: suno-music
description: Generate AI music with Suno via AceDataCloud API. Use when creating songs from text prompts, generating lyrics, extending tracks, creating covers, extracting vocals, managing voice personas, or any music generation task. Supports text-to-music, custom styles, multi-format output (MP3, WAV, MIDI, MP4), and vocal separation.
license: Apache-2.0
metadata:
author: acedatacloud
version: "1.0"
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-suno for tool-use.
---
# Suno Music Generation
Generate AI-powered music through AceDataCloud's Suno API.
## Authentication
```bash
export ACEDATACLOUD_API_TOKEN="your-token-here"
# Get your token at https://platform.acedata.cloud
```
## Quick Start — Generate a Song
```bash
curl -X POST https://api.acedata.cloud/suno/audios \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "a happy pop song about coding", "model": "chirp-v4-5", "wait": true}'
```
## Available Models
| Model | Best For |
|-------|---------|
| `chirp-v5` | Latest, highest quality |
| `chirp-v4-5-plus` | Enhanced v4.5 |
| `chirp-v4-5` | Good balance of quality and speed |
| `chirp-v4` | Fast, reliable |
| `chirp-v3-5` | Legacy, stable |
## Core Workflows
### 1. Quick Generation (Inspiration Mode)
Generate a song from a text description. Suno creates lyrics, style, and music automatically.
```json
POST /suno/audios
{
"prompt": "an upbeat electronic track about the future of AI",
"model": "chirp-v4-5",
"instrumental": false
}
```
### 2. Custom Generation (Full Control)
Provide your own lyrics, title, and style for precise control.
```json
POST /suno/audios
{
"action": "custom",
"lyric": "[Verse]\nCode is poetry in motion\n[Chorus]\nWe build the future tonight",
"title": "Digital Dreams",
"style": "Synthwave, Electronic, Dreamy",
"model": "chirp-v4-5",
"vocal_gender": "f"
}
```
### 3. Extend a Song
Continue an existing song from a specific timestamp with new lyrics.
```json
POST /suno/audios
{
"action": "extend",
"audio_id": "existing-audio-id",
"lyric": "[Bridge]\nNew section lyrics here",
"continue_at": 120.0,
"style": "Same style as original"
}
```
### 4. Cover / Remix
Create a new version of an existing song in a different style.
```json
POST /suno/audios
{
"action": "cover",
"audio_id": "existing-audio-id",
"style": "Jazz, Acoustic, Mellow"
}
```
### 5. Full Song Creation Workflow
For best results follow this multi-step workflow:
1. **Generate lyrics** — `POST /suno/lyrics` with a topic/prompt
2. **Optimize style** — `POST /suno/style` to refine style description
3. **Generate music** — `POST /suno/audios` with custom action, lyrics + style
4. **Poll task** — `POST /suno/tasks` with task_id until status is complete
5. **Optional: Extend** — Use extend action to add more sections
6. **Optional: Concat** — Use concat action to merge extended segments
7. **Optional: Convert** — Get WAV (`/suno/wav`), MIDI (`/suno/midi`), or MP4 (`/suno/mp4`)
## Auxiliary Endpoints
| Endpoint | Method | Purpose |
|----------|--------|---------|
| `/suno/lyrics` | POST | Generate structured lyrics from a prompt |
| `/suno/style` | POST | Optimize/refine a style description |
| `/suno/mashup-lyrics` | POST | Combine two sets of lyrics |
| `/suno/mp4` | POST | Get MP4 video version of a song |
| `/suno/wav` | POST | Convert to lossless WAV format |
| `/suno/midi` | POST | Extract MIDI data for DAW editing |
| `/suno/vox` | POST | Extract vocal track (stem separation) |
| `/suno/timing` | POST | Get word-level timing/subtitles |
| `/suno/persona` | POST | Save a vocal style as a reusable persona |
| `/suno/upload` | POST | Upload external audio for extend/cover |
| `/suno/tasks` | POST | Query task status and results |
## Task Polling
All generation is async. Either use `"wait": true` for synchronous mode, or poll:
```json
POST /suno/tasks
{"task_id": "your-task-id"}
```
Poll every 3–5 seconds until `status` is `"complete"`.
## Lyrics Format
Use section markers in square brackets:
```
[Verse 1]
Your verse lyrics here
[Chorus]
Catchy chorus lyrics
[Bridge]
Bridge section
[Outro]
Ending lyrics
```
## MCP Server Integration
For tool-use with Claude/Copilot, install the MCP server:
```bash
pip install mcp-suno
```
Or use the hosted endpoint: `https://suno.mcp.acedata.cloud/mcp`
Key tools: `suno_generate_music`, `suno_generate_custom_music`, `suno_extend_music`, `suno_cover_music`, `suno_generate_lyrics`, `suno_optimize_style`
## Gotchas
- All generation is **async** — always poll `/suno/tasks` or use `"wait": true`
- Lyrics max ~3000 characters. For longer songs, use the **extend** workflow
- Style tags are descriptive phrases, not enum values (e.g., "Synthwave, Electronic, Dreamy")
- `vocal_gender` ("f"/"m") is only supported on v4.5+ models
- The `concat` action merges extended song segments — requires audio_id of the extended track
- `persona` requires an existing audio_id to extract the vocal reference from
- Upload external audio via `/suno/upload` before using it with extend/cover
skills/veo-video/SKILL.md
+114
View File
@@ -0,0 +1,114 @@
---
name: veo-video
description: Generate AI videos with Google Veo via AceDataCloud API. Use when creating videos from text descriptions, animating still images into video, or converting lower-resolution results to full 1080p. Supports Veo 2, Veo 3, and Veo 3.1 models.
license: Apache-2.0
metadata:
author: acedatacloud
version: "1.0"
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-veo for tool-use.
---
# Veo Video Generation
Generate AI videos through AceDataCloud's Google Veo API.
## Authentication
```bash
export ACEDATACLOUD_API_TOKEN="your-token-here"
```
## Quick Start
```bash
curl -X POST https://api.acedata.cloud/veo/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "a whale breaching in slow motion at golden hour", "model": "veo-3", "wait": true}'
```
## Models
| Model | Duration | Audio | Best For |
|-------|----------|-------|----------|
| `veo-2` | 5–8s | No | Fast, cost-effective generation |
| `veo-3` | 8s | Yes (native) | Full audiovisual generation |
| `veo-3.1` | 8s | Yes (native) | Latest model, highest quality |
## Workflows
### 1. Text-to-Video
```json
POST /veo/videos
{
"prompt": "cinematic aerial shot of the Northern Lights over Iceland",
"model": "veo-3",
"aspect_ratio": "16:9",
"duration": 8
}
```
### 2. Image-to-Video
Animate a still image into video.
```json
POST /veo/videos
{
"prompt": "the scene gently comes to life with wind and subtle motion",
"image_url": "https://example.com/landscape.jpg",
"model": "veo-2",
"aspect_ratio": "16:9"
}
```
### 3. Upscale to 1080p
Convert a generated video to full 1080p resolution.
```json
POST /veo/videos/1080p
{
"video_url": "https://example.com/generated-video.mp4",
"model": "veo-3"
}
```
## Parameters
| Parameter | Values | Description |
|-----------|--------|-------------|
| `model` | `"veo-2"`, `"veo-3"`, `"veo-3.1"` | Model to use |
| `aspect_ratio` | `"16:9"`, `"9:16"` | Video aspect ratio |
| `duration` | `5` – `8` | Duration in seconds |
| `generate_audio` | `true` / `false` | Enable/disable audio (veo-3, veo-3.1 default to true) |
| `enhance_prompt` | `true` / `false` | Let the model expand your prompt for better results |
## Task Polling
```json
POST /veo/tasks
{"task_id": "your-task-id"}
```
States: `pending` → `succeeded` or `failed`.
## MCP Server
```bash
pip install mcp-veo
```
Or hosted: `https://veo.mcp.acedata.cloud/mcp`
Key tools: `veo_generate_video`, `veo_generate_video_from_image`, `veo_get_1080p_video`
## Gotchas
- Veo 3 and 3.1 generate **native audio** — use `generate_audio: false` to suppress
- The 1080p endpoint (`/veo/videos/1080p`) only upscales previously generated videos
- `enhance_prompt` can significantly improve results but may deviate from literal interpretation
- Veo 2 does NOT support audio generation
- Duration is capped at 8 seconds for all models
- Task states use `"succeeded"` (not "completed") — check for this value when polling
template/SKILL.md
+31
View File
@@ -0,0 +1,31 @@
---
name: template-skill
description: A template for creating new AceDataCloud Agent Skills. Copy this directory and customize.
license: Apache-2.0
metadata:
author: acedatacloud
version: "1.0"
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable.
---
# Template Skill
Replace this with your skill instructions.
## Authentication
All AceDataCloud API calls require a Bearer token:
```bash
export ACEDATACLOUD_API_TOKEN="your-token-here"
```
## Workflow
1. Step one
2. Step two
3. Step three
## Gotchas
- List non-obvious behaviors here