Riffusion AI Music Generation API

Riffusion is a cutting-edge AI music creation platform similar to Suno or Udio, now offering one of the most efficient and high-quality music generation on the market.

🚀 Why Riffusion?

🎵 Near Suno v4.5 Quality: Delivers studio-level music quality, including vocals and instrumentals.

🔁 Unique Swap Capabilities: Swap vocals or sound style in any music clip — a feature unmatched by other platforms.

⚡ Fast Generation: Produces 3–4 minute songs in under 60 seconds.

💸 Affordable & Stable: Low cost per track and reliable performance at scale.

🧠 Flexible Features: Supports lyrics-based, prompt-based, instrumental, and remix workflows.

📄 Commercial License: All generated content is licensed for commercial use.

🔋 Credit Consumption

Action Type	Credit Usage
`upload` tasks	2 credits
`create` tasks	12 credits

📡 API Parameters

Field	Type	Required	Description
`custom_mode`	`boolean`	✅ Yes	Set to `true` to use lyrics-based generation, `false` for prompt-based.
`lyrics`	`string`	❌ No	Lyrics input (used only when `custom_mode` is `true`).
`title`	`string`	❌ No	Title of the song (metadata, optional, only with `custom_mode`).
`make_instrumental`	`boolean`	✅ Yes	Whether to generate instrumental-only music.
`prompt`	`string`	❌ No	Prompt or theme for the song (used only when `custom_mode` is `false`).
`sound`	`string`	❌ No	Style and sound design (genre, voice style, etc., only with `custom_mode`).
`mv`	`enum`	✅ Yes	Model version. Options: `"FUZZ-1.1 Pro"`, `"FUZZ-1.1"`, `"FUZZ-1.0 Pro"`, `"FUZZ-1.0"`.
`task_type`	`string`	❌ No	Task type: `create_music`, `extend_music`, `cover_music`, `extend_upload_music`, `replace_music`, `replace_upload_music`, `swap_music_sound`, `swap_upload_music_sound`, `swap_music_vocals`, `swap_upload_music_vocals`.
`continue_clip_id`	`string`	❌ No	The clip ID of the original song to operate on (uploaded clip or previously generated one).
`continue_at`	`number`	❌ No	Starting second for extension (`extend` task types only).
`replace_start_time`	`number`	❌ No	Start time (in seconds) of the segment to replace.
`replace_end_time`	`number`	❌ No	End time (in seconds) of the segment to replace.

🔁 Response & Polling Notes

Riffusion generates full tracks quickly (typically under 1 minute). There is no intermediate status, so when a generation is in progress, the API will return:

{
  "type": "processing",
  "message": "processing generation, please try again later."
}

ℹ️ Additional Notes

⏱ Recommended polling interval: every 10 seconds.

⚠️ When using an uploaded clip_id, ensure the task_type is the correct upload variant (e.g., extend_upload_music, swap_upload_music_sound, etc.).

🕓 There is no intermediate progress — keep polling until the final result is returned.

Riffusion instructions

Riffusion AI Music Generation API#

🚀 Why Riffusion?#

🔋 Credit Consumption#

📡 API Parameters#