# Suno API

## Docs

- [File Upload API Quickstart](https://docs.sunoapi.org/file-upload-api/quickstart.md): Get started with the File Upload API in minutes, supporting multiple upload methods
- [Base64 File Upload](https://docs.sunoapi.org/file-upload-api/upload-file-base-64.md): Upload temporary files via Base64 encoded data. Note: Uploaded files are temporary and automatically deleted after 3 days.
- [File Stream Upload](https://docs.sunoapi.org/file-upload-api/upload-file-stream.md)
- [URL File Upload](https://docs.sunoapi.org/file-upload-api/upload-file-url.md)
- [Suno API Documentation](https://docs.sunoapi.org/index.md): Complete Suno API documentation - Your gateway to affordable and stable AI music API services
- [Add Instrumental](https://docs.sunoapi.org/suno-api/add-instrumental.md): This endpoint generates a musical accompaniment tailored to an uploaded audio file — typically a vocal stem or melody track. It helps users instantly flesh out their vocal ideas with high-quality backing music, all without needing a producer.
- [Add Instrumental Callbacks](https://docs.sunoapi.org/suno-api/add-instrumental-callbacks.md): When instrumental generation tasks are completed, the system will send results to your provided callback URL via POST request
- [Add Vocals](https://docs.sunoapi.org/suno-api/add-vocals.md): This endpoint layers AI-generated vocals on top of an existing instrumental. Given a prompt (e.g., lyrical concept or musical mood) and optional audio, it produces vocal output harmonized with the provided track.
- [Add Vocals Callbacks](https://docs.sunoapi.org/suno-api/add-vocals-callbacks.md): When vocal generation tasks are completed, the system will send results to your provided callback URL via POST request
- [Boost Music Style](https://docs.sunoapi.org/suno-api/boost-music-style.md)
- [Convert to WAV Format](https://docs.sunoapi.org/suno-api/convert-to-wav-format.md): Convert existing music tracks to high-quality WAV format.
- [WAV Format Conversion Callbacks](https://docs.sunoapi.org/suno-api/convert-to-wav-format-callbacks.md): When WAV format conversion tasks are completed, the system will send results to your provided callback URL via POST request
- [Generate Music Cover](https://docs.sunoapi.org/suno-api/cover-suno.md): Create personalized cover images for generated music.
- [Music Cover Generation Callbacks](https://docs.sunoapi.org/suno-api/cover-suno-callbacks.md): When music cover generation is complete, the system will call this callback to notify results.
- [Create Music Video](https://docs.sunoapi.org/suno-api/create-music-video.md): Generate an MP4 video with visualizations for a music track.
- [Music Video Generation Callbacks](https://docs.sunoapi.org/suno-api/create-music-video-callbacks.md): When music video generation tasks are completed, the system will send results to your provided callback URL via POST request
- [Extend Music](https://docs.sunoapi.org/suno-api/extend-music.md): Extend or modify existing music tracks.
- [Music Extension Callbacks](https://docs.sunoapi.org/suno-api/extend-music-callbacks.md): When music extension tasks are completed, the system will send results to your provided callback URL via POST request
- [Generate Lyrics](https://docs.sunoapi.org/suno-api/generate-lyrics.md): Create lyrics for music using AI models without generating audio tracks.
- [Lyrics Generation Callbacks](https://docs.sunoapi.org/suno-api/generate-lyrics-callbacks.md): When lyrics generation tasks are completed, the system will send results to your provided callback URL via POST request
- [Generate Mashup](https://docs.sunoapi.org/suno-api/generate-mashup.md): Create a mashup by blending two audio files together to generate new music.
- [Generate MIDI from Audio](https://docs.sunoapi.org/suno-api/generate-midi.md): Convert separated audio tracks into MIDI format with detailed note information for each instrument.
- [MIDI Generation Callbacks](https://docs.sunoapi.org/suno-api/generate-midi-callbacks.md): System will call this callback when MIDI generation from separated audio is complete.
- [Generate Suno AI Music](https://docs.sunoapi.org/suno-api/generate-music.md)
- [Music Generation Callbacks](https://docs.sunoapi.org/suno-api/generate-music-callbacks.md): When music generation tasks are completed, the system will send results to your provided callback URL via POST request
- [Generate Persona](https://docs.sunoapi.org/suno-api/generate-persona.md): Create a personalized music Persona based on generated music, giving the music a unique identity and characteristics.
- [Generate Sounds](https://docs.sunoapi.org/suno-api/generate-sounds.md): Create a sound generation task with loop, tempo, key, and optional lyrics subtitle capture settings.
- [Get Music Cover Details](https://docs.sunoapi.org/suno-api/get-cover-suno-details.md): Get detailed information about music cover generation tasks.
- [Get Lyrics Generation Details](https://docs.sunoapi.org/suno-api/get-lyrics-generation-details.md): Retrieve detailed information about a lyrics generation task, including status, parameters, and results.
- [Get MIDI Generation Details](https://docs.sunoapi.org/suno-api/get-midi-details.md): Retrieve detailed information about a MIDI generation task including complete note data for all detected instruments.
- [Get Music Generation Details](https://docs.sunoapi.org/suno-api/get-music-generation-details.md): Retrieve detailed information about a music generation task, including status, parameters, and results.
- [Get Music Video Details](https://docs.sunoapi.org/suno-api/get-music-video-details.md): Retrieve detailed information about a music video generation task, including status and download link.
- [Get Remaining Credits](https://docs.sunoapi.org/suno-api/get-remaining-credits.md): Retrieve the current balance of available credits for your account.
- [Get Timestamped Lyrics](https://docs.sunoapi.org/suno-api/get-timestamped-lyrics.md): Retrieve timestamped lyrics for synchronized display during audio playback.
- [Get Audio Separation Details](https://docs.sunoapi.org/suno-api/get-vocal-separation-details.md): Retrieve detailed information about a vocal separation task, including status and download links.
- [Get WAV Conversion Details](https://docs.sunoapi.org/suno-api/get-wav-conversion-details.md): Retrieve detailed information about a WAV format conversion task, including status and download link.
- [Suno API Quick Start](https://docs.sunoapi.org/suno-api/quickstart.md): Get started with Suno API in minutes to generate high-quality AI music, lyrics, and audio processing
- [Replace Music Section](https://docs.sunoapi.org/suno-api/replace-section.md): Replace a specific time segment within existing music.
- [Replace Music Section Callbacks](https://docs.sunoapi.org/suno-api/replace-section-callbacks.md): Understand the callback mechanism for replace music section tasks
- [Vocal & Instrument Stem Separation](https://docs.sunoapi.org/suno-api/separate-vocals-from-music.md): Use Suno’s official get‑stem API to split tracks created on our platform into clean vocal, accompaniment, or per‑instrument stems with state‑of‑the‑art source‑separation AI.
- [Audio Separation Callbacks](https://docs.sunoapi.org/suno-api/separate-vocals-from-music-callbacks.md): When vocal separation tasks are completed, the system will send results to your provided callback URL via POST request
- [Upload And Cover Audio](https://docs.sunoapi.org/suno-api/upload-and-cover-audio.md): This API covers an audio track by transforming it into a new style while retaining its core melody. It incorporates Suno's upload capability, enabling users to upload an audio file for processing. The expected result is a refreshed audio track with a new style, keeping the original melody intact.
- [Upload and Cover Audio Callbacks](https://docs.sunoapi.org/suno-api/upload-and-cover-audio-callbacks.md): When upload and cover audio tasks are completed, the system will send results to your provided callback URL via POST request
- [Upload And Extend Audio](https://docs.sunoapi.org/suno-api/upload-and-extend-audio.md): This API extends audio tracks while preserving the original style of the audio track. It includes Suno's upload functionality, allowing users to upload audio files for processing. The expected result is a longer track that seamlessly continues the input style.
- [Upload and Extend Audio Callbacks](https://docs.sunoapi.org/suno-api/upload-and-extend-audio-callbacks.md): When upload and extend audio tasks are completed, the system will send results to your provided callback URL via POST request

## OpenAPI Specs

- [file-upload-api](https://docs.sunoapi.org/file-upload-api/file-upload-api.json)
- [file-upload-api-cn](https://docs.sunoapi.org/cn/file-upload-api/file-upload-api-cn.json)
- [suno-api](https://docs.sunoapi.org/suno-api/suno-api.json)
- [suno-api-cn](https://docs.sunoapi.org/cn/suno-api/suno-api-cn.json)
- [openapi](https://docs.sunoapi.org/api-reference/openapi.json)

## Optional

- [Home](https://sunoapi.org/)
- [Old Docs](https://old-docs.sunoapi.org/)