🎧 音楽モデル Riffusion
- 2025.06.05 このプラットフォームは音楽モデル
Riffusionをサポートするようになりました - 1つのプロンプトで2曲生成されます
- 課金はリクエスト単位で、曲単位ではありません
Riffusion API
- すべてのリクエストにヘッダー
Authorization: Bearer your-keyを含めてください
1. タスクの生成 — プロフェッショナルモード
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":"童年"
}'リクエストボディ
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
// }
}主要フィールドの説明
| フィールド | タイプ | 説明 |
|---|---|---|
| model | string | モデル。オプション:FUZZ-1.0 FUZZ-1.1 FUZZ-1.0 Pro FUZZ-1.1 Pro |
| lyrics | string | 歌詞 |
| tag | string | タグ / スタイル |
| title | string | 曲のタイトル |
| instrumental | boolean | インストゥルメンタルのみを生成するかどうか |
| morph | object | カバー、延長、および類似モードでのみ使用 |
| morph.transform | string | モード。オプション:cover extend inpaint swap_vocals swap_sound |
| morph.riff_id | string | 作成後の曲ID — これまたはaudio_upload_idのいずれかを使用 |
| morph.audio_upload_id | string | アップロードされた曲ID — これまたはriff_idのいずれかを使用 |
| morph.crop_end_at | number | extendモードでの続行開始時間 |
| morph.replace_start_at | number | inpaintモードでの開始時間 |
| morph.replace_end_at | number | inpaintモードでの終了時間 |
- レスポンスボディ
- 後続のタスククエリ用に2つのIDが返されます:
riff_id1とriff_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. タスクのクエリ
get https://api.openai-hk.com/riffusion/feed/{riff_id1},{riff_id2}
- レスポンスボディ
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. オーディオのアップロード
- リクエストボディ — オーディオURLを提供して
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"
}- レスポンスボディ
json
{
"id": "16f61e67-43a0-410c-a9c0-e033e601db27"
}{
"id": "16f61e67-43a0-410c-a9c0-e033e601db27"
}4. カバーモード
- リクエストボディ
- クエリ結果の
idをriff_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. 延長モード
- リクエストボディ
- クエリ結果の
idをriff_idとして使用 crop_end_atは続行開始時間(秒単位)
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. インペイントモード
- リクエストボディ
replace_start_atとreplace_end_atで置換するセグメントを定義(秒単位)
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. ボーカル交換モード
- リクエストボディ
- アップロードされたオーディオの
idをaudio_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. サウンド交換モード
- リクエストボディ
- アップロードされたオーディオの
idをaudio_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