Actions28
- Music Generation Actions
- Vocals Actions
- Persona Actions
- Lyrics Actions
- Vocal Separation Actions
- Audio Conversion Actions
- Style Boost Actions
- Cover Image Actions
- Task Details Actions
- Credit Actions
- File Upload Actions
Music Generation → Upload and Cover Audio
AI-generatedSummary
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.
