@acedatacloud/skills 2026.808.0 → 2026.809.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acedatacloud/skills",
-  "version": "2026.808.0",
+  "version": "2026.809.1",
   "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.",
   "keywords": [
     "agent-skills",

package/skills/fish-audio/SKILL.md

@@ -37,7 +37,6 @@ Synchronous responses return a direct audio URL:
 | `POST /fish/tts` | Text-to-speech generation |
 | `GET /fish/model` | Browse/search public Fish reference voices |
 | `GET /fish/model/{id}` | Fetch one reference voice by ID |
-| `POST /fish/model` | Clone a voice — create a reference model from an audio URL |
 | `POST /fish/tasks` | Poll async TTS jobs when `async: true` |
 
 ## Workflows
@@ -97,10 +96,9 @@ Headers:
 |-----------|---------------|-------------|
 | `text` | string | Text to synthesize (required) |
 | `reference_id` | string | Public/reference voice ID from `GET /fish/model` |
-| `format` | `"mp3"`, `"wav"`, `"pcm"`, `"opus"` | Output format |
+| `format` | `"mp3"`, `"wav"`, `"pcm"` | Output format |
 | `sample_rate` | integer | Optional output sample rate |
 | `mp3_bitrate` | `64`, `128`, `192` | MP3 bitrate |
-| `opus_bitrate` | integer | Opus bitrate |
 | `latency` | `"normal"`, `"balanced"` | TTS latency mode |
 | `chunk_length` / `min_chunk_length` | integer | Chunking controls |
 | `temperature`, `top_p`, `repetition_penalty` | number | Sampling controls |
@@ -117,4 +115,3 @@ Headers:
 - Choose the Fish engine with the **`model` request header**, not a JSON `model` field.
 - Use `reference_id` from `GET /fish/model` — not `voice_id`.
 - Synchronous requests return `audio_url` directly; async jobs should be polled via `/fish/tasks`.
-- Voice cloning is `POST /fish/model`. `voices` must be a **single** HTTP(S) audio URL string — not an array, and not a file upload. It returns the `_id` you then pass to `/fish/tts` as `reference_id`.

package/skills/flux-image/SKILL.md

@@ -20,7 +20,7 @@ Generate and edit images through AceDataCloud's Flux API.
 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", "callback_url": "https://api.acedata.cloud/health"}'
+  -d '{"action": "generate", "prompt": "a cat wearing a space helmet, photorealistic", "model": "flux-dev", "callback_url": "https://api.acedata.cloud/health"}'
 ```
 
 > **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /flux/tasks` with `{"id": "..."}`.

package/skills/google-search/SKILL.md

@@ -51,10 +51,10 @@ POST /serp/google
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `query` | string | Search query (required) |
+| `query` | string | Search query (required; must contain non-whitespace text; maximum 2048 characters) |
 | `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") |
+| `country` | string | Non-empty country code (e.g., "us", "uk", "cn", "jp"; maximum 32 characters) |
+| `language` | string | Non-empty language code (e.g., "en", "zh", "ja"; maximum 32 characters) |
 | `range` | string | Time filter (see below) |
 | `number` | int | Number of results per page |
 | `page` | int | Page number for pagination |
@@ -69,6 +69,11 @@ POST /serp/google
 | `qdr:w` | Past week |
 | `qdr:m` | Past month |
 | `qdr:y` | Past year |
+| `h` | Past hour |
+| `d` | Past 24 hours |
+| `w` | Past week |
+| `m` | Past month |
+| `y` | Past year |
 
 ## Response Structure
 

package/skills/kling-video/SKILL.md

@@ -124,7 +124,9 @@ Apply precise camera/motion control from an image + reference video.
 POST /kling/motion
 {
   "image_url": "https://example.com/subject.jpg",
-  "video_url": "https://example.com/motion-reference.mp4"
+  "video_url": "https://example.com/motion-reference.mp4",
+  "mode": "std",
+  "character_orientation": "image"
 }
 ```
 
@@ -186,6 +188,8 @@ POST /kling/talking-photo
 | `voice_id` (`/kling/lip-sync`) | string | Voice preset ID used in `text2video` |
 | `voice_language` (`/kling/lip-sync`) | `"zh"`, `"en"` | TTS language for `text2video` (default `zh`) |
 | `voice_speed` (`/kling/lip-sync`) | number | TTS speaking speed (default `1.0`) |
+| `mode` (`/kling/motion`) | `"std"`, `"pro"` | Motion generation quality mode |
+| `character_orientation` (`/kling/motion`) | `"image"`, `"video"` | Character orientation source |
 | `image_url` (`/kling/talking-photo`) | URL | Source portrait image |
 | `audio_url` (`/kling/talking-photo`) | URL | Driving audio track |
 | `model` (`/kling/talking-photo`) | `"kling-v1"`, `"kling-v1-6"`, `"kling-v2-master"`, `"kling-v2-1-master"`, `"kling-v2-5-turbo"`, `"kling-v2-6"` | Talking-photo model |

package/skills/maestro-video/SKILL.md

@@ -40,7 +40,7 @@ curl -X POST https://api.acedata.cloud/maestro/videos \
   }'
 ```
 
-The response contains a `task_id`. Maestro is asynchronous, so query the task until it reaches `succeeded` or `failed`:
+The successful creation response is HTTP `201` and contains a `task_id`. Maestro is asynchronous, so query the task until it reaches `succeeded` or `failed`:
 
 ```bash
 curl -X POST https://api.acedata.cloud/maestro/tasks \
