Suno API for song generation.
Generate songs with vocals, custom lyrics, or instrumentals. Describe the sound, supply your lyrics, and build the experience around the music.
JSON intask_idaudio out
- Suno models
- 3v6, v6 Wild and v6 Mini
- Credits per song
- 20Reserved on submit, returned on confirmed failure
- Calls to a song
- 2Create a task, then retrieve its audio
- Charge per request
- 1×An Idempotency-Key makes retries safe
Make the first request yours.
An editable example, using the real API fields.
No key needed to explore the request.
Build a request to run on your server, or generate a song below.
curl --request POST \
'https://sunoapi.com/api/v1/sonic/create' \
--header "Authorization: Bearer ${SUNO_API_KEY}" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: ${SUNO_REQUEST_ID}" \
--data '{
"custom_mode": false,
"mv": "sonic-v6",
"make_instrumental": false,
"gpt_description_prompt": "Warm indie folk, fingerpicked guitar, intimate vocals. A hopeful song about taking the long way home."
}'Hear what you build.
Each generation reserves 20 credits from your SunoAPI account. Confirmed failures return reserved credits. If the service is unavailable before submission, no credits are charged.
Your key stays in page memory and is sent to the SunoAPI service for requests. It is never saved to browser storage.
Only the latest task ID is saved in this tab. Tracking checks every five seconds for up to five minutes. Open SunoAPI dashboard ↗
Three ways into the music.
- A1
Text to a complete song
Turn a musical brief into an arrangement with vocals. Start with a mood, a scene, or a story.
Description → song - A2
Lyrics with your signature
Bring the words. Set the musical direction. Keep your lyrics and style independently editable.
Lyrics → song - A3
Music behind the moment
Request instrumentals for a video, a game, or a creative tool. Give each scene a musical starting point.
Brief → instrumental
You build the product. The music follows.
Keep the integration straightforward: submit a request, save the task ID, and retrieve the finished audio. Build your own editor, review flow, and listening experience around it.
See the task lifecycle- 01
Describe
The sound you have in mind
POST /sonic/create - 02
Generate
A task your backend can track
GET /sonic/task/{id} - 03
Deliver
Audio inside your experience
data[].audio_url
Is this the official Suno API?
SunoAPI is an independent third-party developer website, not an official Suno service. Use sunoapi.com to build and test song generation requests with your SunoAPI account.
Can I bring my own lyrics?
Yes. Use custom mode, put lyrics in the prompt field, and describe the arrangement in tags. The workbench builds this request for you.
Where do I get an API key?
Create a SunoAPI account and manage your API keys and credits through the dashboard. Open the SunoAPI key dashboard ↗
Does the workbench generate a song?
Yes. Enter your existing SunoAPI key and select Generate song to submit a request using your account credits. You can track the task and play the results here. Exploring or copying a request is free.