🎧 Music Model Riffusion
- 2025.06.05 This platform now supports the music model
Riffusion - One prompt generates 2 songs
- Billing is per request, not per song
Riffusion API
- Include the header
Authorization: Bearer your-keyin all requests
1. Generate Task — Professional Mode
shell
curl --request POST \
--url https://api.openai-hk.com/riffusion/generate \
--header 'Authorization: Bearer hk-your-key' \
--header 'Content-Type: application/json' \
--data '{
"model": "FUZZ-1.0",
"lyrics": "[Verse]\n嗒嗒时钟轻敲着鼓点\n幼儿园里梦幻的画面\n我们是城堡里的精灵\n欢笑嬉戏乐趣无边\n\n[Verse 2]\n滑滑梯像巨龙的脊背\n哧溜一下欢笑飞\n笑声在空中炸开了花\n连云朵都被逗乐啦\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假\n\n[Verse 3]\n小桌子是知识的港湾\n老师故事满是光环\n温柔话语像火苗温暖\n点燃了我们智慧的帆\n\n[Bridge]\n手拉手在草地上奔跑\n迎着风儿开心地咯咯笑\n阳光牵着我们向上飘\n未来的树冠我们骄傲\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假",
"tag": "流行,粤语",
"title":"童年"
}'curl --request POST \
--url https://api.openai-hk.com/riffusion/generate \
--header 'Authorization: Bearer hk-your-key' \
--header 'Content-Type: application/json' \
--data '{
"model": "FUZZ-1.0",
"lyrics": "[Verse]\n嗒嗒时钟轻敲着鼓点\n幼儿园里梦幻的画面\n我们是城堡里的精灵\n欢笑嬉戏乐趣无边\n\n[Verse 2]\n滑滑梯像巨龙的脊背\n哧溜一下欢笑飞\n笑声在空中炸开了花\n连云朵都被逗乐啦\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假\n\n[Verse 3]\n小桌子是知识的港湾\n老师故事满是光环\n温柔话语像火苗温暖\n点燃了我们智慧的帆\n\n[Bridge]\n手拉手在草地上奔跑\n迎着风儿开心地咯咯笑\n阳光牵着我们向上飘\n未来的树冠我们骄傲\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假",
"tag": "流行,粤语",
"title":"童年"
}'Request body
json
{
"model": "FUZZ-1.0",
"lyrics": "[Verse]\n嗒嗒时钟轻敲着鼓点\n幼儿园里梦幻的画面\n我们是城堡里的精灵\n欢笑嬉戏乐趣无边\n\n[Verse 2]\n滑滑梯像巨龙的脊背\n哧溜一下欢笑飞\n笑声在空中炸开了花\n连云朵都被逗乐啦\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假\n\n[Verse 3]\n小桌子是知识的港湾\n老师故事满是光环\n温柔话语像火苗温暖\n点燃了我们智慧的帆\n\n[Bridge]\n手拉手在草地上奔跑\n迎着风儿开心地咯咯笑\n阳光牵着我们向上飘\n未来的树冠我们骄傲\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假",
"tag": "流行,粤语",
"title": "童年"
// "instrumental":false
// "morph": {
// "riff_id": "83fab52b-3b72-4678-9d5c-820b937bcd92",
// "transform": "cover",
// "normalized_lyrics_strength": 0.5,
// "normalized_sound_prompt_strength": 0.7,
// "normalized_weirdness": 0.5,
// "normalized_cover_strength": 0.28,
// "normalized_variation_strength": null,
// "audio_upload_id": "16f61e67-43a0-410c-a9c0-e033e601db27",
// "crop_end_at": 118.932608,
// "replace_start_at": 38.16928131842106,
// "replace_end_at": 79.50178530438593,
// "duration": 0
// }
}{
"model": "FUZZ-1.0",
"lyrics": "[Verse]\n嗒嗒时钟轻敲着鼓点\n幼儿园里梦幻的画面\n我们是城堡里的精灵\n欢笑嬉戏乐趣无边\n\n[Verse 2]\n滑滑梯像巨龙的脊背\n哧溜一下欢笑飞\n笑声在空中炸开了花\n连云朵都被逗乐啦\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假\n\n[Verse 3]\n小桌子是知识的港湾\n老师故事满是光环\n温柔话语像火苗温暖\n点燃了我们智慧的帆\n\n[Bridge]\n手拉手在草地上奔跑\n迎着风儿开心地咯咯笑\n阳光牵着我们向上飘\n未来的树冠我们骄傲\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假",
"tag": "流行,粤语",
"title": "童年"
// "instrumental":false
// "morph": {
// "riff_id": "83fab52b-3b72-4678-9d5c-820b937bcd92",
// "transform": "cover",
// "normalized_lyrics_strength": 0.5,
// "normalized_sound_prompt_strength": 0.7,
// "normalized_weirdness": 0.5,
// "normalized_cover_strength": 0.28,
// "normalized_variation_strength": null,
// "audio_upload_id": "16f61e67-43a0-410c-a9c0-e033e601db27",
// "crop_end_at": 118.932608,
// "replace_start_at": 38.16928131842106,
// "replace_end_at": 79.50178530438593,
// "duration": 0
// }
}Key field descriptions
| Field | Type | Description |
|---|---|---|
| model | string | Model. Options: FUZZ-1.0 FUZZ-1.1 FUZZ-1.0 Pro FUZZ-1.1 Pro |
| lyrics | string | Song lyrics |
| tag | string | Tags / style |
| title | string | Song title |
| instrumental | boolean | Whether to generate instrumental only |
| morph | object | Only used in cover, extend, and similar modes |
| morph.transform | string | Mode. Options: cover extend inpaint swap_vocals swap_sound |
| morph.riff_id | string | Song ID after creation — use either this or audio_upload_id |
| morph.audio_upload_id | string | Uploaded song ID — use either this or riff_id |
| morph.crop_end_at | number | Start time for continuation in extend mode |
| morph.replace_start_at | number | Start time in inpaint mode |
| morph.replace_end_at | number | End time in inpaint mode |
- Response body
- Returns 2 IDs for subsequent task queries:
riff_id1andriff_id2
json
{
"jobs": [
{
"id": "989aff28-4df4-48d9-8ea3-92b746b4b765"
},
{
"id": "322ebfd9-fefe-4728-a47a-c5825d7f0c2e"
}
]
}{
"jobs": [
{
"id": "989aff28-4df4-48d9-8ea3-92b746b4b765"
},
{
"id": "322ebfd9-fefe-4728-a47a-c5825d7f0c2e"
}
]
}2. Query Task
get https://api.openai-hk.com/riffusion/feed/{riff_id1},{riff_id2}
- Response body
json
[
{
"id": "989aff28-4df4-48d9-8ea3-92b746b4b765",
"title": "Childhood",
"image_url": "https://cdn1.suno.ai/image_989aff28-4df4-48d9-8ea3-92b746b4b765.jpeg",
"audio_url": "https://cdn1.suno.ai/989aff28-4df4-48d9-8ea3-92b746b4b765.mp3",
"video_url": "https://cdn1.suno.ai/989aff28-4df4-48d9-8ea3-92b746b4b765.mp4",
"duration": 213.48,
"status": "complete",
"tags": "pop, cantonese"
}
][
{
"id": "989aff28-4df4-48d9-8ea3-92b746b4b765",
"title": "Childhood",
"image_url": "https://cdn1.suno.ai/image_989aff28-4df4-48d9-8ea3-92b746b4b765.jpeg",
"audio_url": "https://cdn1.suno.ai/989aff28-4df4-48d9-8ea3-92b746b4b765.mp3",
"video_url": "https://cdn1.suno.ai/989aff28-4df4-48d9-8ea3-92b746b4b765.mp4",
"duration": 213.48,
"status": "complete",
"tags": "pop, cantonese"
}
]3. Upload Audio
- Request body — provide the audio URL to get an
audio_upload_id
json
{
"url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}{
"url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}- Response body
json
{
"id": "16f61e67-43a0-410c-a9c0-e033e601db27"
}{
"id": "16f61e67-43a0-410c-a9c0-e033e601db27"
}4. Cover Mode
- Request body
- Use the
idfrom the query result asriff_id
json
{
"model": "FUZZ-1.1 Pro",
"lyrics": "[Verse]\n嗒嗒时钟轻敲着鼓点\n幼儿园里梦幻的画面\n我们是城堡里的精灵\n欢笑嬉戏乐趣无边\n\n[Verse 2]\n滑滑梯像巨龙的脊背\n哧溜一下欢笑飞\n笑声在空中炸开了花\n连云朵都被逗乐啦\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假\n\n[Verse 3]\n小桌子是知识的港湾\n老师故事满是光环\n温柔话语像火苗温暖\n点燃了我们智慧的帆\n\n[Bridge]\n手拉手在草地上奔跑\n迎着风儿开心地咯咯笑\n阳光牵着我们向上飘\n未来的树冠我们骄傲\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假",
"tag": "流行,粤语",
"title": "童年(Cover)",
"morph": {
"riff_id": "83fab52b-3b72-4678-9d5c-820b937bcd92",
"transform": "cover",
"normalized_lyrics_strength": 0.5,
"normalized_sound_prompt_strength": 0.7,
"normalized_weirdness": 0.5,
"normalized_cover_strength": 0.28,
"normalized_variation_strength": null,
"duration": 0
}
}{
"model": "FUZZ-1.1 Pro",
"lyrics": "[Verse]\n嗒嗒时钟轻敲着鼓点\n幼儿园里梦幻的画面\n我们是城堡里的精灵\n欢笑嬉戏乐趣无边\n\n[Verse 2]\n滑滑梯像巨龙的脊背\n哧溜一下欢笑飞\n笑声在空中炸开了花\n连云朵都被逗乐啦\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假\n\n[Verse 3]\n小桌子是知识的港湾\n老师故事满是光环\n温柔话语像火苗温暖\n点燃了我们智慧的帆\n\n[Bridge]\n手拉手在草地上奔跑\n迎着风儿开心地咯咯笑\n阳光牵着我们向上飘\n未来的树冠我们骄傲\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假",
"tag": "流行,粤语",
"title": "童年(Cover)",
"morph": {
"riff_id": "83fab52b-3b72-4678-9d5c-820b937bcd92",
"transform": "cover",
"normalized_lyrics_strength": 0.5,
"normalized_sound_prompt_strength": 0.7,
"normalized_weirdness": 0.5,
"normalized_cover_strength": 0.28,
"normalized_variation_strength": null,
"duration": 0
}
}5. Extend Mode
- Request body
- Use the
idfrom the query result asriff_id crop_end_atis the continuation start time (in seconds)
json
{
"model": "FUZZ-1.1 Pro",
"lyrics": "[Verse]\n嗒嗒时钟轻敲着鼓点\n幼儿园里梦幻的画面\n我们是城堡里的精灵\n欢笑嬉戏乐趣无边\n\n[Verse 2]\n滑滑梯像巨龙的脊背\n哧溜一下欢笑飞\n笑声在空中炸开了花\n连云朵都被逗乐啦\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假\n\n[Verse 3]\n小桌子是知识的港湾\n老师故事满是光环\n温柔话语像火苗温暖\n点燃了我们智慧的帆\n\n[Bridge]\n手拉手在草地上奔跑\n迎着风儿开心地咯咯笑\n阳光牵着我们向上飘\n未来的树冠我们骄傲\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假",
"tag": "流行,粤语",
"title": "童年(Extend)",
"morph": {
"riff_id": "83fab52b-3b72-4678-9d5c-820b937bcd92",
"transform": "extend",
"normalized_lyrics_strength": 0.5,
"normalized_sound_prompt_strength": 0.7,
"normalized_weirdness": 0.5,
"normalized_cover_strength": 0.28,
"normalized_variation_strength": null,
"crop_end_at": 118.932608,
"duration": 0
}
}{
"model": "FUZZ-1.1 Pro",
"lyrics": "[Verse]\n嗒嗒时钟轻敲着鼓点\n幼儿园里梦幻的画面\n我们是城堡里的精灵\n欢笑嬉戏乐趣无边\n\n[Verse 2]\n滑滑梯像巨龙的脊背\n哧溜一下欢笑飞\n笑声在空中炸开了花\n连云朵都被逗乐啦\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假\n\n[Verse 3]\n小桌子是知识的港湾\n老师故事满是光环\n温柔话语像火苗温暖\n点燃了我们智慧的帆\n\n[Bridge]\n手拉手在草地上奔跑\n迎着风儿开心地咯咯笑\n阳光牵着我们向上飘\n未来的树冠我们骄傲\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假",
"tag": "流行,粤语",
"title": "童年(Extend)",
"morph": {
"riff_id": "83fab52b-3b72-4678-9d5c-820b937bcd92",
"transform": "extend",
"normalized_lyrics_strength": 0.5,
"normalized_sound_prompt_strength": 0.7,
"normalized_weirdness": 0.5,
"normalized_cover_strength": 0.28,
"normalized_variation_strength": null,
"crop_end_at": 118.932608,
"duration": 0
}
}6. Inpaint Mode
- Request body
replace_start_atandreplace_end_atdefine the segment to replace (in seconds)
json
{
"model": "FUZZ-1.1 Pro",
"lyrics": "[Verse]\n嗒嗒时钟轻敲着鼓点\n幼儿园里梦幻的画面\n我们是城堡里的精灵\n欢笑嬉戏乐趣无边\n\n[Verse 2]\n滑滑梯像巨龙的脊背\n哧溜一下欢笑飞\n笑声在空中炸开了花\n连云朵都被逗乐啦\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假\n\n[Verse 3]\n小桌子是知识的港湾\n老师故事满是光环\n温柔话语像火苗温暖\n点燃了我们智慧的帆\n\n[Bridge]\n手拉手在草地上奔跑\n迎着风儿开心地咯咯笑\n阳光牵着我们向上飘\n未来的树冠我们骄傲\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假",
"tag": "流行,粤语",
"title": "童年(Inpaint)",
"morph": {
"riff_id": "83fab52b-3b72-4678-9d5c-820b937bcd92",
"transform": "inpaint",
"normalized_lyrics_strength": 0.5,
"normalized_sound_prompt_strength": 0.7,
"normalized_weirdness": 0.5,
"normalized_cover_strength": 0.28,
"normalized_variation_strength": null,
"replace_start_at": 38.16928131842106,
"replace_end_at": 79.50178530438593,
"duration": 0
}
}{
"model": "FUZZ-1.1 Pro",
"lyrics": "[Verse]\n嗒嗒时钟轻敲着鼓点\n幼儿园里梦幻的画面\n我们是城堡里的精灵\n欢笑嬉戏乐趣无边\n\n[Verse 2]\n滑滑梯像巨龙的脊背\n哧溜一下欢笑飞\n笑声在空中炸开了花\n连云朵都被逗乐啦\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假\n\n[Verse 3]\n小桌子是知识的港湾\n老师故事满是光环\n温柔话语像火苗温暖\n点燃了我们智慧的帆\n\n[Bridge]\n手拉手在草地上奔跑\n迎着风儿开心地咯咯笑\n阳光牵着我们向上飘\n未来的树冠我们骄傲\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假",
"tag": "流行,粤语",
"title": "童年(Inpaint)",
"morph": {
"riff_id": "83fab52b-3b72-4678-9d5c-820b937bcd92",
"transform": "inpaint",
"normalized_lyrics_strength": 0.5,
"normalized_sound_prompt_strength": 0.7,
"normalized_weirdness": 0.5,
"normalized_cover_strength": 0.28,
"normalized_variation_strength": null,
"replace_start_at": 38.16928131842106,
"replace_end_at": 79.50178530438593,
"duration": 0
}
}7. Swap Vocals Mode
- Request body
- Use the uploaded audio
idasaudio_upload_id
json
{
"model": "FUZZ-1.1 Pro",
"lyrics": "[Verse]\n嗒嗒时钟轻敲着鼓点\n幼儿园里梦幻的画面\n我们是城堡里的精灵\n欢笑嬉戏乐趣无边\n\n[Verse 2]\n滑滑梯像巨龙的脊背\n哧溜一下欢笑飞\n笑声在空中炸开了花\n连云朵都被逗乐啦\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假\n\n[Verse 3]\n小桌子是知识的港湾\n老师故事满是光环\n温柔话语像火苗温暖\n点燃了我们智慧的帆\n\n[Bridge]\n手拉手在草地上奔跑\n迎着风儿开心地咯咯笑\n阳光牵着我们向上飘\n未来的树冠我们骄傲\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假",
"tag": "流行,粤语",
"title": "童年(Swap vocals)",
"morph": {
"audio_upload_id": "16f61e67-43a0-410c-a9c0-e033e601db27",
"transform": "swap_vocals",
"normalized_lyrics_strength": 0.7,
"normalized_sound_prompt_strength": 0.7,
"normalized_weirdness": 0.5,
"normalized_cover_strength": 1,
"normalized_variation_strength": null,
"duration": 0
}
}{
"model": "FUZZ-1.1 Pro",
"lyrics": "[Verse]\n嗒嗒时钟轻敲着鼓点\n幼儿园里梦幻的画面\n我们是城堡里的精灵\n欢笑嬉戏乐趣无边\n\n[Verse 2]\n滑滑梯像巨龙的脊背\n哧溜一下欢笑飞\n笑声在空中炸开了花\n连云朵都被逗乐啦\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假\n\n[Verse 3]\n小桌子是知识的港湾\n老师故事满是光环\n温柔话语像火苗温暖\n点燃了我们智慧的帆\n\n[Bridge]\n手拉手在草地上奔跑\n迎着风儿开心地咯咯笑\n阳光牵着我们向上飘\n未来的树冠我们骄傲\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假",
"tag": "流行,粤语",
"title": "童年(Swap vocals)",
"morph": {
"audio_upload_id": "16f61e67-43a0-410c-a9c0-e033e601db27",
"transform": "swap_vocals",
"normalized_lyrics_strength": 0.7,
"normalized_sound_prompt_strength": 0.7,
"normalized_weirdness": 0.5,
"normalized_cover_strength": 1,
"normalized_variation_strength": null,
"duration": 0
}
}8. Swap Sound Mode
- Request body
- Use the uploaded audio
idasaudio_upload_id
json
{
"model": "FUZZ-1.1 Pro",
"lyrics": "[Verse]\n嗒嗒时钟轻敲着鼓点\n幼儿园里梦幻的画面\n我们是城堡里的精灵\n欢笑嬉戏乐趣无边\n\n[Verse 2]\n滑滑梯像巨龙的脊背\n哧溜一下欢笑飞\n笑声在空中炸开了花\n连云朵都被逗乐啦\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假\n\n[Verse 3]\n小桌子是知识的港湾\n老师故事满是光环\n温柔话语像火苗温暖\n点燃了我们智慧的帆\n\n[Bridge]\n手拉手在草地上奔跑\n迎着风儿开心地咯咯笑\n阳光牵着我们向上飘\n未来的树冠我们骄傲\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假",
"tag": "流行,粤语",
"title": "童年(Sound swap)",
"morph": {
"audio_upload_id": "16f61e67-43a0-410c-a9c0-e033e601db27",
"transform": "swap_sound",
"normalized_lyrics_strength": 0.7,
"normalized_sound_prompt_strength": 0.7,
"normalized_weirdness": 0.5,
"normalized_cover_strength": 1,
"normalized_variation_strength": null,
"duration": 0
}
}{
"model": "FUZZ-1.1 Pro",
"lyrics": "[Verse]\n嗒嗒时钟轻敲着鼓点\n幼儿园里梦幻的画面\n我们是城堡里的精灵\n欢笑嬉戏乐趣无边\n\n[Verse 2]\n滑滑梯像巨龙的脊背\n哧溜一下欢笑飞\n笑声在空中炸开了花\n连云朵都被逗乐啦\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假\n\n[Verse 3]\n小桌子是知识的港湾\n老师故事满是光环\n温柔话语像火苗温暖\n点燃了我们智慧的帆\n\n[Bridge]\n手拉手在草地上奔跑\n迎着风儿开心地咯咯笑\n阳光牵着我们向上飘\n未来的树冠我们骄傲\n\n[Chorus]\n画笔下涂满了童话\n彩色世界我的表达\n旋转木马上阳光洒\n每一天都像童年的假",
"tag": "流行,粤语",
"title": "童年(Sound swap)",
"morph": {
"audio_upload_id": "16f61e67-43a0-410c-a9c0-e033e601db27",
"transform": "swap_sound",
"normalized_lyrics_strength": 0.7,
"normalized_sound_prompt_strength": 0.7,
"normalized_weirdness": 0.5,
"normalized_cover_strength": 1,
"normalized_variation_strength": null,
"duration": 0
}
}
OpenAi-HK