---
title: "Upload And Cover Audio"
method: POST
path: "/api/v1/generate/upload-cover"
---

# Upload And Cover Audio

`POST /api/v1/generate/upload-cover`

## Request body

- object
  - `uploadUrl` string, uri, required — The URL for uploading audio files, required regardless of whether customMode and instrumental are true or false. Ensure the uploaded audio does not exceed 8 minutes in length.
  - `prompt` string — A description of the desired audio content. - In Custom Mode (`customMode: true`): Required if `instrumental` is `false`. The prompt will be strictly used as the lyrics and sung in the generated track. Character limits by model: - **V4**: Maximum 3000 characters - **V4_5, V4_5PLUS, V4_5ALL, V5 & V5_5**: Maximum 5000 characters Example: "A calm and relaxing piano track with soft melodies" - In Non-custom Mode (`customMode: false`): Always required. The prompt serves as the core idea, and lyrics will be automatically generated based on it (not strictly matching the input). Maximum 500 characters. Example: "A short relaxing piano tune"
  - `style` string — The music style or genre for the audio. - Required in Custom Mode (`customMode: true`). Examples: "Jazz", "Classical", "Electronic". Character limits by model: - **V4**: Maximum 200 characters - **V4_5, V4_5PLUS, V4_5ALL, V5 & V5_5**: Maximum 1000 characters Example: "Classical" - In Non-custom Mode (`customMode: false`): Leave empty.
  - `title` string — The title of the generated music track. - Required in Custom Mode (`customMode: true`). Character limits by model: - **V4 & V4_5ALL**: Maximum 80 characters - **V4_5, V4_5PLUS, V5 & V5_5**: Maximum 100 characters Example: "Peaceful Piano Meditation" - In Non-custom Mode (`customMode: false`): Leave empty.
  - `customMode` boolean, required — Enables Custom Mode for advanced audio generation settings. - Set to `true` to use Custom Mode (requires `style` and `title`; `prompt` required if `instrumental` is `false`). The prompt will be strictly used as lyrics if `instrumental` is `false`. - Set to `false` for Non-custom Mode (only `prompt` is required). Lyrics will be auto-generated based on the prompt.
  - `instrumental` boolean, required — Determines if the audio should be instrumental (no lyrics). - In Custom Mode (`customMode: true`): - If `true`: Only `style` and `title` are required. - If `false`: `style`, `title`, and `prompt` are required (with `prompt` used as the exact lyrics). - In Non-custom Mode (`customMode: false`): No impact on required fields (`prompt` only). Lyrics are auto-generated if `instrumental` is `false`.
  - `personaId` string — Only available when custom parameters are enabled. Persona ID to apply to the generated music. Optional. You can use either: - A Persona ID generated by the [Generate Persona](https://docs.sunoapi.org/suno-api/generate-persona) endpoint. Use `personaModel: style_persona` or omit `personaModel` to use the default. - A `voiceId` generated by the [Suno Voice](https://docs.sunoapi.org/suno-api/suno-voice-generate) workflow. When using a voice-generated ID, you must set `personaModel: voice_persona`.
  - `personaModel` 'style_persona' | 'voice_persona' — Persona model type to apply when using `personaId`. Optional. - `style_persona` (default): Use this for Persona IDs generated by the Generate Persona endpoint. - `voice_persona`: Use this when `personaId` is a `voiceId` generated by Suno Voice. This option is only available with V5 and V5_5 models.
  - `model` 'V4' | 'V4_5' | 'V4_5PLUS' | 'V4_5ALL' | 'V5' | 'V5_5', required — The model version to use for audio generation. - Choose between: `V4`, `V4_5`, `V4_5PLUS`, `V4_5ALL`, `V5`, or `V5_5`. **Note:** Ensure correct formatting (e.g., use "V4" or "V4_5ALL", not "V4.5" or other variations).
  - `negativeTags` string — Music styles or traits to exclude from the generated audio. - Optional. Use to avoid specific styles. Example: "Heavy Metal, Upbeat Drums"
  - `vocalGender` 'm' | 'f' — Preferred vocal gender for generated vocals. Optional.
  - `styleWeight` number — Weight of the provided style guidance. Range 0.00–1.00.
  - `weirdnessConstraint` number — Constraint on creative deviation/novelty. Range 0.00–1.00.
  - `audioWeight` number — Weight of the input audio influence (where applicable). Range 0.00–1.00.
  - `duration` integer — Optional duration in seconds. Only effective when `customMode` is `true` and `model` is `V5_5`.
  - `callBackUrl` string, uri, required — The URL to receive task completion notifications when audio covering is complete. - For detailed callback format and implementation guide, see [Upload and Cover Audio Callbacks](https://docs.sunoapi.org/suno-api/upload-and-cover-audio-callbacks) - Alternatively, you can use the get music generation details endpoint to poll task status

## Response `200`

Request successful

- object
  - `code` 200 | 400 | 401 | 404 | 405 | 413 | 429 | 430 | 455 | 500 — # Status Codes - ✅ 200 - Request successful - ⚠️ 400 - Invalid parameters - ⚠️ 401 - Unauthorized access - ⚠️ 404 - Invalid request method or path - ⚠️ 405 - Rate limit exceeded - ⚠️ 413 - Theme or prompt too long - ⚠️ 429 - Insufficient credits - ⚠️ 430 - Your call frequency is too high. Please try again later. - ⚠️ 455 - System maintenance - ❌ 500 - Server error
  - `msg` string — Error message when code != 200
  - `data` object
    - `taskId` string — Task ID for tracking task status

## Other responses

- `500` — Server error

---

[API](https://skmtc.net/sunoapi/apis/file-upload-api.md) · [All operations](https://skmtc.net/sunoapi/apis/file-upload-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sunoapi/file-upload-api/versions/22d45ee33a4a/schema)