@@ -230,18 +230,17 @@ On success, inspect the delivered variants:
 
 Treat the fields above as a shape guide. Return fields that are actually present; never fabricate missing captions, covers, durations, or QC scores.
 
-## List Recent Tasks
+## Task Retrieval
 
-The live task endpoint also supports account history:
+Retrieve a task by its required `id`; the only documented action is `retrieve`:
 
 ```bash
 curl -X POST https://api.acedata.cloud/maestro/tasks \
   -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
   -H "Content-Type: application/json" \
-  -d '{"action": "retrieve_batch", "limit": 20}'
+  -d '{"id": "TASK_ID", "action": "retrieve"}'
 ```
 
-Optional Unix timestamp filters are `created_at_min` and `created_at_max`. The authenticated identity determines which tasks are returned; do not supply or trust a body-level user ID.
 
 ## Prompting Guidance
 

package/skills/minimax-video/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: minimax-video
-description: Generate MiniMax H3 videos from text, up to nine reference images, or up to three audio references through AceDataCloud. Use for text-to-video, multi-image video, audio-guided video, and MiniMax H3 task polling.
+description: Generate MiniMax H3 videos from text and optional image, video, or audio references through AceDataCloud. Use for text-to-video, first/last-frame video, multimodal reference video, and MiniMax H3 task polling.
 license: Apache-2.0
 metadata:
   author: acedatacloud
