@acedatacloud/skills 2026.406.0

package/skills/producer-music/SKILL.md

@@ -0,0 +1,198 @@
+---
+name: producer-music
+description: Generate AI music with Producer via AceDataCloud API. Use when creating songs, generating lyrics, extending tracks, creating covers, swapping vocals/instrumentals, replacing song sections, or uploading reference audio. Supports custom lyrics, instrumental-only mode, and multiple creative actions.
+license: Apache-2.0
+metadata:
+  author: acedatacloud
+  version: "1.0"
+compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable.
+---
+
+# Producer Music Generation
+
+Generate AI music through AceDataCloud's Producer API.
+
+> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
+
+## Quick Start
+
+```bash
+curl -X POST https://api.acedata.cloud/producer/audios \
+  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"action": "generate", "prompt": "upbeat electronic dance track with synth leads"}'
+```
+
+> **Async:** All generation is async. See [async task polling](../_shared/async-tasks.md). Poll via `POST /producer/tasks` with `{"id": "..."}` every 3-5 seconds.
+
+## Models
+
+| Model | Notes |
+|-------|-------|
+| `FUZZ-2.0 Pro` | Default, highest quality |
+| `FUZZ-2.0` | Standard quality |
+| `FUZZ-2.0 Raw` | Raw output variant |
+| `FUZZ-1.1 Pro` | Pro v1.1 |
+| `FUZZ-1.0 Pro` | Pro v1.0 |
+| `FUZZ-1.0` | v1.0 |
+| `FUZZ-1.1` | v1.1 |
+| `FUZZ-0.8` | Legacy |
+
+## Actions
+
+| Action | Description |
+|--------|-------------|
+| `generate` | Create a new song from prompt or custom lyrics |
+| `cover` | Create a cover version of an existing song |
+| `extend` | Continue a song from a specific timestamp |
+| `replace_section` | Replace a time range in an existing song |
+| `swap_vocals` | Extract and swap vocal tracks |
+| `swap_instrumentals` | Extract and swap instrumental tracks |
+| `variation` | Generate a variation of an existing song |
+| `stems` | Separate a song into stems |
+
+## Workflows
+
+### 1. Generate from Prompt
+
+```json
+POST /producer/audios
+{
+  "action": "generate",
+  "prompt": "chill lo-fi hip hop with rain sounds and soft piano"
+}
+```
+
+### 2. Custom Lyrics Mode
+
+```json
+POST /producer/audios
+{
+  "action": "generate",
+  "custom": true,
+  "title": "Midnight City",
+  "lyric": "[Verse]\nNeon lights reflect on wet streets\n[Chorus]\nMidnight city never sleeps",
+  "instrumental": false
+}
+```
+
+### 3. Instrumental Only
+
+```json
+POST /producer/audios
+{
+  "action": "generate",
+  "prompt": "epic orchestral soundtrack for a movie trailer",
+  "instrumental": true
+}
+```
+
+### 4. Extend Song
+
+```json
+POST /producer/audios
+{
+  "action": "extend",
+  "audio_id": "existing-audio-id",
+  "continue_at": 30
+}
+```
+
+### 5. Replace Section
+
+```json
+POST /producer/audios
+{
+  "action": "replace_section",
+  "audio_id": "existing-audio-id",
+  "replace_section_start": 15,
+  "replace_section_end": 30
+}
+```
+
+### 6. Separate into Stems
+
+```json
+POST /producer/audios
+{
+  "action": "stems",
+  "audio_id": "existing-audio-id"
+}
+```
+
+### 7. Generate Lyrics
+
+```json
+POST /producer/lyrics
+{
+  "prompt": "a love song about stargazing on a summer night"
+}
+```
+
+### 8. Get WAV / Video
+
+```json
+POST /producer/wav
+{"audio_id": "your-audio-id"}
+
+POST /producer/videos
+{"audio_id": "your-audio-id"}
+```
+
+### 9. Upload Reference Audio
+
+```json
+POST /producer/upload
+{
+  "audio_url": "https://example.com/reference.mp3"
+}
+```
+
+## Parameters
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `action` | string | See actions table |
+| `prompt` | string | Song description (for non-custom mode) |
+| `model` | string | Model (e.g., `"FUZZ-2.0 Pro"`) |
+| `custom` | boolean | Enable custom lyrics mode |
+| `instrumental` | boolean | Pure instrumental (no vocals) |
+| `title` | string | Song title |
+| `lyric` | string | Custom lyrics with `[Verse]`, `[Chorus]` tags |
+| `audio_id` | string | Existing audio ID (for edit actions) |
+| `continue_at` | number | Seconds — where to extend from |
+| `replace_section_start` | number | Start time of section to replace |
+| `replace_section_end` | number | End time of section to replace |
+| `lyrics_strength` | 0-1 | Lyrics adherence (default: 0.7) |
+| `sound_strength` | 0.2-1 | Sound quality weight (default: 0.7) |
+| `weirdness` | 0-1 | Creative randomness (default: 0.5) |
+| `seed` | string | Seed for reproducibility |
+
+## Response Structure
+
+```json
+{
+  "data": [
+    {
+      "id": "audio-id",
+      "audio_url": "https://cdn.example.com/song.mp3",
+      "video_url": "https://cdn.example.com/video.mp4",
+      "image_url": "https://cdn.example.com/cover.jpg",
+      "title": "Song Title",
+      "lyric": "full lyrics...",
+      "style": "electronic, dance",
+      "model": "FUZZ-2.0 Pro"
+    }
+  ]
+}
+```
+
+## Gotchas
+
+- Use `[Verse]`, `[Chorus]`, `[Bridge]`, `[Outro]` tags in custom lyrics
+- `continue_at` is in **seconds** — the song extends from that point
+- `replace_section_start` / `replace_section_end` define the time range to regenerate
+- `weirdness` at 0 = predictable, at 1 = highly experimental
+- Upload a reference audio via `/producer/upload` to get an audio ID for use with `cover` or `extend`
+- WAV and video downloads are separate endpoints — call them after the main generation completes
+- **CRITICAL:** Check the `state` field in task responses — 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

