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
Vocals → Add Instrumental
AI-generatedSummary
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.
