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

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

## Overview

Use this endpoint to call the Suno Lyrics Mashup 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-lyrics-mashup.openapi.json POST /suno/act/lyrics-mashup
openapi: 3.1.0
info:
  title: Lyrics Mashup API
  version: 1.0.0
servers:
  - url: https://api.deerapi.com
security:
  - bearerAuth: []
paths:
  /suno/act/lyrics-mashup:
    post:
      summary: Lyrics mashup
      operationId: lyrics_mashup
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - lyrics_a
                - lyrics_b
              properties:
                lyrics_a:
                  type: string
                  description: First song lyrics
                lyrics_b:
                  type: string
                  description: Second song lyrics
            examples:
              Example 1:
                summary: Example 1
                value:
                  lyrics_a: Sambuy come back bluespawn greenspawn are making you a spawn
                  lyrics_b: |-
                    You kept looking back inside the station
                    I couldn't leave from where I stood
                    A sinking feeling in my chest
                    Today's goodbye felt like the end
            example:
              lyrics_a: Sambuy come back bluespawn greenspawn are making you a spawn
              lyrics_b: |-
                You kept looking back inside the station
                I couldn't leave from where I stood
                A sinking feeling in my chest
                Today's goodbye felt like the end
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  lyrics_request_id:
                    type: string
                    description: Lyrics request ID
                  mashup_id:
                    type: string
                    description: Mashup ID
                  response:
                    type: object
                    properties:
                      error_message:
                        type: string
                      status:
                        type: string
                        description: Status. complete means finished.
                      tags:
                        type: array
                        items:
                          type: string
                      text:
                        type: string
                        description: Blended lyrics
                      title:
                        type: string
      x-codeSamples:
        - lang: Shell
          label: cURL
          source: |
            curl https://api.deerapi.com/suno/act/lyrics-mashup \
              -H "Content-Type: application/json" \
              -H "Authorization: Bearer $DEERAPI_KEY" \
              -d '{
                "lyrics_a": "Sambuy come back bluespawn greenspawn are making you a spawn",
                "lyrics_b": "You kept looking back inside the station\nI couldn't leave from where I stood\nA sinking feeling in my chest\nToday's goodbye felt like the end"
              }'
        - lang: Python
          label: requests
          source: |
            import os
            import requests

            url = "https://api.deerapi.com/suno/act/lyrics-mashup"
            headers = {
                "Authorization": "Bearer " + os.environ["DEERAPI_KEY"],
                "Content-Type": "application/json",
            }
            payload = {
              "lyrics_a": "Sambuy come back bluespawn greenspawn are making you a spawn",
              "lyrics_b": "You kept looking back inside the station\nI couldn't leave from where I stood\nA sinking feeling in my chest\nToday's goodbye felt like the end"
            }

            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/act/lyrics-mashup", {
              method: "POST",
              headers: {
                Authorization: `Bearer ${process.env.DEERAPI_KEY}`,
                "Content-Type": "application/json",
              },
              body: JSON.stringify({
                "lyrics_a": "Sambuy come back bluespawn greenspawn are making you a spawn",
                "lyrics_b": "You kept looking back inside the station\nI couldn't leave from where I stood\nA sinking feeling in my chest\nToday's goodbye felt like the end"
              }),
            });


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

````