package/skills/seedance-video/SKILL.md

@@ -0,0 +1,148 @@
+---
+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, aspect ratio, duration, and optional audio generation.
+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.
+
+> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
+
+## Quick Start
+
+```bash
+curl -X POST https://api.acedata.cloud/seedance/videos \
+  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"model": "doubao-seedance-1-0-pro-250528", "content": [{"type": "text", "text": "a dancer performing contemporary ballet in a misty forest"}], "callback_url": "https://api.acedata.cloud/health"}'
+```
+
+> **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /seedance/tasks` with `{"task_id": "..."}`.
+This returns a task ID immediately. Poll for the result:
+
+```bash
+curl -X POST https://api.acedata.cloud/seedance/tasks \
+  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"task_id": "<task_id from above>"}'
+```
+
+## Models
+
+| Model | Type | Best For |
+|-------|------|----------|
+| `doubao-seedance-1-0-pro-250528` | Text+Image-to-Video | General-purpose, reliable quality |
+| `doubao-seedance-1-0-pro-fast-251015` | Text+Image-to-Video | Faster Pro generation |
+| `doubao-seedance-1-5-pro-251215` | Text+Image-to-Video | Latest model, highest quality, audio support |
+| `doubao-seedance-1-0-lite-t2v-250428` | Text-to-Video only | Lightweight text-to-video |
+| `doubao-seedance-1-0-lite-i2v-250428` | Image-to-Video only | Lightweight image-to-video |
+
+## Workflows
+
+### 1. Text-to-Video
+
+Pass a text content item in the `content` array.
+
+```json
+POST /seedance/videos
+{
+  "model": "doubao-seedance-1-0-pro-250528",
+  "content": [
+    {"type": "text", "text": "a street dancer doing breakdancing moves in an urban setting"}
+  ],
+  "resolution": "1080p",
+  "ratio": "16:9",
+  "duration": 5
+}
+```
+
+### 2. Image-to-Video
+
+Include an image content item (with an optional `role`) alongside the text.
+
+```json
+POST /seedance/videos
+{
+  "model": "doubao-seedance-1-5-pro-251215",
+  "content": [
+    {"type": "text", "text": "the person starts dancing gracefully"},
+    {
+      "type": "image_url",
+      "role": "first_frame",
+      "image_url": {"url": "https://example.com/dancer.jpg"}
+    }
+  ],
+  "resolution": "720p",
+  "duration": 5
+}
+```
+
+Image roles:
+- `first_frame` — image is used as the opening frame
+- `last_frame` — image is used as the closing frame
+- `reference_image` — image is used as a style/content reference
+
+### 3. First-frame + Last-frame
+
+Provide both a start and end frame image:
+
+```json
+POST /seedance/videos
+{
+  "model": "doubao-seedance-1-0-pro-250528",
+  "content": [
+    {"type": "text", "text": "smooth transition between two scenes"},
+    {"type": "image_url", "role": "first_frame", "image_url": {"url": "https://example.com/start.jpg"}},
+    {"type": "image_url", "role": "last_frame", "image_url": {"url": "https://example.com/end.jpg"}}
+  ]
+}
+```
+
+## Parameters
+
+| Parameter | Values | Description |
+|-----------|--------|-------------|
+| `model` | see Models table | Model to use (required) |
+| `content` | array | Input items: text and/or image_url objects (required) |
+| `resolution` | `"480p"`, `"720p"`, `"1080p"` | Output resolution (default: 720p for pro, 480p for lite) |
+| `ratio` | `"16:9"`, `"4:3"`, `"1:1"`, `"3:4"`, `"9:16"`, `"21:9"`, `"adaptive"` | Aspect ratio (default: 16:9) |
+| `duration` | `2` – `12` | Duration in seconds |
+| `frames` | 29–289 (must satisfy 25+4n) | Frame count — mutually exclusive with `duration` |
+| `seed` | -1 to 4294967295 | Seed for reproducible results (-1 = random) |
+| `generate_audio` | `true` / `false` | Generate audio (only supported by `doubao-seedance-1-5-pro-251215`) |
+| `camerafixed` | `true` / `false` | Fix the camera position during generation |
+| `watermark` | `true` / `false` | Add a watermark to the generated video |
+| `return_last_frame` | `true` / `false` | Return the last frame of the generated video |
+| `service_tier` | `"default"`, `"flex"` | Processing tier (default: default) |
+| `execution_expires_after` | number | Task timeout threshold in seconds |
+
+## Inline Parameter Syntax
+
+You can also embed generation parameters directly in the text prompt using the `--param value` syntax:
+
+```
+A kitten yawning at the camera. --rs 720p --rt 16:9 --dur 5 --fps 24 --seed 42
+```
+
+Supported inline params: `--rs` (resolution), `--rt` (ratio), `--dur` (duration), `--frames`, `--fps` (24 only), `--seed`, `--cf` (camera_fixed), `--wm` (watermark).
+
+## Gotchas
+
+- Model names use the `doubao-*` convention (e.g. `doubao-seedance-1-0-pro-250528`) — old short names like `seedance-1.0` are not valid
+- The `content` array replaces the old `prompt` + `image_url` fields; always use `content`
+- Image and text scenarios are mutually exclusive per content item — each item has either `text` or `image_url`, not both
+- `first_frame`, `last_frame`, and `reference_image` roles are mutually exclusive scenarios — pick one pattern per request
+- `generate_audio: true` is only supported by `doubao-seedance-1-5-pro-251215`; other models ignore this field
+- Lite models are split: `*-lite-t2v-*` only accepts text, `*-lite-i2v-*` only accepts image-to-video
+- Resolution options are `480p`, `720p`, `1080p` — there is no 360p or 540p
+- `service_tier` values are `"default"` and `"flex"` (not "standard"/"premium")
+- Duration range is **2–12 seconds** — values outside this range will fail
+- Task states use `"succeeded"` (not "completed") — check for this value when polling
+
+> **MCP:** `pip install mcp-seedance` | Hosted: `https://seedance.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)