@@ -10,7 +10,7 @@ compatibility: Requires ACEDATACLOUD_API_TOKEN in .env (see _shared/authenticati
 
 # MiniMax H3 Video Generation
 
-Generate 4–15 second videos through `POST https://api.acedata.cloud/minimax/videos`.
+Generate 4–15 second videos through `POST https://api.acedata.cloud/minimax/videos`. Use the V2 multimodal `content` array to supply the prompt and optional reference media.
 
 > **Setup:** See [authentication](../_shared/authentication.md). For long jobs, use [async task polling](../_shared/async-tasks.md) with `POST /minimax/tasks`.
 
@@ -18,70 +18,96 @@ Generate 4–15 second videos through `POST https://api.acedata.cloud/minimax/vi
 
 | Parameter | Values | Default |
 | --- | --- | --- |
-| `model` | `minimax-h3` | `minimax-h3` |
-| `prompt` | non-empty string, max 7000 chars | required |
-| `image_urls` | 1–9 public HTTP(S) URLs | omitted |
-| `audio_urls` | 1–3 public HTTP(S) URLs | omitted |
-| `resolution` | `768P`, `2K` | `2K` |
-| `ratio` | `16:9`, `9:16` | `16:9` |
-| `aigc_watermark` | boolean | false |
-| `duration` | integer 4–15 | 4 |
-| `async` | boolean | false |
+| `model` | `MiniMax-H3` | required |
+| `content` | array of prompt and optional media items | required |
+| `resolution` | `768P`, `2K` | required |
+| `duration` | integer 4–15 | required |
+| `ratio` | `adaptive`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16` | omitted |
 | `callback_url` | public HTTP(S) webhook | omitted |
 
-`prompt` is required in every mode. Audio also requires at least one image. Mode inference is deterministic:
+Each `content` item has a `type` of `text`, `image_url`, `video_url`, or `audio_url`; set the matching field to the text or public URL. Media items use a `role`:
 
-1. `audio_urls` present → audio-guided video
-2. otherwise `image_urls` present → image-to-video
-3. otherwise → text-to-video
+| Role | Use |
+| --- | --- |
+| `first_frame` | Starting image |
+| `last_frame` | Ending image |
+| `reference_image` | Reference image |
+| `reference_video` | Reference video |
+| `reference_audio` | Reference audio |
 
-Public pricing is **$0.057143/s for 768P** and **$0.091429/s for 2K** on the largest package. Failed tasks are not charged.
+Include a `text` item with the generation prompt in every request.
 
 ## Text to video
 
 ```bash
 curl -X POST https://api.acedata.cloud/minimax/videos \
-  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
+  -H "Authorization: ******" \
   -H "Content-Type: application/json" \
   -d '{
-    "model": "minimax-h3",
-    "prompt": "A red fox running through a snowy forest at dawn, low tracking shot",
+    "model": "MiniMax-H3",
+    "content": [
+      {
+        "type": "text",
+        "text": "A red fox running through a snowy forest at dawn, low tracking shot"
+      }
+    ],
     "resolution": "768P",
     "ratio": "16:9",
-    "duration": 4,
-    "async": true
+    "duration": 4
   }'
 ```
 
-## Multi-image video
+## First and last frame video
 
 ```json
 {
-  "model": "minimax-h3",
-  "prompt": "Preserve the character and clothing while the camera slowly pushes in",
-  "image_urls": [
-    "https://cdn.acedata.cloud/b1c82e4937.png",
-    "https://cdn.acedata.cloud/eb75d88a3f.png"
+  "model": "MiniMax-H3",
+  "content": [
+    {
+      "type": "text",
+      "text": "A camera slowly pushes in as the character walks into the sunrise."
+    },
+    {
+      "type": "image_url",
+      "image_url": "https://cdn.acedata.cloud/first-frame.png",
+      "role": "first_frame"
+    },
+    {
+      "type": "image_url",
+      "image_url": "https://cdn.acedata.cloud/last-frame.png",
+      "role": "last_frame"
+    }
   ],
   "resolution": "768P",
   "ratio": "9:16",
-  "duration": 8,
-  "async": true
+  "duration": 8
 }
 ```
 
-## Audio-guided video
+## Reference-guided video
 
 ```json
 {
-  "model": "minimax-h3",
-  "prompt": "A dancer moves naturally to the rhythm",
-  "image_urls": ["https://cdn.acedata.cloud/b1c82e4937.png"],
-  "audio_urls": ["https://cdn.acedata.cloud/6f7d62b18b.wav"],
+  "model": "MiniMax-H3",
+  "content": [
+    {
+      "type": "text",
+      "text": "A dancer moves naturally to the rhythm."
+    },
+    {
+      "type": "image_url",
+      "image_url": "https://cdn.acedata.cloud/reference.png",
+      "role": "reference_image"
+    },
+    {
+      "type": "audio_url",
+      "audio_url": "https://cdn.acedata.cloud/reference.wav",
+      "role": "reference_audio"
+    }
+  ],
   "resolution": "768P",
   "ratio": "9:16",
-  "duration": 8,
-  "async": true
+  "duration": 8
 }
 ```
 
@@ -89,18 +115,18 @@ curl -X POST https://api.acedata.cloud/minimax/videos \
 
 ```bash
 curl -X POST https://api.acedata.cloud/minimax/tasks \
-  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
+  -H "Authorization: ******" \
   -H "Content-Type: application/json" \
   -d '{"action":"retrieve","id":"TASK_ID"}'
 ```
 
-Continue polling about every five seconds until `response.success` is true or an error appears. Use `retrieve_batch` with `ids` to check several tasks in one request.
+Continue polling about every five seconds until the task reaches a terminal state. Use `retrieve_batch` with `ids` to check several tasks, or `delete` with `id` to remove a task. Batch listing also accepts `limit`, `offset`, `created_at_min`, and `created_at_max`.
 
 ## Gotchas
 
 - Do not send `action` to `/minimax/videos`; the API infers the mode from media inputs.
 - `duration` must be an integer, not a decimal.
-- Audio mode requires both `prompt` and at least one `image_urls` entry.
-- Single-image mode uses the image as the first frame; multiple images are references.
-- Use public URLs that the generation service can download.
+- Put the prompt in a `content` item with `type: "text"`; do not send a top-level `prompt`.
+- Use `first_frame`, `last_frame`, and reference roles explicitly; do not rely on item order to determine an image's role.
+- Use public URLs that the generation service can download for every media item.
 - Returned videos are served from AceDataCloud CDN.

package/skills/nano-banana-image/SKILL.md

@@ -1,6 +1,6 @@
 ---
 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, nano-banana-2, nano-banana-pro and their :official variants.
+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, nano-banana-2-lite, nano-banana-2, nano-banana-pro and their :official variants.
 license: Apache-2.0
 metadata:
   author: acedatacloud
@@ -29,9 +29,11 @@ curl -X POST https://api.acedata.cloud/nano-banana/images \
 | Model | Best For |
 |-------|----------|
 | `nano-banana` | Standard image generation (default) |
+| `nano-banana-2-lite` | Fast, lightweight second-generation model |
 | `nano-banana-2` | Improved quality, second generation |
 | `nano-banana-pro` | Highest quality, most detailed output |
 | `nano-banana:official` | Official channel variant of `nano-banana` |
+| `nano-banana-2-lite:official` | Official channel variant of `nano-banana-2-lite` |
 | `nano-banana-2:official` | Official channel variant of `nano-banana-2` |
 | `nano-banana-pro:official` | Official channel variant of `nano-banana-pro` |
 
@@ -69,7 +71,7 @@ POST /nano-banana/images
 | Parameter | Values | Description |
 |-----------|--------|-------------|
 | `action` | `"generate"`, `"edit"` | Operation mode |
-| `model` | `"nano-banana"`, `"nano-banana-2"`, `"nano-banana-pro"`, `"nano-banana:official"`, `"nano-banana-2:official"`, `"nano-banana-pro:official"` | Model to use |
+| `model` | `"nano-banana"`, `"nano-banana-2-lite"`, `"nano-banana-2"`, `"nano-banana-pro"`, `"nano-banana:official"`, `"nano-banana-2-lite:official"`, `"nano-banana-2:official"`, `"nano-banana-pro:official"` | Model to use |
 | `prompt` | string | Image description or editing instruction |
 | `image_urls` | array of strings | Source image URLs (required for edit action) |
 | `aspect_ratio` | `"1:1"`, `"3:2"`, `"2:3"`, `"16:9"`, `"9:16"`, `"4:3"`, `"3:4"` | Output aspect ratio |

package/skills/producer-music/SKILL.md

@@ -20,7 +20,7 @@ Generate AI music through AceDataCloud's Producer API.
 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"}'
+  -d '{"action": "generate", "lyric": "", "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.
@@ -59,6 +59,7 @@ curl -X POST https://api.acedata.cloud/producer/audios \
 POST /producer/audios
 {
   "action": "generate",
+  "lyric": "",
   "prompt": "chill lo-fi hip hop with rain sounds and soft piano"
 }
 ```
@@ -72,6 +73,7 @@ POST /producer/audios
   "custom": true,
   "title": "Midnight City",
   "lyric": "[Verse]\nNeon lights reflect on wet streets\n[Chorus]\nMidnight city never sleeps",
+  "prompt": "nocturnal electronic pop",
   "instrumental": false
 }
 ```
@@ -82,6 +84,7 @@ POST /producer/audios
 POST /producer/audios
 {
   "action": "generate",
+  "lyric": "",
   "prompt": "epic orchestral soundtrack for a movie trailer",
   "instrumental": true
 }
@@ -94,6 +97,8 @@ POST /producer/audios
 {
   "action": "extend",
   "audio_id": "existing-audio-id",
+  "lyric": "",
+  "prompt": "",
   "continue_at": 30
 }
 ```
@@ -105,6 +110,8 @@ POST /producer/audios
 {
   "action": "replace_section",
   "audio_id": "existing-audio-id",
+  "lyric": "",
+  "prompt": "",
   "replace_section_start": 15,
   "replace_section_end": 30
 }
@@ -116,7 +123,9 @@ POST /producer/audios
 POST /producer/audios
 {
   "action": "stems",
-  "audio_id": "existing-audio-id"
+  "audio_id": "existing-audio-id",
+  "lyric": "",
+  "prompt": ""
 }
 ```
 
@@ -152,13 +161,13 @@ POST /producer/upload
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `action` | string | See actions table |
-| `prompt` | string | Song description (for non-custom mode) |
+| `action` | string | Required for every `/producer/audios` request; see actions table |
+| `prompt` | string | Required for every `/producer/audios` request; use an empty string when an edit action does not use a prompt |
 | `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 |
+| `lyric` | string | Required for every `/producer/audios` request; custom lyrics use `[Verse]`, `[Chorus]` tags, otherwise use an empty string |
 | `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 |

package/skills/seedance-video/SKILL.md

@@ -164,7 +164,7 @@ POST /seedance/videos
 | `resolution` | `"480p"`, `"720p"`, `"1080p"`, `"4k"` | Output resolution. `4k` is `doubao-seedance-2-0-260128` (standard) only; `2-0-fast` / `2-0-mini` max out at `720p` (default: 720p for pro/2.0, 480p for lite) |
 | `ratio` | `"16:9"`, `"4:3"`, `"1:1"`, `"3:4"`, `"9:16"`, `"21:9"`, `"adaptive"` | Aspect ratio (default: 16:9) |
 | `duration` | `2` – `15` | Duration in seconds (Seedance 2.0 supports 4–15) |
-| `frames` | 29–361 (must satisfy 25+4n) | Frame count — mutually exclusive with `duration` |
+| `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 (supported by `doubao-seedance-1-5-pro-251215` and the `doubao-seedance-2-0` series; other models ignore it) |
 | `camerafixed` | `true` / `false` | Fix the camera position during generation |

package/skills/seedream-image/SKILL.md

@@ -29,6 +29,7 @@ curl -X POST https://api.acedata.cloud/seedream/images \
 | Model | Version | Best For |
 |-------|---------|----------|
 | `doubao-seedream-5-0-260128` | Seedream 5.0 | Latest, highest quality (default) |
+| `doubao-seedream-5-0-pro-260628` | Seedream 5.0 Pro | Highest-quality Seedream 5.0 model |
 | `doubao-seedream-4-5-251128` | Seedream 4.5 | High quality, balanced |
 | `doubao-seedream-4-0-250828` | Seedream 4.0 | Reliable generation |
 

package/skills/sora-video/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sora-video
-description: UNAVAILABLE — the Sora endpoints now return 404 and the service is unpublished; use veo-video, kling-video or seedance-video instead. Historical reference for AceDataCloud's OpenAI Sora API. Was used 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.
+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
@@ -10,13 +10,6 @@ compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authent
 
 # Sora Video Generation
 
-> [!WARNING]
-> **This service is currently unavailable.** `/sora/videos` and `/sora/tasks` return
-> `404 no Route matched with those values`, and the Sora service is no longer published
-> in the API catalog. The reference below is kept for historical accuracy only — do not
-> build against it. For video generation use [veo-video](../veo-video/SKILL.md),
-> [kling-video](../kling-video/SKILL.md) or [seedance-video](../seedance-video/SKILL.md).
-
 Generate AI videos through AceDataCloud's OpenAI Sora API.
 
 > **Setup:** See [authentication](../_shared/authentication.md) for token setup.
@@ -77,8 +70,8 @@ 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,
+  "character_start": 2,
+  "character_end": 5,
   "model": "sora-2-pro"
 }
 ```
@@ -101,4 +94,4 @@ POST /sora/videos
 - `orientation` sets the aspect ratio — use `"portrait"` for mobile-first content
 - Task states use `"succeeded"` (not "completed") — check for this value when polling
 
-> **MCP:** the hosted endpoint `https://sora.mcp.acedata.cloud/mcp` currently returns 503, in line with the service being unavailable. See [all MCP servers](../_shared/mcp-servers.md)
+> **MCP:** `pip install mcp-sora` | Hosted: `https://sora.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)

package/skills/suno-music/SKILL.md

@@ -128,6 +128,7 @@ For best results follow this multi-step workflow:
 | `remaster` | Remaster an existing audio |
 | `mashup` | Blend multiple audio IDs together |
 | `samples` | Add samples to an uploaded song |
+| `inspo` | Generate a song inspired by an existing audio |
 
 ## Auxiliary Endpoints
 
@@ -140,8 +141,11 @@ For best results follow this multi-step workflow:
 | `/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/voices` | POST | Create a reusable voice from an audio URL; requires `audio_url`, with optional `name` and `description` |
 | `/suno/timing` | POST | Get word-level timing/subtitles |
-| `/suno/persona` | POST | Save a vocal style as a reusable persona |
+| `/suno/persona` | POST | Save a vocal style as a reusable persona; requires `audio_id` and `name` |
+| `/suno/persona` | GET | List reusable personas |
+| `/suno/persona` | DELETE | Delete a reusable persona |
 | `/suno/upload` | POST | Upload external audio for extend/cover |
 | `/suno/tasks` | POST | Query task status and results |
 
@@ -183,7 +187,7 @@ Ending lyrics
 - `variation_category` ("high"/"normal"/"subtle") is only supported on v5+ models
 - `duration` is forwarded as you send it — support varies by model and action, and an unsupported combination may ignore it or return an error, so verify with one request before batching. Note the request `duration` is a *target*; the `duration` in each returned clip is the *actual* length and will vary slightly
 - 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
+- `persona` requires an existing `audio_id` and a `name`; optional `vox_audio_id`, `vocal_start`, `vocal_end`, and `description` refine the vocal reference
 - 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/turnstile/SKILL.md

@@ -81,7 +81,7 @@ Then poll `POST /captcha/tasks` with the returned `task_id`:
 
 ```json
 POST /captcha/tasks
-{"id": "<task_id>"}
+{"task_id": "<task_id>"}
 ```
 
 > **Async:** See [async task polling](../_shared/async-tasks.md) for the full polling contract.

package/skills/webextrator/SKILL.md

@@ -107,11 +107,8 @@ POST /webextrator/tasks
 | `block_resources` | No | Drop `image`/`font`/`media`/`stylesheet`/`xhr`/`fetch` |
 | `headers` | No | Extra request headers for the target site |
 | `user_agent` | No | Override the browser User-Agent |
-| `cookies` | No | Cookies to install before navigation |
 | `async` | No | `true` submits without blocking; poll `/webextrator/tasks` for the result |
 | `callback_url` | No | Posted the final envelope when running asynchronously |
-| `bypass_cache` | No | Skip the Redis result cache for this request |
-| `cache_ttl_seconds` | No | Override cache TTL; `0` disables caching |
 
 ### Extract-only
 
@@ -135,6 +132,5 @@ POST /webextrator/tasks
 - `expected_type` only allows `product`/`article`/`general` — typed kinds (recipe/video/job) are detected automatically from schema.org
 - `enable_llm` has no effect when the page ships schema.org JSON-LD — the deterministic mapper wins for free
 - Tasks API is free and retains records for 7 days only
-- `cache_ttl_seconds: 0` means "do not cache" — use `bypass_cache` to skip read
 
 > **MCP:** `pip install mcp-webextrator` | Hosted: `https://webextrator.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)