Connect SunoAPI to Your AI Agent

Submit music or lyrics generation, inspect task details, and request supported audio transformations or timestamped lyrics. Ask your connected AI assistant to explain the results or carry out the specified operation.

26 tools API key

Try a SunoAPI Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill SunoAPI

Generate Instrumental Music

Submit explicit model and generation mode, then inspect task details.

/oo SunoAPI: Generate SunoAPI music with prompt [prompt], customMode false, instrumental true, model [model], callBackUrl [callback URL], then read the returned taskId.

Generate Lyrics

Submit a lyrics brief and inspect the result task.

/oo SunoAPI: Generate SunoAPI lyrics from [prompt] with callBackUrl [callback URL], then check the returned task ID.

Start Working with SunoAPI

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect SunoAPI

    Connect with a SunoAPI API key.

    Connect SunoAPI →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • A SunoAPI API key, available credits, and callback URL for required tasks.
  • Most generation tasks need a callback URL and return a task ID. SunoAPI is the service being connected; submissions require follow-up status checks.

SunoAPI Tools

SunoAPI connects supported service operations to your AI assistant. Submit music or lyrics generation, inspect task details, and request supported audio transformations or timestamped lyrics.

Music and Lyrics

Submit generation tasks and read music or lyrics details.

Audio Transformations

Extend tracks, separate vocals, or convert generated tracks to WAV and inspect tasks.

26 tools

Get Remaining Credits

Fetch the remaining SunoAPI credits for the authenticated account.

sunoapi.get_remaining_credits

Generate Music

Submit a SunoAPI music generation task and return the task identifier.

sunoapi.generate_music

Get Music Generation Details

Fetch SunoAPI music generation details for a task.

sunoapi.get_music_generation_details

Generate Lyrics

Submit a SunoAPI lyrics generation task and return the task identifier.

sunoapi.generate_lyrics

Get Lyrics Generation Details

Fetch SunoAPI lyrics generation details for a task.

sunoapi.get_lyrics_generation_details

Get Timestamped Lyrics

Fetch SunoAPI timestamped lyrics for a track.

sunoapi.get_timestamped_lyrics

Generate Persona

Submit a SunoAPI persona generation task and return the generated persona details.

sunoapi.generate_persona

Separate Vocals From Music

Separate vocals from music and return the submitted SunoAPI task identifier.

sunoapi.separate_vocals_from_music

Get Vocal Separation Details

Fetch SunoAPI vocal separation details for a task.

sunoapi.get_vocal_separation_details

Extend Music

Submit a SunoAPI music extension task and return the task identifier.

sunoapi.extend_music

Upload And Cover Audio

Submit a SunoAPI upload and cover task and return the task identifier.

sunoapi.upload_and_cover_audio

Upload And Extend Audio

Submit a SunoAPI upload and extend task and return the task identifier.

sunoapi.upload_and_extend_audio

Add Vocals

Submit a SunoAPI add vocals task and return the task identifier.

sunoapi.add_vocals

Add Instrumental

Submit a SunoAPI add instrumental task and return the task identifier.

sunoapi.add_instrumental

Boost Music Style

Boost a SunoAPI style prompt and return the generated style text.

sunoapi.boost_music_style

Replace Music Section

Submit a SunoAPI section replacement task and return the task identifier.

sunoapi.replace_music_section

Generate Mashup

Submit a SunoAPI mashup task and return the task identifier.

sunoapi.generate_mashup

Generate Sounds

Submit a SunoAPI sounds task and return the task identifier.

sunoapi.generate_sounds

Generate Music Cover

Submit a SunoAPI music cover task and return the task identifier.

sunoapi.generate_music_cover

Get Music Cover Details

Fetch SunoAPI music cover details for a task.

sunoapi.get_music_cover_details

Create Music Video

Submit a SunoAPI music video task and return the task identifier.

sunoapi.create_music_video

Get Music Video Details

Fetch SunoAPI music video details for a task.

sunoapi.get_music_video_details

Convert To Wav Format

Submit a SunoAPI WAV conversion task and return the task identifier.

sunoapi.convert_to_wav_format

Get Wav Conversion Details

Fetch SunoAPI WAV conversion details for a task.

sunoapi.get_wav_conversion_details

Generate Midi

Submit a SunoAPI MIDI task and return the task identifier.

sunoapi.generate_midi

Get Midi Generation Details

Fetch SunoAPI MIDI generation details for a task.

sunoapi.get_midi_generation_details

Tools are available through the OOMOL marketplace. Usage charges may apply.

Frequently Asked Questions

Does generation finish in one request?

Generation usually returns a task ID. Retrieve task details to inspect completion and output.

Why provide a callback URL?

Many task APIs require callBackUrl for generation notifications even when you also poll results.

Can I get timestamped lyrics?

Use the taskId and audioId for a track with get_timestamped_lyrics.

Connect SunoAPI

About SunoAPI ↗