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 | 10 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. |
vocal_variation | number | ❌ No | Degree of variation in vocals or instruments (used only in cover_music, swap_music_vocals, and swap_music_sound task types). |
🔁 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.
Modified at 2025-07-22 20:36:08
