Suno icon

Suno

Generate AI music, lyrics, and audio with the Suno API

Music Generation → Upload and Cover Audio

AI-generated

Summary

Upload an existing audio file via HTTPS URL to generate a cover version optionally using custom style and title settings.

Inputs

  • Upload URL (required) — HTTPS URL of the uploaded audio file, max 8 minutes duration (1 minute for model V4_5ALL). Private IPs are rejected.
  • Custom Mode (required) — Enable custom mode for full control over style and title of the cover track.
  • Instrumental (required) — Set to generate an instrumental-only cover without vocals.
  • Callback URL (required) — Public HTTPS URL to receive task completion notifications. Private IPs are rejected.
  • Model (required) — Select the AI model version to use for cover generation (e.g. V5, V4.5 Plus, etc).
  • Prompt — Lyrics or text prompt for the cover. Maximum length varies by model and whether custom mode is enabled.
  • Style — Music style or genre tags for the cover, applicable only in custom mode.
  • Title — Title for the cover track, applicable only in custom mode.
  • Negative Tags — Music styles or traits to exclude from the generated cover track.
  • Persona ID — Persona ID to apply a custom style, obtained from the Generate Persona operation.
  • Persona Model — Type of persona to apply, either style persona or voice persona (voice persona only with V5).
  • Style Weight — Strength of style influence, between 0.00 and 1.00.
  • Weirdness Constraint — Limits creative deviation, between 0.00 and 1.00.
  • Audio Weight — Influence of the input audio on the generated cover, between 0.00 and 1.00.
  • Vocal Gender — Preferred vocal gender for the generated track, male or female.

Output shape

a JSON object containing task details returned from the Suno API on cover generation request submission

The operation returns immediately with task details including a task ID. The user must monitor the callback URL for completion notifications to retrieve the final cover audio.

Links

Discussion