Skip to main content
POST
/
suno
/
submit
/
music
cURL
curl https://api.deerapi.com/suno/submit/music \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEERAPI_KEY" \
  -d '{
    "mv": "chirp-v4",
    "gpt_description_prompt": "A warm acoustic song about starting fresh."
  }'
{
  "code": "<string>",
  "message": "<string>",
  "data": "<string>"
}

​
Overview

Use this endpoint to call the Suno Generate Music workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint.

​
Before you start

Use the DeerAPI base URL and pass your API Key in the Authorization header: 
https://api.deerapi.com

Authorization: Bearer $DEERAPI_KEY

​
Model selection

Choose a current model ID from the live pricing page. Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first.

​
Implementation notes

  • Use the OpenAPI playground for the exact request fields accepted by this endpoint.
  • Keep API Keys on the server side when you build production applications.
  • Log the request ID from failed calls so support can investigate the request.
  • Retry 429, 500, and 503 responses with exponential backoff.

Authorizations

​
Authorization
string
header
required

Use a DeerAPI API Key as a Bearer token.

Body

application/json
​
prompt
string
default:Hello
required

Lyrics (custom mode only)

​
make_instrumental
boolean
default:true
required

Whether to generate instrumental only. Set to true for instrumental.

​
negative_tags
string
default:example
required

Excluded style tags

​
tags
string

Style tags (custom mode only)

​
mv
enum<string>

Model version

Available options:
chirp-v3.0,
chirp-v3.5,
chirp-v4,
chirp-auk,
chirp-bluejay,
chirp-crow
​
title
string

Title (custom mode only)

​
notify_hook
string

Callback URL: https://example.com/callback

​
gpt_description_prompt
string

Inspiration prompt (inspiration mode only)

​
task
string

Required for extending uploaded audio.

​
continue_clip_id
string

Clip ID of the song to extend.

​
continue_at
string

Float. Position in seconds to continue from.

​
task_id
string

Task ID for operations on a previous task.

Response

200 - application/json

Successful Response

​
code
string
required

Business status code

​
message
string
required

Message

​
data
string
required

Response data