Suno icon

Suno

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

Actions28

Music Generation → Generate Mashup

AI-generated

Summary

Generate a new mashup music track by combining two audio files provided via HTTPS URLs, optionally customizing the prompt, style, and title, and receiving completion notifications via a callback URL.

Inputs

  • Upload URL 1 (required) — HTTPS URL of the first audio file for the mashup. Private IPs are rejected.
  • Upload URL 2 (required) — HTTPS URL of the second audio file for the mashup. Private IPs are rejected.
  • Custom Mode (required) — Whether to use custom mode with full control over prompt, style, and title
  • Model (required) — The AI model version to use for generation
  • Callback URL (required) — HTTPS URL to receive task completion notifications. Must be publicly accessible. Private IPs are rejected.
  • Prompt — Lyrics or text prompt for the mashup. Max length depends on model: V4 = 3,000 chars, V4.5/V5 = 5,000 chars. Required only if Custom Mode is true.
  • Style — Music style or genre tags for the mashup. Max length depends on model: V4 = 200 chars, V4.5/V5 = 1,000 chars. Required only if Custom Mode is true.
  • Title — Title for the mashup track. Max length depends on model: V4 = 80 chars, V4.5/V5 = 100 chars. Required only if Custom Mode is true.
  • Instrumental — Whether to generate an instrumental-only mashup without vocals
  • Negative Tags — Music styles or traits to exclude from the generated track
  • Persona ID — Persona ID for custom style. Obtain from the Generate Persona operation.
  • Persona Model — Type of persona to apply. Voice persona is only available with V5.
  • Style Weight — Style influence strength (0.00-1.00)
  • Weirdness Constraint — Creative deviation limit (0.00-1.00)
  • Audio Weight — Input audio influence (0.00-1.00)
  • Vocal Gender — Preferred vocal gender for the generated track

Output shape

a JSON object representing the initiated mashup generation task

The operation returns a JSON response with task details. The final generated mashup audio is delivered asynchronously via the provided callback URL; the response does not include the audio itself.

Links

Discussion