> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.deerapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Suno Generate Music

> Use DeerAPI to call the Suno Generate Music endpoint with request details, response details, examples, and an OpenAPI playground.

## 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:

```text theme={null}
https://api.deerapi.com
```

```text theme={null}
Authorization: Bearer $DEERAPI_KEY
```

## Model selection

Choose a current model ID from the [live pricing page](https://api.deerapi.com/pricing). 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.


## OpenAPI

````yaml /api/openapi/music/suno/post-generate-music.openapi.json POST /suno/submit/music
openapi: 3.1.0
info:
  title: Generate Music API
  version: 1.0.0
servers:
  - url: https://api.deerapi.com
security:
  - bearerAuth: []
paths:
  /suno/submit/music:
    post:
      summary: Generate music
      operationId: generate_music
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - prompt
                - negative_tags
                - make_instrumental
              properties:
                prompt:
                  type: string
                  description: |
                    Lyrics (custom mode only)
                  default: Hello
                tags:
                  type: string
                  description: |
                    Style tags (custom mode only)
                mv:
                  type: string
                  description: |
                    Model version
                  enum:
                    - chirp-v3.0
                    - chirp-v3.5
                    - chirp-v4
                    - chirp-auk
                    - chirp-bluejay
                    - chirp-crow
                title:
                  type: string
                  description: |
                    Title (custom mode only)
                notify_hook:
                  type: string
                  description: 'Callback URL: https://example.com/callback'
                gpt_description_prompt:
                  type: string
                  description: |
                    Inspiration prompt (inspiration mode only)
                task:
                  type: string
                  description: |
                    Required for extending uploaded audio.
                continue_clip_id:
                  type: string
                  description: |
                    Clip ID of the song to extend.
                continue_at:
                  type: string
                  description: |
                    Float. Position in seconds to continue from.
                task_id:
                  type: string
                  description: |
                    Task ID for operations on a previous task.
                make_instrumental:
                  type: boolean
                  description: >
                    Whether to generate instrumental only. Set to true for
                    instrumental.
                  default: true
                negative_tags:
                  type: string
                  description: Excluded style tags
                  default: example
              default:
                prompt: A warm acoustic song about starting fresh.
                negative_tags: noise, distortion
                make_instrumental: true
            examples:
              1. Inspiration mode:
                summary: 1. Inspiration mode
                value:
                  mv: chirp-v4
                  gpt_description_prompt: A warm acoustic song about starting fresh.
              2. Custom mode:
                summary: 2. Custom mode
                value:
                  prompt: |-
                    [Verse]
                    Walking down the streets
                    Beneath the city lights
                    Neon signs flickering
                    Lighting up the night
                    Heart beating faster
                    Like a drum in my chest
                    I'm alive in this moment
                    Feeling so blessed

                    Stilettos on the pavement
                    Stepping with grace
                    Surrounded by the people
                    Moving at their own pace
                    The rhythm of the city
                    It pulses in my veins
                    Lost in the energy
                    As my worries drain

                    [Verse 2]
                    Concrete jungle shining
                    With its dazzling glow
                    Every corner hiding secrets that only locals know
                    A symphony of chaos
                    But it's music to my ears
                    The hustle and the bustle
                    Wiping away my fears
                  tags: emotional punk
                  mv: chirp-v4
                  title: City Lights
            example:
              mv: chirp-v4
              gpt_description_prompt: A warm acoustic song about starting fresh.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - message
                  - data
                properties:
                  code:
                    type: string
                    description: Business status code
                  message:
                    type: string
                    description: Message
                  data:
                    type: string
                    description: Response data
      x-codeSamples:
        - lang: Shell
          label: cURL
          source: |
            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."
              }'
        - lang: Python
          label: requests
          source: |
            import os
            import requests

            url = "https://api.deerapi.com/suno/submit/music"
            headers = {
                "Authorization": "Bearer " + os.environ["DEERAPI_KEY"],
                "Content-Type": "application/json",
            }
            payload = {
              "mv": "chirp-v4",
              "gpt_description_prompt": "A warm acoustic song about starting fresh."
            }

            response = requests.post(url, headers=headers, json=payload)
            print(response.json())
        - lang: JavaScript
          label: fetch
          source: >
            const response = await
            fetch("https://api.deerapi.com/suno/submit/music", {
              method: "POST",
              headers: {
                Authorization: `Bearer ${process.env.DEERAPI_KEY}`,
                "Content-Type": "application/json",
              },
              body: JSON.stringify({
                "mv": "chirp-v4",
                "gpt_description_prompt": "A warm acoustic song about starting fresh."
              }),
            });


            console.log(await response.json());
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Use a DeerAPI API Key as a Bearer token.

````