Suno icon

Suno

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

Vocals → Add Instrumental

AI-generated

Summary

Add an instrumental track to an uploaded audio file by providing its HTTPS URL and specifying the desired instrumental style tags and other parameters.

Inputs

  • Upload URL (required) — HTTPS URL of the uploaded audio file. Max 8 minutes (1 minute for V4_5ALL). Private IPs are rejected.
  • Title (required) — Title for the generated track (max 100 characters).
  • Tags (required) — Instrumental style tags describing the desired output.
  • Negative Tags (required) — Music styles or traits to exclude from the generated track.
  • Callback URL (required) — HTTPS URL to receive task completion notifications. Must be publicly accessible. Private IPs are rejected.
  • Vocal Gender — Preferred vocal gender for the generated track; options are Male or Female.
  • Style Weight — Style influence strength on a scale from 0.00 to 1.00.
  • Weirdness Constraint — Creative deviation limit on a scale from 0.00 to 1.00.
  • Audio Weight — Input audio influence on a scale from 0.00 to 1.00.
  • Model (required) — The AI model version to use for generation; options are V4.5 Plus (richer sound, max 8 minutes) or V5 (superior musical expression, faster generation).

Output shape

a JSON object containing the task initiation response from the Suno API

The operation initiates an asynchronous task to generate and add an instrumental track to the provided uploaded audio. The final result is delivered to the specified callback URL. The response object typically includes task metadata such as a task ID.

Examples

Example 1: Add instrumental layers to an existing vocal track upload

Provide the HTTPS URL of the uploaded audio, specify a title, instrumental style tags to include or exclude, select the AI model, and set a callback URL to receive notification when processing completes.

Links

Discussion