Skip to main content
POST
/
suno
/
act
/
lyrics-mashup
cURL
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"
  }'
{
  "lyrics_request_id": "<string>",
  "mashup_id": "<string>",
  "response": {
    "error_message": "<string>",
    "status": "<string>",
    "tags": [
      "<string>"
    ],
    "text": "<string>",
    "title": "<string>"
  }
}

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.

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:
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
lyrics_a
string
required

First song lyrics

lyrics_b
string
required

Second song lyrics

Response

200 - application/json

Success

lyrics_request_id
string

Lyrics request ID

mashup_id
string

Mashup ID

response
object