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

# POST /suno/v1/cover

`POST /suno/v1/cover`

## 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
  - `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.
  - `music_id` string, required — Audio ID of the track to cover.
  - `prompt` string — Lyrics. Used in custom mode (custom=true). Maximum length: 5000 characters. When custom=true and prompt is empty, the system will generate instrumental-only audio by default. When custom=true and prompt is not empty, the system will generate vocal audio with lyrics based on the prompt.
  - `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.
  - `duration` unknown
  - `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

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