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

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

## Overview

Use this endpoint to call the Suno Generate Lyrics 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-lyrics.openapi.json POST /suno/submit/lyrics
openapi: 3.1.0
info:
  title: Generate Lyrics API
  version: 1.0.0
servers:
  - url: https://api.deerapi.com
security:
  - bearerAuth: []
paths:
  /suno/submit/lyrics:
    post:
      summary: Generate lyrics
      operationId: generate_lyrics
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - prompt
                - notify_hook
              properties:
                prompt:
                  type: string
                  description: >-
                    Topic, theme, or description for lyrics generation. Can be a
                    simple phrase, story concept, or specific instructions about
                    what you want the lyrics to convey.
                      - Example: `"[Verse]\nA song about summer love and beach sunsets"`
                      - Example: `"Write a romantic song about missing someone"`
                  default: Hello
                notify_hook:
                  type: string
                  description: >-
                    Webhook URL for receiving lyrics generation completion
                    notifications. When provided, the system sends a POST
                    request with task results to this URL.
                      - Must be a valid HTTP/HTTPS URL
                      - Suitable for async processing and automated workflows
                  default: example
              default:
                prompt: A warm acoustic song about starting fresh.
                notify_hook: example
            examples:
              Default:
                summary: Default
                value:
                  prompt: |-
                    [Verse]
                    cat
            example:
              prompt: |-
                [Verse]
                cat
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - data
                  - message
                properties:
                  code:
                    type: string
                    description: Business status code
                  data:
                    type: string
                    description: |
                      Response data
                  message:
                    type: string
                    description: |
                      Message
      x-codeSamples:
        - lang: Shell
          label: cURL
          source: |
            curl https://api.deerapi.com/suno/submit/lyrics \
              -H "Content-Type: application/json" \
              -H "Authorization: Bearer $DEERAPI_KEY" \
              -d '{
                "prompt": "[Verse]\ncat"
              }'
        - lang: Python
          label: requests
          source: |
            import os
            import requests

            url = "https://api.deerapi.com/suno/submit/lyrics"
            headers = {
                "Authorization": "Bearer " + os.environ["DEERAPI_KEY"],
                "Content-Type": "application/json",
            }
            payload = {
              "prompt": "[Verse]\ncat"
            }

            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/lyrics", {
              method: "POST",
              headers: {
                Authorization: `Bearer ${process.env.DEERAPI_KEY}`,
                "Content-Type": "application/json",
              },
              body: JSON.stringify({
                "prompt": "[Verse]\ncat"
              }),
            });


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

````