package/skills/seedream-image/SKILL.md

@@ -0,0 +1,120 @@
+---
+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, or working with high-resolution outputs. Supports Seedream 3.0 T2I, 4.0, 4.5, 5.0, and SeedEdit 3.0 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.
+
+> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
+
+## 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": "doubao-seedream-5-0-260128"}'
+```
+
+> **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /seedream/tasks` with `{"id": "..."}`.
+## Models
+
+| Model | Version | Best For |
+|-------|---------|----------|
+| `doubao-seedream-5-0-260128` | Seedream 5.0 | Latest, highest quality (default) |
+| `doubao-seedream-4-5-251128` | Seedream 4.5 | High quality, balanced |
+| `doubao-seedream-4-0-250828` | Seedream 4.0 | Reliable generation |
+| `doubao-seedream-3-0-t2i-250415` | Seedream 3.0 T2I | Text-to-image, precise prompt following |
+| `doubao-seededit-3-0-i2i-250628` | SeedEdit 3.0 | Image-to-image editing |
+
+## Workflows
+
+### 1. Text-to-Image
+
+```json
+POST /seedream/images
+{
+  "prompt": "a serene Japanese garden with cherry blossoms and a red bridge",
+  "model": "doubao-seedream-5-0-260128",
+  "size": "1K"
+}
+```
+
+### 2. Image Editing (Image-to-Image)
+
+Edit an existing image by providing the source image URL(s) and a descriptive prompt. Use the `doubao-seededit-3-0-i2i-250628` model for best editing results.
+
+```json
+POST /seedream/images
+{
+  "prompt": "change the sky to a golden sunset",
+  "model": "doubao-seededit-3-0-i2i-250628",
+  "image": ["https://example.com/photo.jpg"]
+}
+```
+
+### 3. Async Generation with Task Polling
+
+Pass a `callback_url` to receive results asynchronously via webhook, or poll `/seedream/tasks` for the result:
+
+```json
+POST /seedream/images
+{
+  "prompt": "an epic fantasy landscape",
+  "model": "doubao-seedream-5-0-260128",
+  "callback_url": "https://api.acedata.cloud/health"
+}
+```
+
+Poll the returned `task_id`:
+
+```json
+POST /seedream/tasks
+{"id": "<task_id>"}
+```
+
+## Parameters
+
+### Generation
+
+| Parameter | Values | Description |
+|-----------|--------|-------------|
+| `model` | see Models table | Model to use (required) |
+| `prompt` | string | Image description (required) |
+| `size` | `"1K"`, `"2K"`, `"3K"`, `"4K"`, `"adaptive"` | Output resolution (e.g. `1K`=1024px, `2K`=2048px); `3K` only for Seedream 5.0 |
+| `seed` | integer [-1, 2147483647] | Seed for reproducibility (Seedream 3.0 T2I / SeedEdit 3.0 only) |
+| `guidance_scale` | number [1, 10] | Prompt adherence strength (3.0 models only; T2I default 2.5, edit default 5.5) |
+| `sequential_image_generation` | `"auto"`, `"disabled"` | Generate related images in sequence (5.0, 4.5, 4.0 only) |
+| `stream` | boolean | Stream images as they're generated (5.0, 4.5, 4.0 only) |
+| `watermark` | boolean | Add AI-generated watermark (default: true) |
+| `output_format` | `"jpeg"`, `"png"` | Output file format (Seedream 5.0 only; default: jpeg) |
+| `response_format` | `"url"`, `"b64_json"` | Response format (default: url) |
+| `tools` | array | Enable tools, e.g. `[{"type": "web_search"}]` (Seedream 5.0 only) |
+| `callback_url` | string | Webhook URL for async delivery; returns `task_id` immediately |
+
+### Editing
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `image` | Yes (for editing) | Array of image URLs or base64 strings (max 10MB each) |
+| `prompt` | Yes | Describe the desired edit |
+
+## Gotchas
+
+- Model names now use the `doubao-*` naming convention (e.g. `doubao-seedream-5-0-260128`)
+- Image editing uses the same `/seedream/images` endpoint with the `image` array parameter (no separate edit endpoint)
+- `size` replaces separate `width`/`height` params; use `"1K"` for 1024×1024, `"2K"` for 2048×2048, etc.
+- `3K` size is only supported by Seedream 5.0; `adaptive` selects the best aspect ratio automatically
+- `seed` only works with `doubao-seedream-3-0-t2i-250415` and `doubao-seededit-3-0-i2i-250628`
+- `guidance_scale` is only available for the 3.0-series models
+- `stream` and `sequential_image_generation` are only available for Seedream 5.0, 4.5, and 4.0
+- Pass `callback_url` to get a `task_id` immediately and avoid blocking; poll `/seedream/tasks` for the result — use `"https://api.acedata.cloud/health"` as a placeholder to force async mode without a real webhook
+
+> **MCP:** `pip install mcp-seedream` | Hosted: `https://seedream.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)

package/skills/short-url/SKILL.md

@@ -0,0 +1,60 @@
+---
+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.
+
+> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
+
+## Quick Start
+
+```bash
+curl -X POST https://api.acedata.cloud/shorturl \
+  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"content": "https://example.com/very-long-url-path?with=params"}'
+```
+
+## Workflows
+
+### 1. Create a Short URL
+
+```json
+POST /shorturl
+{
+  "content": "https://example.com/article/2024/awesome-content"
+}
+```
+
+Response:
+
+```json
+{
+  "data": {
+    "url": "https://suro.id/abc123"
+  },
+  "success": true
+}
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `content` | Yes | The original long URL to shorten |
+
+## Gotchas
+
+- Short URLs use the `suro.id` domain
+- Results are returned synchronously — no task polling needed
+- The `content` field must be a valid URL to shorten
+
+> **MCP:** `pip install mcp-shorturl` | Hosted: `https://short-url.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)

package/skills/sora-video/SKILL.md

@@ -0,0 +1,97 @@
+---
+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.
+
+> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
+
+## 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", "callback_url": "https://api.acedata.cloud/health"}'
+```
+
+> **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /sora/tasks` with `{"task_id": "..."}`.
+
+## 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 |
+|-----------|--------|-------------|
+| `model` | `"sora-2"`, `"sora-2-pro"` | Model to use (required) |
+| `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 |
+| `version` | `"1.0"` | API version — version `1.0` enables duration up to 25s, orientation, character references, and image inputs |
+
+## 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
+
+> **MCP:** `pip install mcp-sora` | Hosted: `https://sora.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)