@runapi.ai/suno 0.2.4 → 0.2.6

package/skills/suno/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: suno
-description: Generate and transform music with Suno through RunAPI. Use when the user asks an agent to create, extend, or transform music and audio with Suno. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.
+description: Generate and transform music with Suno through RunAPI. Use when the user asks an agent to create, extend, transform music/audio, prepare voice validation phrases, or create reusable custom voices with Suno. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.
 documentation: https://runapi.ai/models/suno.md
 provider_page: https://runapi.ai/providers/suno.md
 catalog: https://runapi.ai/models.md
@@ -23,7 +23,7 @@ metadata:
 
 # Suno on RunAPI
 
-Generate and transform music with Suno through RunAPI. The default path for one-off agent tasks is the `runapi` CLI; SDKs are for application integration.
+Generate and transform music with Suno through RunAPI, including voice validation phrase and custom voice workflows. The default path for one-off agent tasks is the `runapi` CLI; SDKs are for application integration.
 
 ## Routing decision
 
@@ -34,17 +34,24 @@ Generate and transform music with Suno through RunAPI. The default path for one-
 
 The `runapi` binary is the runtime dependency. Run `runapi auth status` first. For agents and headless runs, prefer `RUNAPI_API_KEY` or import it into saved config with `printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -`. Use `runapi login` only when the user explicitly wants interactive browser auth.
 
-Inspect the available actions and request fields with CLI help:
+Inspect the available commands and request fields with CLI help:
 
 ```shell
 runapi suno --help
 runapi suno text-to-music --help
+runapi suno voice-to-validation-phrase --help
+runapi suno regenerate-validation-phrase --help
+runapi suno generate-voice --help
+runapi suno check-voice --help
 ```
 
 Run a one-off task (synchronous — polls until the task completes):
 
 ```shell
 runapi suno text-to-music --input-file request.json
+runapi suno voice-to-validation-phrase --input-file voice-phrase.json
+runapi suno generate-voice --input-file generate-voice.json
+runapi suno check-voice --input-file check-voice.json
 ```
 
 Submit asynchronously and poll separately:
@@ -54,7 +61,9 @@ runapi suno text-to-music --async --input-file request.json
 runapi wait <task-id> --service suno --action text-to-music
 ```
 
-Available actions: `text-to-music`, `extend-music`, `generate-artwork`, `cover-audio`, `add-instrumental`, `add-vocals`, `separate-audio-stems`, `generate-midi`, `convert-audio`, `visualize-music`, `generate-lyrics`, `get-timestamped-lyrics`, `replace-section`, `create-mashup`, `text-to-sound`, `generate-persona`, `boost-style`.
+Available commands: `text-to-music`, `extend-music`, `generate-artwork`, `cover-audio`, `add-instrumental`, `add-vocals`, `separate-audio-stems`, `generate-midi`, `convert-audio`, `visualize-music`, `generate-lyrics`, `get-timestamped-lyrics`, `replace-section`, `create-mashup`, `text-to-sound`, `voice-to-validation-phrase`, `regenerate-validation-phrase`, `generate-voice`, `check-voice`, `generate-persona`, `boost-style`.
+
+For custom voice workflows: generate or regenerate a validation phrase, create a custom voice with `generate-voice`, then use the completed `voice_id` as `persona_id` with `persona_type: "voice"` on supported Suno v5 music generation endpoints. Use `check-voice` to confirm availability before depending on that voice in a generation request.
 
 ## SDK integration path
 
@@ -79,4 +88,3 @@ When integrating Suno into an app, backend, worker, or library — not for one-o
 - [v4.5 plus](https://runapi.ai/models/suno/v4.5-plus.md)
 - [v5](https://runapi.ai/models/suno/v5.md)
 - [v5.5](https://runapi.ai/models/suno/v5.5.md)
-