---
title: "POST /suno/v1/mashup"
method: POST
path: "/suno/v1/mashup"
---

# POST /suno/v1/mashup

`POST /suno/v1/mashup`

## Request body

- object
  - `custom` boolean, required — Whether to use custom mode. - **true**: Audio will be generated from lyrics - **false**: Audio will be generated based on inspiration mode prompts
  - `instrumental` boolean, required — Whether to generate instrumental music. - **true**: Generate instrumental-only music - **false**: Generate a track with vocals and lyrics - In inspiration mode, the **gpt_description_prompt** parameter is required - In custom mode, the **prompt** parameter is required
  - `mv` 'chirp-v5-5' | 'chirp-v5' | 'chirp-v4-5+' | 'chirp-v4-5' | 'chirp-v4-5-all' | 'chirp-v4' | 'chirp-v3-5' | 'chirp-v3-0', required — Model to use.
  - `gpt_description_prompt` string — Prompt for inspiration mode. When not using custom mode (custom=false), this parameter is always required. Lyrics will be automatically generated from this prompt. Maximum length: 3000 characters.
  - `prompt` string — Lyrics. Used in custom mode (custom=true). Required when instrumental is false. The lyrics will be used and sung in the generated track. Maximum length: 5000 characters.
  - `title` string — Music title. Used in custom mode (custom=true). Maximum length: 80 characters.
  - `tags` string — Music style or genre. Used in custom mode (custom=true). Maximum length: 1000 characters.
  - `negative_tags` string — Music styles or genres that should be excluded from generation. Used in custom mode (custom=true).
  - `style_weight` number — Music style weight, range: 0.00–1.00. Used in custom mode. Valid range: 0 <= x <= 1.
  - `weirdness_constraint` number — Audio creativity (weirdness) weight, range: 0.00–1.00. Used in custom mode. Valid range: 0 <= x <= 1.
  - `audio_weight` number — Audio weight, range: 0.00–1.00. Used in custom mode. Valid range: 0 <= x <= 1.
  - `auto_lyrics` boolean — Whether to automatically generate lyrics. Custom mode only. - **true**: The input lyrics will be creatively rewritten, similar to the inspiration mode prompt effect - **false**: Use the provided lyrics directly to generate the music
  - `vocal_gender` 'Male' | 'Female' — Vocal gender. - Male: Male voice - Female: Female voice
  - `persona_id` string — Music style ID. Custom mode only. Use this parameter to generate music with a specific style.
  - `isStorage` boolean — Whether to store the generated audio. - **true**: The audio will be stored and a TTAPI CDN URL will be returned - **false**: The original source URL will be returned
  - `hookUrl` string — Callback notification URL
  - `mashup_music_id` unknown[], required — List of music IDs to blend. Exactly two tracks are required.
    - unknown

## Response `200`

Request successful

- object
  - `status` string, required
  - `message` string, required
  - `data` object, required

## Other responses

- `400` — Parameter error
- `401` — Authorization failed

---

[API](https://skmtc.net/ttapi/apis/flowmusic-api-docs.md) · [All operations](https://skmtc.net/ttapi/apis/flowmusic-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ttapi/flowmusic-api-docs/versions/f27f8a59dbd0/schema)