SuperAPI AI Directory

suno-voice

General & other

View repository

Updated 11-16 13:21

About this skill

Your Task

Input: $ARGUMENTS

Work with the user's saved Suno Voices: list them, put one on a track or an album, take one off, or hand over Suno's link for making a new one.

Nothing here generates or costs anything. The Voice sings at the next /bitwize-music:generate of the track, at that command's usual cost.


Suno Voice Skill

A track sings in a saved Voice when the Voice row of its ## Cover / Voice Setup block names it (templates/track.md § Voice Selection). /bitwize-music:generate reads that row and finds the Voice's id on the user's Suno account. Background: ${CLAUDE_PLUGIN_ROOT}/reference/suno/mcp-api-mapping.md § Covers and Voices.

Step 1: Resolve

  • list (or "what voices do I have") → Step 3.
  • create (or "make a new voice") → Step 6.
  • <album> [<track>] "<Voice>" → Step 4. No track means every track of the album that has lyrics.
  • <album> [<track>] --off (or "take the voice off") → Step 5.

Step 2: Check the Suno Server

Follow § Preflight in the reference doc: find voices-list, voices-start and account-usage on the connected Suno server, load their current definitions, and read account-usage once.

  • Not connected → say a Voice is checked against the Suno account through Suno's MCP server, give the setup command from § Preflight, and stop.
  • features lacks voices → say Suno's Voices need a Pro or Premier plan, and stop.

Taking a Voice off (Step 5) needs none of this.

Step 3: List the Voices

voices-list (the user's own Voices, newest first). Show the names on one line each, no more than 20:

Your Voices on Suno (newest first):
  RTB · Missed Connections · ASCII · Mac · TayTay · Player Two

next_cursor set → say there are more and offer the next page. Voices they loved on suno.com are in collection: "loved"; show those when asked.

Step 4: Put a Voice on a Track or an Album

  1. Find it. voices-list(query: <name>). Nothing → once more with collection: "loved".
  2. Choose. One match, or one whose name is exactly the one asked for (ignoring case) → that Voice. Several otherwise → show their names and ask which. None → say it is not on their Suno account and show their Voices (Step 3) so they can pick one. They can also make one with /bitwize-music:suno-voice create — say so, but do not call voices-start unless they ask.
  3. Write it. set_track_voice(album_slug, voice, track_slug, saved_from, vocal_identity):
    • voice: the Voice's name. Use its id instead when another of their Voices has the same name, or when the Voice is a public one found by id, so /generate finds exactly this Voice.
    • saved_from: https://suno.com/song/<root_clip_id> when voices-list gave a root_clip_id.
    • vocal_identity: the Voice's description when it has one.
    • track_slug: empty for the whole album.
  4. Report.
    Track 03 now sings in RTB. The next /bitwize-music:generate uses it
    (10 credits for two takes, as usual). Takes made earlier keep their voice.
    
    For an album, name the tracks it went on, and the instrumental tracks it skipped. An error (an instrumental track, an unknown track) → show it.

A Voice carries its own gender, so the track's Vocal Gender is not sent with it. A Voice made on an older Suno model may need "Upgrade Voice to v6" on suno.com before it sings well.

Step 5: Take a Voice Off

set_track_voice(album_slug, "—", track_slug). The track then sings in the voice its Style Box describes. Say which tracks changed; unchanged ones had no Voice.

Step 6: Make a New Voice

Only when the user asks for one.

  1. Call voices-start. It takes no arguments.
  2. A url comes back → give it to the user:
    Make your Voice on suno.com: <url>
    Record and verify it there. When it's ready, tell me its name and the
    track or album to use it on.
    
  3. No url → say what Suno answered and stop. An account signed in with an API key gets a 409; Voices are made by a user signed in on suno.com.

Never ask the user for recordings or audio files: Suno takes them on that page. Once the Voice is ready it appears in voices-list, and Step 4 puts it on a track.

Remember

  1. Check before writing — a Voice goes in a track file only after voices-list has found it.
  2. Free — nothing here generates or charges. Singing happens at /generate, with its own cost and go-ahead.
  3. The user names the Voice — never pick one for them; with several matches, ask.
  4. voices-start only on request — when a Voice is missing, offer it; call it only when they want to make one.