Connect SunoAPI to Your AI Agent

Describe the sound or lyric idea and follow it through to a finished generation.

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

Create music from a sound brief and review the completed tracks.

/oo SunoAPI: Create instrumental music for [purpose] with [mood and instruments]. Retrieve the tracks when they are ready.

Generate Lyrics

Develop a lyric idea and retrieve the finished words.

/oo SunoAPI: Write lyrics about [theme] in [style and language], then retrieve the completed lyrics.

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

  • SunoAPI access and available credits. Direct connections need a notification address for tasks that require one.
  • Music and lyrics generation may take time. Check completion before using the resulting tracks or text.

SunoAPI Tools

Create music and lyrics from a brief, retrieve finished tracks, and work with supported audio edits such as extensions and vocal separation.

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

Is the music ready immediately?

Generation takes time. The assistant follows the task and retrieves the result after it finishes.

What needs to be set up before generation?

Music generation needs a supported model. A direct SunoAPI connection also needs a notification address; Marketplace can handle notifications for supported tasks. The assistant may ask for any missing details before starting.

Can I get lyrics with timing information?

Yes, for a generated track that supports it. Identify the generation task and the track you want to use.

Connect SunoAPI

About SunoAPI ↗