@acedatacloud/skills 2026.406.0

package/skills/suno-music/SKILL.md

@@ -0,0 +1,187 @@
+---
+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.
+
+> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
+
+## Quick Start
+
+```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-v5-5", "callback_url": "https://api.acedata.cloud/health"}'
+```
+
+> **Async:** All generation is async. See [async task polling](../_shared/async-tasks.md). Poll via `POST /suno/tasks` with `{"task_id": "..."}` every 3-5 seconds.
+
+## Available Models
+
+| Model | Best For |
+|-------|---------|
+| `chirp-v5-5` | Latest, highest quality |
+| `chirp-v5` | High 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 |
+| `chirp-v3-0` | Legacy |
+
+## 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-v5-5",
+  "instrumental": false
+}
+```
+
+### 2. Custom Generation (Full Control)
+
+Provide your own lyrics, title, and style for precise control.
+
+```json
+POST /suno/audios
+{
+  "custom": true,
+  "lyric": "[Verse]\nCode is poetry in motion\n[Chorus]\nWe build the future tonight",
+  "title": "Digital Dreams",
+  "style": "Synthwave, Electronic, Dreamy",
+  "model": "chirp-v5-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`)
+
+## Available Actions
+
+| Action | Description |
+|--------|-------------|
+| `generate` | Generate from prompt (default) |
+| `extend` | Continue an existing audio from a timestamp |
+| `upload_extend` | Upload external audio, then extend it |
+| `upload_cover` | Upload external audio, then create a cover |
+| `concat` | Concatenate extended segments into one track |
+| `cover` | Copy the style of an existing audio |
+| `artist_consistency` | Generate in a custom singer's style |
+| `artist_consistency_vox` | Artist consistency with vocal focus |
+| `stems` | Separate a track into stems |
+| `all_stems` | Separate into all available stems |
+| `replace_section` | Replace a specific time range in a song |
+| `underpainting` | Add accompaniment to an uploaded song |
+| `overpainting` | Add vocals to an uploaded song |
+| `remaster` | Remaster an existing audio |
+| `mashup` | Blend multiple audio IDs together |
+| `samples` | Add samples to an uploaded song |
+
+## Auxiliary Endpoints
+
+| Endpoint | Method | Purpose |
+|----------|--------|---------|
+| `/suno/lyrics` | POST | Generate structured lyrics from a prompt (`model`: `"default"` or `"remi-v1"`) |
+| `/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 |
+
+## Advanced Parameters
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `lyric_prompt` | string | Prompt for auto-generating lyrics (used when `custom: true` without explicit `lyric`) |
+| `style_negative` | string | Style tags to avoid (e.g., `"heavy metal, distortion"`) |
+| `style_influence` | number | Strength of style influence (advanced custom mode, v5+ only) |
+| `audio_weight` | number | Weight for audio reference when covering (advanced, v5+ only) |
+
+## Lyrics Format
+
+Use section markers in square brackets:
+
+```
+[Verse 1]
+Your verse lyrics here
+
+[Chorus]
+Catchy chorus lyrics
+
+[Bridge]
+Bridge section
+
+[Outro]
+Ending lyrics
+```
+
+## Gotchas
+
+- All generation is **async** — always set `"callback_url"` to get a `task_id` immediately, then poll `/suno/tasks`
+- **CRITICAL:** Check the `state` field — only `state: "complete"` with `success: true` means done. During `pending`, the API may return intermediate `audio_url` values (streaming previews). Do NOT stop polling just because `audio_url` is non-empty
+- 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
+- `variation_category` ("high"/"normal"/"subtle") is only supported on v5+ 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
+
+> **MCP:** `pip install mcp-suno` | Hosted: `https://suno.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)

package/skills/veo-video/SKILL.md

@@ -0,0 +1,112 @@
+---
+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 upscaling to 1080p. Supports Veo 2, Veo 3, and Veo 3.1 models including fast variants.
+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.
+
+> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
+
+## Quick Start
+
+```bash
+curl -X POST https://api.acedata.cloud/veo/videos \
+  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"action": "text2video", "prompt": "a whale breaching in slow motion at golden hour", "model": "veo3", "callback_url": "https://api.acedata.cloud/health"}'
+```
+
+> **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /veo/tasks` with `{"id": "..."}`.
+This returns a task ID immediately. Poll for the result:
+
+```bash
+curl -X POST https://api.acedata.cloud/veo/tasks \
+  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"id": "<task_id from above>"}'
+```
+
+## Models
+
+| Model | Audio | Best For |
+|-------|-------|----------|
+| `veo2` | No | Cost-effective generation |
+| `veo2-fast` | No | Fast, cost-effective generation (default) |
+| `veo3` | Yes (native) | Full audiovisual generation |
+| `veo3-fast` | Yes (native) | Faster audiovisual generation |
+| `veo31` | Yes (native) | Veo 3.1, highest quality |
+| `veo31-fast` | Yes (native) | Veo 3.1 fast variant |
+| `veo31-fast-ingredient` | Yes (native) | Veo 3.1 fast, ingredient mode |
+
+## Workflows
+
+### 1. Text-to-Video
+
+```json
+POST /veo/videos
+{
+  "action": "text2video",
+  "prompt": "cinematic aerial shot of the Northern Lights over Iceland",
+  "model": "veo3",
+  "resolution": "1080p"
+}
+```
+
+### 2. Image-to-Video
+
+Animate still images into video.
+
+```json
+POST /veo/videos
+{
+  "action": "image2video",
+  "prompt": "the scene gently comes to life with wind and subtle motion",
+  "image_urls": ["https://example.com/landscape.jpg"],
+  "model": "veo2",
+  "aspect_ratio": "16:9"
+}
+```
+
+### 3. Upscale to 1080p
+
+Convert a previously generated video to full 1080p resolution.
+
+```json
+POST /veo/videos
+{
+  "action": "get1080p",
+  "video_id": "your-video-id",
+  "model": "veo3"
+}
+```
+
+## Parameters
+
+| Parameter | Values | Description |
+|-----------|--------|-------------|
+| `action` | `"text2video"`, `"image2video"`, `"get1080p"` | Generation mode |
+| `model` | see Models table | Model to use (default: `veo2-fast`) |
+| `resolution` | `"4k"`, `"1080p"`, `"gif"` | Output resolution (default: 720p) |
+| `aspect_ratio` | `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, `"3:4"` | Aspect ratio — only valid for `image2video` |
+| `image_urls` | array of strings | Reference image URLs — only for `image2video` |
+| `video_id` | string | Video to upscale — only for `get1080p` |
+| `translation` | `true` / `false` | Auto-translate prompt to English (default: false) |
+
+## Gotchas
+
+- Veo 3 and 3.1 models generate **native audio** — `veo2`/`veo2-fast` do NOT support audio
+- The `get1080p` action uses `video_id` (from a prior generation), not a URL
+- `aspect_ratio` is **only valid** for the `image2video` action
+- `image_urls` accepts an array — pass one or more image URLs for image-to-video
+- `translation: true` auto-translates Chinese or other non-English prompts before sending to Veo
+- Task polling uses `id` (not `task_id`) in the `/veo/tasks` request body
+- Task states use `"succeeded"` (not "completed") — check for this value when polling
+
+> **MCP:** `pip install mcp-veo` | Hosted: `https://veo.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)

package/skills/wan-video/SKILL.md

@@ -0,0 +1,152 @@
+---
+name: wan-video
+description: Generate AI videos with Wan (Alibaba) via AceDataCloud API. Use when creating videos from text prompts or animating images into video. Supports text-to-video, image-to-video, reference video transfer, multi-resolution (480P-1080P), and optional audio.
+license: Apache-2.0
+metadata:
+  author: acedatacloud
+  version: "1.0"
+compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-wan for tool-use.
+---
+
+# Wan Video Generation
+
+Generate AI videos through AceDataCloud's Wan (Alibaba) API.
+
+> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
+
+## Quick Start
+
+```bash
+curl -X POST https://api.acedata.cloud/wan/videos \
+  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"action": "text2video", "prompt": "a dolphin jumping through ocean waves at golden hour", "model": "wan2.6-t2v"}'
+```
+
+> **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /wan/tasks` with `{"task_id": "..."}`.
+## Models
+
+| Model | Type | Best For |
+|-------|------|----------|
+| `wan2.6-t2v` | Text-to-Video | Creating video from text description |
+| `wan2.6-i2v` | Image-to-Video | Animating a still image into video |
+| `wan2.6-r2v` | Reference Video-to-Video | Character extraction and transfer from reference video |
+| `wan2.6-i2v-flash` | Image-to-Video (Fast) | Quick image-to-video generation |
+
+## Workflows
+
+### 1. Text-to-Video
+
+```json
+POST /wan/videos
+{
+  "action": "text2video",
+  "prompt": "a time-lapse of flowers blooming in a meadow",
+  "model": "wan2.6-t2v",
+  "resolution": "720P",
+  "duration": 5
+}
+```
+
+### 2. Image-to-Video
+
+Animate a still image into a video clip.
+
+```json
+POST /wan/videos
+{
+  "action": "image2video",
+  "prompt": "gentle wind blows through the scene",
+  "model": "wan2.6-i2v",
+  "image_url": "https://example.com/landscape.jpg",
+  "resolution": "720P",
+  "duration": 5
+}
+```
+
+### 3. Image-to-Video (Flash)
+
+Faster image-to-video generation with reduced latency.
+
+```json
+POST /wan/videos
+{
+  "action": "image2video",
+  "prompt": "camera slowly pans across the landscape",
+  "model": "wan2.6-i2v-flash",
+  "image_url": "https://example.com/scene.jpg"
+}
+```
+
+### 4. Reference Video Transfer
+
+Extract characters or timbres from a reference video and transfer them into a new generation.
+
+```json
+POST /wan/videos
+{
+  "action": "text2video",
+  "prompt": "the character walks through a futuristic city at night",
+  "model": "wan2.6-r2v",
+  "reference_video_urls": ["https://example.com/reference.mp4"]
+}
+```
+
+### 5. Multi-Cut Editing
+
+Generate a video with multiple shots rather than a single continuous take.
+
+```json
+POST /wan/videos
+{
+  "action": "text2video",
+  "prompt": "a chef preparing a meal in a busy kitchen",
+  "model": "wan2.6-t2v",
+  "shot_type": "multi",
+  "duration": 10
+}
+```
+
+### 6. Video with Audio
+
+Enable audio generation alongside the video.
+
+```json
+POST /wan/videos
+{
+  "action": "text2video",
+  "prompt": "ocean waves crashing on a rocky shore",
+  "model": "wan2.6-t2v",
+  "audio": true
+}
+```
+
+## Parameters
+
+| Parameter | Required | Values | Description |
+|-----------|----------|--------|-------------|
+| `action` | Yes | `"text2video"`, `"image2video"` | Action type |
+| `prompt` | Yes | string | Scene description |
+| `model` | Yes | `"wan2.6-t2v"`, `"wan2.6-i2v"`, `"wan2.6-r2v"`, `"wan2.6-i2v-flash"` | Model |
+| `image_url` | For image2video | string | Source image URL (required for image-to-video) |
+| `negative_prompt` | No | string (max 500 chars) | Content to exclude from generation |
+| `reference_video_urls` | For r2v | array of strings | Reference videos for character/timbre extraction |
+| `shot_type` | No | `"single"`, `"multi"` | Continuous shot or multi-cut editing |
+| `audio` | No | boolean | Enable audio in the generated video |
+| `audio_url` | No | string | Reference audio URL |
+| `resolution` | No | `"480P"`, `"720P"`, `"1080P"` | Output resolution (default: 720P) |
+| `size` | No | string | The size of the generated video |
+| `duration` | No | `5`, `10`, `15` | Video duration in seconds |
+| `prompt_extend` | No | boolean | Enable LLM-based prompt rewriting |
+| `callback_url` | No | string | Async webhook notification URL |
+
+## Gotchas
+
+- `image_url` is **required** for `wan2.6-i2v` and `wan2.6-i2v-flash` models
+- `reference_video_urls` is used only with `wan2.6-r2v` for character/timbre transfer
+- `negative_prompt` has a maximum length of 500 characters
+- Supported durations are 5, 10, or 15 seconds only
+- Default resolution is 720P; use 1080P for higher quality at increased cost
+- `shot_type: "multi"` produces multi-cut edits rather than a single continuous shot
+
+> **MCP:** `pip install mcp-wan` | Hosted: `https://wan.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)