Suno 场景应用

2026.03.27 suno 支持版本 v5.5的 mv 为 chirp-fenix
2026.02.04 suno 支持版本 suno-v4.5-all的 mv 为 chirp-auk-turbo 价格与 suno-3.5 相同
2025.09.23 suno 支持版本 v5的 mv 为 chirp-crow
2025.07.17 suno 支持版本 v4.5+的 mv 为 chirp-bluejay
2025.05.03 suno 支持版本 v4.5的 mv 为 chirp-auk
suno 通过不同的提交格式能应用不同的场景
提交都是 post 到 https://api.openai-hk.com/sunoapi/generate
获取结果都是 get https://api.openai-hk.com/sunoapi/feed/clipsId1,clipsId2
通过下面请求体能产生不同的效果

shell

curl --request POST \
  --url https://api.openai-hk.com/sunoapi/generate \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "gpt_description_prompt": "乡愁"
}'

curl --request POST \
  --url https://api.openai-hk.com/sunoapi/generate \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "gpt_description_prompt": "乡愁"
}'

1.灵感模式

json

{
  "gpt_description_prompt": "乡愁"
}

{
  "gpt_description_prompt": "乡愁"
}

2.自定义.歌词歌名

json

{
  "prompt": "[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梦想梦想何时能实现",
  "mv": "chirp-v3-5",
  "title": "工作",
  "tags": " edm"
}

{
  "prompt": "[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梦想梦想何时能实现",
  "mv": "chirp-v3-5",
  "title": "工作",
  "tags": " edm"
}

3.纯音乐.自定义

json

{
  "prompt": "",
  "tags": "heavy metal",
  "mv": "chirp-v3-5",
  "title": "北京",
  "continue_clip_id": null,
  "continue_at": null,
  "infill_start_s": null,
  "infill_end_s": null
}

{
  "prompt": "",
  "tags": "heavy metal",
  "mv": "chirp-v3-5",
  "title": "北京",
  "continue_clip_id": null,
  "continue_at": null,
  "infill_start_s": null,
  "infill_end_s": null
}

4.纯音乐.灵感模式

json

{
  "gpt_description_prompt": "一首关于彻夜跳舞的国歌舞蹈流行歌曲",
  "mv": "chirp-v3-5",
  "prompt": "",
  "make_instrumental": true
}

{
  "gpt_description_prompt": "一首关于彻夜跳舞的国歌舞蹈流行歌曲",
  "mv": "chirp-v3-5",
  "prompt": "",
  "make_instrumental": true
}

5.续写自定义音频

A.上传音乐

首先通过上传接口得到 clip_id 值为 abcd-1234-1234-1234-abd

B.扩展音乐.带版本信息

mv 为 chirp-v4 chirp-auk chirp-bluejay
task 为 upload_extend

json

{
  "prompt": "歌词",
  "tags": "",
  "negative_tags": "",
  "mv": "chirp-v4",
  "title": "标题",
  "continue_clip_id": "ca94a97d-d3f2-4a63-aeee-ba3a43384bcd",
  "continue_at": 10,
  "task": "upload_extend"
}

{
  "prompt": "歌词",
  "tags": "",
  "negative_tags": "",
  "mv": "chirp-v4",
  "title": "标题",
  "continue_clip_id": "ca94a97d-d3f2-4a63-aeee-ba3a43384bcd",
  "continue_at": 10,
  "task": "upload_extend"
}

C.扩展音乐.将弃用

注意：这里的 mv 是 chirp-v3-5-upload 或者 chirp-v4-upload

json

{
  "prompt": "[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梦想梦想何时能实现",
  "tags": "heavy metal",
  "mv": "chirp-v3-5-upload",
  "title": "工作",
  "continue_clip_id": "abcd-1234-1234-1234-abd",
  "continue_at": 30.792
}

{
  "prompt": "[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梦想梦想何时能实现",
  "tags": "heavy metal",
  "mv": "chirp-v3-5-upload",
  "title": "工作",
  "continue_clip_id": "abcd-1234-1234-1234-abd",
  "continue_at": 30.792
}

D.拼接完整音乐

注意：is_infill 为 false
得后一首替换完的歌曲 id,通过查询接口获取状态
扣费：一首歌的费用
post https://api.openai-hk.com/sunoapi/generate/concat

shell

curl --request POST \
  --url https://api.openai-hk.com/sunoapi/generate/concat \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "clip_id": "newid-1234-1234-1234-one",
  "is_infill": false
}'

curl --request POST \
  --url https://api.openai-hk.com/sunoapi/generate/concat \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "clip_id": "newid-1234-1234-1234-one",
  "is_infill": false
}'

请求体

json

{
  "clip_id": "newid-1234-1234-1234-one",
  "is_infill": false
}

{
  "clip_id": "newid-1234-1234-1234-one",
  "is_infill": false
}

6.续写音乐并获取完整音乐

注意：续写官方产生的音乐自定义不可用

A.生成音乐

可以通过场景 1 2 3 生成音乐获取其中的一首歌的 clip_id 值为 abcd-1234-1234-1234-abd

B.扩展音乐

会得到 2 个新的clip_id 其中一个 newid-1234-1234-1234-one

json

{
  "prompt": "[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梦想梦想何时能实现",
  "tags": "heavy metal",
  "mv": "chirp-v3-5",
  "title": "工作",
  "continue_clip_id": "abcd-1234-1234-1234-abd",
  "continue_at": 30,
  "task": "extend"
}

{
  "prompt": "[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梦想梦想何时能实现",
  "tags": "heavy metal",
  "mv": "chirp-v3-5",
  "title": "工作",
  "continue_clip_id": "abcd-1234-1234-1234-abd",
  "continue_at": 30,
  "task": "extend"
}

C.拼接完整音乐

注意：is_infill 为 false
得后一首替换完的歌曲 id,通过查询接口获取状态
扣费：100 积分(1 分钱)
post https://api.openai-hk.com/sunoapi/generate/concat

shell

curl --request POST \
  --url https://api.openai-hk.com/sunoapi/generate/concat \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "clip_id": "newid-1234-1234-1234-one",
  "is_infill": false
}'

curl --request POST \
  --url https://api.openai-hk.com/sunoapi/generate/concat \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "clip_id": "newid-1234-1234-1234-one",
  "is_infill": false
}'

请求体

json

{
  "clip_id": "newid-1234-1234-1234-one",
  "is_infill": false
}

{
  "clip_id": "newid-1234-1234-1234-one",
  "is_infill": false
}

7.Cover 音乐:音乐翻版\修改风格

A.生成音乐

可以通过场景 1 2 3 生成音乐获取其中的一首歌的 clip_id 值为 abcd-1234-1234-1234-abd
也可以通过上传接口得到 clip_id 这样就可以 cover 自定义音频

B.Cover 音乐

注意 mv为 chirp-v4 chirp-auk 或 chirp-bluejay
task 为 cover
可跨账号使用不用担心账号下线
cover_clip_id 如果是 upload 的 clip_id 为不可跨账号
mv 不在使用 chirp-v3-5-tau chirp-v4-tau

json

{
  "prompt": "[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梦想梦想何时能实现",
  "generation_type": "TEXT",
  "tags": "rock, punk",
  "negative_tags": "",
  "mv": "chirp-auk",
  "title": "工作 (Cover)",
  "continue_clip_id": null,
  "continue_at": null,
  "continued_aligned_prompt": null,
  "infill_start_s": null,
  "infill_end_s": null,
  "task": "cover",
  "cover_clip_id": "abcd-1234-1234-1234-abd"
}

{
  "prompt": "[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梦想梦想何时能实现",
  "generation_type": "TEXT",
  "tags": "rock, punk",
  "negative_tags": "",
  "mv": "chirp-auk",
  "title": "工作 (Cover)",
  "continue_clip_id": null,
  "continue_at": null,
  "continued_aligned_prompt": null,
  "infill_start_s": null,
  "infill_end_s": null,
  "task": "cover",
  "cover_clip_id": "abcd-1234-1234-1234-abd"
}

8.Replace Section:替换片段

A.生成音乐

可以通过场景 1 2 3 生成音乐获取其中的一首歌的 clip_id 值为 abcd-1234-1234-1234-abd

B.Replace Section

task 为 infill
注意 mv为 chirp-v4 或者 chirp-auk 或 chirp-bluejay
提醒：替换的歌词要跟原来的歌词有重复的地方，最好相应的时间能对应上
infill_start_s 开始时间 ,infill_end_s 结束时间，infill_dur_s 为 infill_end_s-infill_start_s
可跨账号使用不用担心账号下线
会得到 2 个新的clip_id 选择其中一个 newid-1234-1234-1234-one 给下一步使用
mv 不在使用 chirp-v3-5-tau chirp-v4-tau

json

{
  "task": "infill",
  "generation_type": "TEXT",
  "title": "思念的刻度-replace",
  "tags": "Sorrow/Sad,Female Vocals,Mandarin",
  "mv": "chirp-auk",
  "prompt": "《思念的刻度》 \n \n作词：阿果依珞\n年轮里刻着你奔跑的温度。 \n每片落叶都在替你呼唤\n可风一吹就碎成雾。 \n整理角落你的吉他 \n琴箱里积攒所有雨季， \n潮湿了玫瑰木的背脊。 \n若把思念缠成新弦， \n怕一碰就碎成 \n当年的回音。 \n时光是倒流的录像带， \n夜越深你笑声越清晰传来。 \n如果眼泪能浇灌时光隧道， \n我愿把眼睛哭成海。 \n当所有春天都与你有关， \n我学会用伤口呼吸。 \n继续爱你， \n用尽",
  "metadata": {
    "infill_lyrics": "。 \n整理角落你的吉他 \n琴箱里积攒所有雨季， \n潮湿了玫瑰木的背脊。 \n若把思念缠成新弦， \n怕一碰就碎成 \n当年的回音"
  },
  "continue_clip_id": "8a858961-8831-4423-8ffb-2dec096aea0a",
  "continued_aligned_prompt": "《思念的刻度》 \n \n作词：阿果依珞\n年轮里刻着你奔跑的温度。 \n每片落叶都在替你呼唤\n可风一吹就碎成雾。 \n整理角落你的吉他 \n琴箱里积攒所有雨季， \n潮湿了玫瑰木的背脊。 \n若把思念缠成新弦， \n怕一碰就碎成 \n当年的回音。 \n时光是倒流的录像带， \n夜越深你笑声越清晰传来。 \n如果眼泪能浇灌时光隧道， \n我愿把眼睛哭成海。 \n当所有春天都与你有关， \n我学会用伤口呼吸。 \n继续爱你， \n用尽所有 \n不再跳动的心跳。\n整理角落你的吉他 \n琴箱里积攒所有雨季， \n潮湿了玫瑰木的背脊。 \n若把思念缠成新弦， \n怕一碰就碎成 \n当年的回音。 \n当所有春天都与你有关， \n我学会用伤口呼吸。 \n继续爱你， \n用尽所有 \n不再跳动的心跳。\n",
  "infill_context_start_s": 3.48,
  "infill_context_end_s": 109.96,
  "infill_start_s": 33.48,
  "infill_end_s": 79.96,
  "infill_dur_s": 46.48
}

{
  "task": "infill",
  "generation_type": "TEXT",
  "title": "思念的刻度-replace",
  "tags": "Sorrow/Sad,Female Vocals,Mandarin",
  "mv": "chirp-auk",
  "prompt": "《思念的刻度》 \n \n作词：阿果依珞\n年轮里刻着你奔跑的温度。 \n每片落叶都在替你呼唤\n可风一吹就碎成雾。 \n整理角落你的吉他 \n琴箱里积攒所有雨季， \n潮湿了玫瑰木的背脊。 \n若把思念缠成新弦， \n怕一碰就碎成 \n当年的回音。 \n时光是倒流的录像带， \n夜越深你笑声越清晰传来。 \n如果眼泪能浇灌时光隧道， \n我愿把眼睛哭成海。 \n当所有春天都与你有关， \n我学会用伤口呼吸。 \n继续爱你， \n用尽",
  "metadata": {
    "infill_lyrics": "。 \n整理角落你的吉他 \n琴箱里积攒所有雨季， \n潮湿了玫瑰木的背脊。 \n若把思念缠成新弦， \n怕一碰就碎成 \n当年的回音"
  },
  "continue_clip_id": "8a858961-8831-4423-8ffb-2dec096aea0a",
  "continued_aligned_prompt": "《思念的刻度》 \n \n作词：阿果依珞\n年轮里刻着你奔跑的温度。 \n每片落叶都在替你呼唤\n可风一吹就碎成雾。 \n整理角落你的吉他 \n琴箱里积攒所有雨季， \n潮湿了玫瑰木的背脊。 \n若把思念缠成新弦， \n怕一碰就碎成 \n当年的回音。 \n时光是倒流的录像带， \n夜越深你笑声越清晰传来。 \n如果眼泪能浇灌时光隧道， \n我愿把眼睛哭成海。 \n当所有春天都与你有关， \n我学会用伤口呼吸。 \n继续爱你， \n用尽所有 \n不再跳动的心跳。\n整理角落你的吉他 \n琴箱里积攒所有雨季， \n潮湿了玫瑰木的背脊。 \n若把思念缠成新弦， \n怕一碰就碎成 \n当年的回音。 \n当所有春天都与你有关， \n我学会用伤口呼吸。 \n继续爱你， \n用尽所有 \n不再跳动的心跳。\n",
  "infill_context_start_s": 3.48,
  "infill_context_end_s": 109.96,
  "infill_start_s": 33.48,
  "infill_end_s": 79.96,
  "infill_dur_s": 46.48
}

C.确认.拼接完整音乐

注意：is_infill 为 true
得后一首替换完的歌曲 id,通过查询接口获取状态
扣费：100 积分(1 分钱)
post https://api.openai-hk.com/sunoapi/generate/concat

shell

curl --request POST \
  --url https://api.openai-hk.com/sunoapi/generate/concat \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "clip_id": "newid-1234-1234-1234-one",
  "is_infill": true
}'

curl --request POST \
  --url https://api.openai-hk.com/sunoapi/generate/concat \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "clip_id": "newid-1234-1234-1234-one",
  "is_infill": true
}'

请求体

json

{
  "clip_id": "newid-1234-1234-1234-one",
  "is_infill": true
}

{
  "clip_id": "newid-1234-1234-1234-one",
  "is_infill": true
}

8.V2 Replace Section: V2 替换片段

要求将 clip_id 为 4cd8a76f-802a-42a5-8064-3ba9c6138072 歌词中的 只是身边再也没有你的气息 替换成 只是昨日再也没有你的气息
其实只有个 身边 替换为 昨日

A.获取时间线

get https://api.openai-hk.com/suno/act/timing/4cd8a76f-802a-42a5-8064-3ba9c6138072

时间线内容参数这儿下载 https://www.openai-hk.com/res/timing.json
用 底忘记寻找得到aligned_lyrics[8].words[8].start_s 为 60.6 做 infill_context_start_s

json

{
  "text": "底",
  "start_s": 60.638297872340424,
  "end_s": 60.71808510638298
}

{
  "text": "底",
  "start_s": 60.638297872340424,
  "end_s": 60.71808510638298
}

用 默默回寻找得到aligned_lyrics[13].words[9].end_s 为 90.6 做 infill_context_end_s

json

{
  "text": "回",
  "start_s": 90.47872340425532,
  "end_s": 90.55851063829788
}

{
  "text": "回",
  "start_s": 90.47872340425532,
  "end_s": 90.55851063829788
}

用 身边寻找得到aligned_lyrics[11]

json

{
  "text": "只是身边再也没有你的气息，",

  "words": [
    。。。。。
    {
      "text": "身",
      "start_s": 75.47872340425532, //这个当做 infill_start_s
      "end_s": 75.55851063829788
    },
    {
      "text": "边",
      "start_s": 75.71808510638299,
      "end_s": 75.79787234042553 //这个当做 infill_end_s
    },
   。。。。
  ]
}

{
  "text": "只是身边再也没有你的气息，",

  "words": [
    。。。。。
    {
      "text": "身",
      "start_s": 75.47872340425532, //这个当做 infill_start_s
      "end_s": 75.55851063829788
    },
    {
      "text": "边",
      "start_s": 75.71808510638299,
      "end_s": 75.79787234042553 //这个当做 infill_end_s
    },
   。。。。
  ]
}

B.替换片段

task 为 fixed_infill
注意 mv仅有 chirp-carp
infill_context_start_s infill_context_end_s infill_start_s infill_end_s 如何获取参考 A.获取时间线
infill_dur_s 为 infill_end_s-infill_start_s
可跨账号使用不用担心账号下线
会得到 2 个新的clip_id 选择其中一个 newid-1234-1234-1234-one 给下一步使用
当 task 为 fixed_infill 时 infill_dur_s 必须小于 26 秒

json

{
  "task": "fixed_infill",
  "generation_type": "TEXT",
  "title": "Replace 01:15-01:15 (06:25 AM Feb 04)",
  "tags": "Love Song,Rock,Acoustic Guitar,Piano,Strings,R&B",
  "negative_tags": "",
  "mv": "chirp-carp",
  "prompt": "底忘记。\n\n[Interlude]\n\n[Verse 2]\n街角的灯光依然那么熟悉，\n只是昨日再也没有你的气息，\n曾经的誓言如今变成了谜题，\n只剩下我在原地默默回",
  "metadata": {
    "create_mode": "custom",
    "infill_lyrics": "昨日",
    "is_remix": true,
    "lyrics_updated": true
  },

  "continue_clip_id": "4cd8a76f-802a-42a5-8064-3ba9c6138072",
  "continued_aligned_prompt": "底忘记。\n\n[Interlude]\n\n[Verse 2]\n街角的灯光依然那么熟悉，\n只是昨日再也没有你的气息，\n曾经的誓言如今变成了谜题，\n只剩下我在原地默默回",
  "continue_at": null,
  "infill_context_start_s": 60.6,
  "infill_context_end_s": 90.6,
  "infill_start_s": 75.44,
  "infill_end_s": 75.8,
  "infill_dur_s": 0.36
}

{
  "task": "fixed_infill",
  "generation_type": "TEXT",
  "title": "Replace 01:15-01:15 (06:25 AM Feb 04)",
  "tags": "Love Song,Rock,Acoustic Guitar,Piano,Strings,R&B",
  "negative_tags": "",
  "mv": "chirp-carp",
  "prompt": "底忘记。\n\n[Interlude]\n\n[Verse 2]\n街角的灯光依然那么熟悉，\n只是昨日再也没有你的气息，\n曾经的誓言如今变成了谜题，\n只剩下我在原地默默回",
  "metadata": {
    "create_mode": "custom",
    "infill_lyrics": "昨日",
    "is_remix": true,
    "lyrics_updated": true
  },

  "continue_clip_id": "4cd8a76f-802a-42a5-8064-3ba9c6138072",
  "continued_aligned_prompt": "底忘记。\n\n[Interlude]\n\n[Verse 2]\n街角的灯光依然那么熟悉，\n只是昨日再也没有你的气息，\n曾经的誓言如今变成了谜题，\n只剩下我在原地默默回",
  "continue_at": null,
  "infill_context_start_s": 60.6,
  "infill_context_end_s": 90.6,
  "infill_start_s": 75.44,
  "infill_end_s": 75.8,
  "infill_dur_s": 0.36
}

C.确认.拼接完整音乐

注意：is_infill 为 true
得后一首替换完的歌曲 id,通过查询接口获取状态
扣费：100 积分(1 分钱)
post https://api.openai-hk.com/sunoapi/generate/concat

shell

curl --request POST \
  --url https://api.openai-hk.com/sunoapi/generate/concat \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "clip_id": "newid-1234-1234-1234-one",
  "is_infill": true
}'

curl --request POST \
  --url https://api.openai-hk.com/sunoapi/generate/concat \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "clip_id": "newid-1234-1234-1234-one",
  "is_infill": true
}'

请求体

json

{
  "clip_id": "newid-1234-1234-1234-one",
  "is_infill": true
}

{
  "clip_id": "newid-1234-1234-1234-one",
  "is_infill": true
}

9.Persona:歌手风格

A.生成音乐

可以通过场景 1 2 3 生成音乐获取其中的一首歌的 clip_id 值为 4cd8a76f-802a-42a5-8064-3ba9c6138072

B.新建 Persona

post https://api.openai-hk.com/sunoapi/persona/create/

clip_id 需要系统内存在的,非 uploader
不能跨账号所以可能账号下线用不了
为防止滥用会扣 100 积分

请求体

json

{
  "root_clip_id": "54834687-5e79-4f08-8e14-cf188f15b598",
  "name": "Persona 标题",
  "description": "Persona 描述",
  "clips": ["54834687-5e79-4f08-8e14-cf188f15b598"],
  "is_public": true
}

{
  "root_clip_id": "54834687-5e79-4f08-8e14-cf188f15b598",
  "name": "Persona 标题",
  "description": "Persona 描述",
  "clips": ["54834687-5e79-4f08-8e14-cf188f15b598"],
  "is_public": true
}

返回体关键的得到 id 为 fd213afd-ac1c-4822-9802-c1c0ea45e77b 设定为 persona_id 供下一步使用

json

{
  "id": "fd213afd-ac1c-4822-9802-c1c0ea45e77b",
  "name": "food",
  "description": "123",
  "root_clip_id": "54834687-5e79-4f08-8e14-cf188f15b598",
  "clip": {
    "id": "54834687-5e79-4f08-8e14-cf188f15b598",
    "video_url": "https://cdn1.suno.ai/54834687-5e79-4f08-8e14-cf188f15b598.mp4",
    "audio_url": "https://cdn1.suno.ai/54834687-5e79-4f08-8e14-cf188f15b598.mp3",
    "image_url": "https://cdn2.suno.ai/image_54834687-5e79-4f08-8e14-cf188f15b598.jpeg",
    "image_large_url": "https://cdn2.suno.ai/image_large_54834687-5e79-4f08-8e14-cf188f15b598.jpeg",
    "major_model_version": "v4",
    "model_name": "chirp-v4",
    "metadata": {
      "tags": "electronic pop, tropical house fusion",
      "prompt": "",
      "type": "gen",
      "duration": 190,
      "refund_credits": false,
      "stream": true
    },
    "is_liked": false,
    "user_id": "21de6d0f-398c-467c-9957-8fa9065f3ca6",
    "display_name": "SensoryRecorders4685",
    "handle": "sensoryrecorders4685",
    "is_handle_updated": false,
    "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
    "is_trashed": false,
    "created_at": "2024-12-23T10:34:30.144Z",
    "status": "complete",
    "title": "noks noko wane",
    "play_count": 0,
    "upvote_count": 0,
    "is_public": false
  },
  "user_display_name": "SensoryRecorders4685",
  "user_handle": "sensoryrecorders4685",
  "user_image_url": "https://cdn1.suno.ai/defaultPink.webp",
  "persona_clips": [
    {
      "clip": {
        "id": "54834687-5e79-4f08-8e14-cf188f15b598",
        "video_url": "https://cdn1.suno.ai/54834687-5e79-4f08-8e14-cf188f15b598.mp4",
        "audio_url": "https://cdn1.suno.ai/54834687-5e79-4f08-8e14-cf188f15b598.mp3",
        "image_url": "https://cdn2.suno.ai/image_54834687-5e79-4f08-8e14-cf188f15b598.jpeg",
        "image_large_url": "https://cdn2.suno.ai/image_large_54834687-5e79-4f08-8e14-cf188f15b598.jpeg",
        "major_model_version": "v4",
        "model_name": "chirp-v4",
        "metadata": {
          "tags": "electronic pop, tropical house fusion",
          "prompt": "",
          "type": "gen",
          "duration": 190,
          "refund_credits": false,
          "stream": true
        },
        "is_liked": false,
        "user_id": "21de6d0f-398c-467c-9957-8fa9065f3ca6",
        "display_name": "SensoryRecorders4685",
        "handle": "sensoryrecorders4685",
        "is_handle_updated": false,
        "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
        "is_trashed": false,
        "created_at": "2024-12-23T10:34:30.144Z",
        "status": "complete",
        "title": "noks noko wane",
        "play_count": 0,
        "upvote_count": 0,
        "is_public": false
      },
      "id": 11288925
    }
  ]
}

{
  "id": "fd213afd-ac1c-4822-9802-c1c0ea45e77b",
  "name": "food",
  "description": "123",
  "root_clip_id": "54834687-5e79-4f08-8e14-cf188f15b598",
  "clip": {
    "id": "54834687-5e79-4f08-8e14-cf188f15b598",
    "video_url": "https://cdn1.suno.ai/54834687-5e79-4f08-8e14-cf188f15b598.mp4",
    "audio_url": "https://cdn1.suno.ai/54834687-5e79-4f08-8e14-cf188f15b598.mp3",
    "image_url": "https://cdn2.suno.ai/image_54834687-5e79-4f08-8e14-cf188f15b598.jpeg",
    "image_large_url": "https://cdn2.suno.ai/image_large_54834687-5e79-4f08-8e14-cf188f15b598.jpeg",
    "major_model_version": "v4",
    "model_name": "chirp-v4",
    "metadata": {
      "tags": "electronic pop, tropical house fusion",
      "prompt": "",
      "type": "gen",
      "duration": 190,
      "refund_credits": false,
      "stream": true
    },
    "is_liked": false,
    "user_id": "21de6d0f-398c-467c-9957-8fa9065f3ca6",
    "display_name": "SensoryRecorders4685",
    "handle": "sensoryrecorders4685",
    "is_handle_updated": false,
    "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
    "is_trashed": false,
    "created_at": "2024-12-23T10:34:30.144Z",
    "status": "complete",
    "title": "noks noko wane",
    "play_count": 0,
    "upvote_count": 0,
    "is_public": false
  },
  "user_display_name": "SensoryRecorders4685",
  "user_handle": "sensoryrecorders4685",
  "user_image_url": "https://cdn1.suno.ai/defaultPink.webp",
  "persona_clips": [
    {
      "clip": {
        "id": "54834687-5e79-4f08-8e14-cf188f15b598",
        "video_url": "https://cdn1.suno.ai/54834687-5e79-4f08-8e14-cf188f15b598.mp4",
        "audio_url": "https://cdn1.suno.ai/54834687-5e79-4f08-8e14-cf188f15b598.mp3",
        "image_url": "https://cdn2.suno.ai/image_54834687-5e79-4f08-8e14-cf188f15b598.jpeg",
        "image_large_url": "https://cdn2.suno.ai/image_large_54834687-5e79-4f08-8e14-cf188f15b598.jpeg",
        "major_model_version": "v4",
        "model_name": "chirp-v4",
        "metadata": {
          "tags": "electronic pop, tropical house fusion",
          "prompt": "",
          "type": "gen",
          "duration": 190,
          "refund_credits": false,
          "stream": true
        },
        "is_liked": false,
        "user_id": "21de6d0f-398c-467c-9957-8fa9065f3ca6",
        "display_name": "SensoryRecorders4685",
        "handle": "sensoryrecorders4685",
        "is_handle_updated": false,
        "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
        "is_trashed": false,
        "created_at": "2024-12-23T10:34:30.144Z",
        "status": "complete",
        "title": "noks noko wane",
        "play_count": 0,
        "upvote_count": 0,
        "is_public": false
      },
      "id": 11288925
    }
  ]
}

C.使用 persona_id 创作

post https://api.openai-hk.com/suno/generate

注意 mv 为 chirp-v4 或者 chirp-auk 或 chirp-bluejay
task 为 artist_consistency
persona_id 为 B 步骤得到的
artist_clip_id 就是 A 步骤中的 clip_id
可跨账号
mv 不在使用 chirp-v3-5-tau chirp-v4-tau

json

{
  "prompt": "[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[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
  "generation_type": "TEXT",
  "tags": "electronic, pop",
  "negative_tags": "",
  "mv": "chirp-v4",
  "title": "老公",
  "task": "artist_consistency",
  "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
  "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163"
}

{
  "prompt": "[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[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
  "generation_type": "TEXT",
  "tags": "electronic, pop",
  "negative_tags": "",
  "mv": "chirp-v4",
  "title": "老公",
  "task": "artist_consistency",
  "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
  "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163"
}

返回体

json

{
  "id": "2d453a5f-c539-4fe0-9a66-24058c5dfb6a",
  "clips": [
    {
      "id": "0e6937df-64d8-41f9-82c6-b6dadc4426a8",
      "video_url": "",
      "audio_url": "",
      "major_model_version": "v4",
      "model_name": "chirp-v4",
      "metadata": {
        "tags": "electronic, pop",
        "prompt": "[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[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
        "type": "gen",
        "stream": true,
        "has_vocal": false,
        "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
        "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
        "task": "artist_consistency"
      },
      "is_liked": false,
      "user_id": "a3da04d5-0442-4bd3-b837-4c73ff600914",
      "display_name": "TwinklingVenue1595",
      "handle": "twinklingvenue1595",
      "is_handle_updated": false,
      "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
      "is_trashed": false,
      "created_at": "2024-12-23T10:37:43.596Z",
      "status": "submitted",
      "title": "老公",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    },
    {
      "id": "fff58de4-7ccc-4b95-937b-3b66ec07cc65",
      "video_url": "",
      "audio_url": "",
      "major_model_version": "v4",
      "model_name": "chirp-v4",
      "metadata": {
        "tags": "electronic, pop",
        "prompt": "[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[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
        "type": "gen",
        "stream": true,
        "has_vocal": false,
        "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
        "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
        "task": "artist_consistency"
      },
      "is_liked": false,
      "user_id": "a3da04d5-0442-4bd3-b837-4c73ff600914",
      "display_name": "TwinklingVenue1595",
      "handle": "twinklingvenue1595",
      "is_handle_updated": false,
      "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
      "is_trashed": false,
      "created_at": "2024-12-23T10:37:43.596Z",
      "status": "submitted",
      "title": "老公",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    }
  ],
  "metadata": {
    "tags": "electronic, pop",
    "prompt": "[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[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
    "type": "gen",
    "stream": true,
    "has_vocal": false,
    "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
    "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
    "task": "artist_consistency"
  },
  "major_model_version": "v4",
  "status": "complete",
  "created_at": "2024-12-23T10:37:43.581Z",
  "batch_size": 1
}

{
  "id": "2d453a5f-c539-4fe0-9a66-24058c5dfb6a",
  "clips": [
    {
      "id": "0e6937df-64d8-41f9-82c6-b6dadc4426a8",
      "video_url": "",
      "audio_url": "",
      "major_model_version": "v4",
      "model_name": "chirp-v4",
      "metadata": {
        "tags": "electronic, pop",
        "prompt": "[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[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
        "type": "gen",
        "stream": true,
        "has_vocal": false,
        "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
        "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
        "task": "artist_consistency"
      },
      "is_liked": false,
      "user_id": "a3da04d5-0442-4bd3-b837-4c73ff600914",
      "display_name": "TwinklingVenue1595",
      "handle": "twinklingvenue1595",
      "is_handle_updated": false,
      "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
      "is_trashed": false,
      "created_at": "2024-12-23T10:37:43.596Z",
      "status": "submitted",
      "title": "老公",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    },
    {
      "id": "fff58de4-7ccc-4b95-937b-3b66ec07cc65",
      "video_url": "",
      "audio_url": "",
      "major_model_version": "v4",
      "model_name": "chirp-v4",
      "metadata": {
        "tags": "electronic, pop",
        "prompt": "[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[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
        "type": "gen",
        "stream": true,
        "has_vocal": false,
        "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
        "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
        "task": "artist_consistency"
      },
      "is_liked": false,
      "user_id": "a3da04d5-0442-4bd3-b837-4c73ff600914",
      "display_name": "TwinklingVenue1595",
      "handle": "twinklingvenue1595",
      "is_handle_updated": false,
      "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
      "is_trashed": false,
      "created_at": "2024-12-23T10:37:43.596Z",
      "status": "submitted",
      "title": "老公",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    }
  ],
  "metadata": {
    "tags": "electronic, pop",
    "prompt": "[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[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
    "type": "gen",
    "stream": true,
    "has_vocal": false,
    "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
    "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
    "task": "artist_consistency"
  },
  "major_model_version": "v4",
  "status": "complete",
  "created_at": "2024-12-23T10:37:43.581Z",
  "batch_size": 1
}

10.stems:声曲分离 Vocals Instrumental

分离后 Vocals 人声
分离后 Instrumental 纯音乐伴奏

A.生成音乐

可以通过场景 1 2 3 生成音乐获取其中的一首歌的 clip_id 值为 a624123d-22cc-4d4d-bf28-78d312f61597

B.声曲分离(弃用)

官方已弃用，请使用下面新的接口
get https://api.openai-hk.com/sunoapi/act/stems/a624123d-22cc-4d4d-bf28-78d312f61597
为防止滥用会扣除 100 积分
返回体，得到 clip_1,clip_2
不可跨账号，账号下线后不可调用

B.声曲分离.新

post https://api.openai-hk.com/suno/generate

请求体

注意 mv为 chirp-auk
task 为 gen_stem
stem_task 为 two
stem_type_group_name 为 Two
continue_clip_id 就是 A 步骤中的 clip_id
可跨账号
计费:一次生成费用

json

{
  "task": "gen_stem",
  "generation_type": "TEXT",
  "title": "安全之弦",
  "mv": "chirp-auk",
  "prompt": "",
  "make_instrumental": true,
  "continue_clip_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
  "continued_aligned_prompt": null,
  "continue_at": null,
  "stem_type_id": 91,
  "stem_type_group_name": "Two",
  "stem_task": "two"
}

{
  "task": "gen_stem",
  "generation_type": "TEXT",
  "title": "安全之弦",
  "mv": "chirp-auk",
  "prompt": "",
  "make_instrumental": true,
  "continue_clip_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
  "continued_aligned_prompt": null,
  "continue_at": null,
  "stem_type_id": 91,
  "stem_type_group_name": "Two",
  "stem_task": "two"
}

返回体

json

{
  "clips": [
    {
      "id": "5f3587e2-75fb-4c36-84b3-3ec113897a4c",
      "video_url": "",
      "audio_url": "",
      "major_model_version": "",
      "model_name": "",
      "metadata": {
        "tags": "Chinese",
        "prompt": "在那遥远的星空之下，如今谁还在彷徨？\n就像无法游泳的鱼儿，我却只能责怪自己没有坚强的鳍片。\n快将彷徨化成力量，快把挫折当做指南。\n直到梦想实现之前，我坚定地守候着。\n昨天流逝了岁月，明天我将追随风的脚步，攀上高峰。\n呼唤吧，让我们出发，骑在梦想龙的脊背，穿越命运的坎坷。\n摆脱困境的束缚，即使失去了一切，人仍然渴望温暖的拥抱。\n人之所以能体会到他人的快乐，是因为心灵的善良。\n快将彷徨化成力量，快把挫折当做指南。\n我还是那只无法游泳的鱼儿，责怪自己没有坚强的鳍片。",
        "stem_from_id": "a624123d-22cc-4d4d-bf28-78d312f61597",
        "type": "stem",
        "duration": 217.24
      },
      "is_liked": false,
      "user_id": "58387c47-dc80-466f-a7b1-a2eed61c24fb",
      "display_name": "FluidXylophone2289",
      "handle": "fluidxylophone2289",
      "is_handle_updated": false,
      "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
      "is_trashed": false,
      "created_at": "2024-12-25T16:51:36.619Z",
      "status": "queued",
      "title": "骑在梦想龙的脊背 - Vocals",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    },
    {
      "id": "9c85d619-4cac-4561-8fa3-604c116fa1c5",
      "video_url": "",
      "audio_url": "",
      "major_model_version": "",
      "model_name": "",
      "metadata": {
        "tags": "Chinese",
        "prompt": "",
        "stem_from_id": "a624123d-22cc-4d4d-bf28-78d312f61597",
        "type": "stem",
        "duration": 217.24
      },
      "is_liked": false,
      "user_id": "58387c47-dc80-466f-a7b1-a2eed61c24fb",
      "display_name": "FluidXylophone2289",
      "handle": "fluidxylophone2289",
      "is_handle_updated": false,
      "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
      "is_trashed": false,
      "created_at": "2024-12-25T16:51:36.625Z",
      "status": "queued",
      "title": "骑在梦想龙的脊背 - Instrumental",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    }
  ]
}

{
  "clips": [
    {
      "id": "5f3587e2-75fb-4c36-84b3-3ec113897a4c",
      "video_url": "",
      "audio_url": "",
      "major_model_version": "",
      "model_name": "",
      "metadata": {
        "tags": "Chinese",
        "prompt": "在那遥远的星空之下，如今谁还在彷徨？\n就像无法游泳的鱼儿，我却只能责怪自己没有坚强的鳍片。\n快将彷徨化成力量，快把挫折当做指南。\n直到梦想实现之前，我坚定地守候着。\n昨天流逝了岁月，明天我将追随风的脚步，攀上高峰。\n呼唤吧，让我们出发，骑在梦想龙的脊背，穿越命运的坎坷。\n摆脱困境的束缚，即使失去了一切，人仍然渴望温暖的拥抱。\n人之所以能体会到他人的快乐，是因为心灵的善良。\n快将彷徨化成力量，快把挫折当做指南。\n我还是那只无法游泳的鱼儿，责怪自己没有坚强的鳍片。",
        "stem_from_id": "a624123d-22cc-4d4d-bf28-78d312f61597",
        "type": "stem",
        "duration": 217.24
      },
      "is_liked": false,
      "user_id": "58387c47-dc80-466f-a7b1-a2eed61c24fb",
      "display_name": "FluidXylophone2289",
      "handle": "fluidxylophone2289",
      "is_handle_updated": false,
      "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
      "is_trashed": false,
      "created_at": "2024-12-25T16:51:36.619Z",
      "status": "queued",
      "title": "骑在梦想龙的脊背 - Vocals",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    },
    {
      "id": "9c85d619-4cac-4561-8fa3-604c116fa1c5",
      "video_url": "",
      "audio_url": "",
      "major_model_version": "",
      "model_name": "",
      "metadata": {
        "tags": "Chinese",
        "prompt": "",
        "stem_from_id": "a624123d-22cc-4d4d-bf28-78d312f61597",
        "type": "stem",
        "duration": 217.24
      },
      "is_liked": false,
      "user_id": "58387c47-dc80-466f-a7b1-a2eed61c24fb",
      "display_name": "FluidXylophone2289",
      "handle": "fluidxylophone2289",
      "is_handle_updated": false,
      "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
      "is_trashed": false,
      "created_at": "2024-12-25T16:51:36.625Z",
      "status": "queued",
      "title": "骑在梦想龙的脊背 - Instrumental",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    }
  ]
}

C.获取结果

get https://api.openai-hk.com/sunoapi/feed/5f3587e2-75fb-4c36-84b3-3ec113897a4c,9c85d619-4cac-4561-8fa3-604c116fa1c5

返回体

json

[
  {
    "audio_url": "https://cdn1.suno.ai/5f3587e2-75fb-4c36-84b3-3ec113897a4c.mp3",
    "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
    "created_at": "2024-12-25T16:51:36.619Z",
    "display_name": "FluidXylophone2289",
    "handle": "fluidxylophone2289",
    "id": "5f3587e2-75fb-4c36-84b3-3ec113897a4c",
    "image_large_url": "https://cdn2.suno.ai/image_large_5f3587e2-75fb-4c36-84b3-3ec113897a4c.jpeg",
    "image_url": "https://cdn2.suno.ai/image_5f3587e2-75fb-4c36-84b3-3ec113897a4c.jpeg",
    "is_handle_updated": false,
    "is_liked": false,
    "is_public": false,
    "is_trashed": false,
    "major_model_version": "",
    "metadata": {
      "duration": 217.24,
      "prompt": "在那遥远的星空之下，如今谁还在彷徨？\n就像无法游泳的鱼儿，我却只能责怪自己没有坚强的鳍片。\n快将彷徨化成力量，快把挫折当做指南。\n直到梦想实现之前，我坚定地守候着。\n昨天流逝了岁月，明天我将追随风的脚步，攀上高峰。\n呼唤吧，让我们出发，骑在梦想龙的脊背，穿越命运的坎坷。\n摆脱困境的束缚，即使失去了一切，人仍然渴望温暖的拥抱。\n人之所以能体会到他人的快乐，是因为心灵的善良。\n快将彷徨化成力量，快把挫折当做指南。\n我还是那只无法游泳的鱼儿，责怪自己没有坚强的鳍片。",
      "stem_from_id": "a624123d-22cc-4d4d-bf28-78d312f61597",
      "tags": "Chinese",
      "type": "stem"
    },
    "model_name": "",
    "play_count": 0,
    "status": "complete",
    "title": "骑在梦想龙的脊背 - Vocals",
    "upvote_count": 0,
    "video_url": "https://cdn1.suno.ai/5f3587e2-75fb-4c36-84b3-3ec113897a4c.mp4"
  },
  {
    "audio_url": "https://cdn1.suno.ai/9c85d619-4cac-4561-8fa3-604c116fa1c5.mp3",
    "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
    "created_at": "2024-12-25T16:51:36.625Z",
    "display_name": "FluidXylophone2289",
    "handle": "fluidxylophone2289",
    "id": "9c85d619-4cac-4561-8fa3-604c116fa1c5",
    "image_large_url": "https://cdn2.suno.ai/image_large_9c85d619-4cac-4561-8fa3-604c116fa1c5.jpeg",
    "image_url": "https://cdn2.suno.ai/image_9c85d619-4cac-4561-8fa3-604c116fa1c5.jpeg",
    "is_handle_updated": false,
    "is_liked": false,
    "is_public": false,
    "is_trashed": false,
    "major_model_version": "",
    "metadata": {
      "duration": 217.24,
      "prompt": "",
      "stem_from_id": "a624123d-22cc-4d4d-bf28-78d312f61597",
      "tags": "Chinese",
      "type": "stem"
    },
    "model_name": "",
    "play_count": 0,
    "status": "complete",
    "title": "骑在梦想龙的脊背 - Instrumental",
    "upvote_count": 0,
    "video_url": "https://cdn1.suno.ai/9c85d619-4cac-4561-8fa3-604c116fa1c5.mp4"
  }
]

[
  {
    "audio_url": "https://cdn1.suno.ai/5f3587e2-75fb-4c36-84b3-3ec113897a4c.mp3",
    "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
    "created_at": "2024-12-25T16:51:36.619Z",
    "display_name": "FluidXylophone2289",
    "handle": "fluidxylophone2289",
    "id": "5f3587e2-75fb-4c36-84b3-3ec113897a4c",
    "image_large_url": "https://cdn2.suno.ai/image_large_5f3587e2-75fb-4c36-84b3-3ec113897a4c.jpeg",
    "image_url": "https://cdn2.suno.ai/image_5f3587e2-75fb-4c36-84b3-3ec113897a4c.jpeg",
    "is_handle_updated": false,
    "is_liked": false,
    "is_public": false,
    "is_trashed": false,
    "major_model_version": "",
    "metadata": {
      "duration": 217.24,
      "prompt": "在那遥远的星空之下，如今谁还在彷徨？\n就像无法游泳的鱼儿，我却只能责怪自己没有坚强的鳍片。\n快将彷徨化成力量，快把挫折当做指南。\n直到梦想实现之前，我坚定地守候着。\n昨天流逝了岁月，明天我将追随风的脚步，攀上高峰。\n呼唤吧，让我们出发，骑在梦想龙的脊背，穿越命运的坎坷。\n摆脱困境的束缚，即使失去了一切，人仍然渴望温暖的拥抱。\n人之所以能体会到他人的快乐，是因为心灵的善良。\n快将彷徨化成力量，快把挫折当做指南。\n我还是那只无法游泳的鱼儿，责怪自己没有坚强的鳍片。",
      "stem_from_id": "a624123d-22cc-4d4d-bf28-78d312f61597",
      "tags": "Chinese",
      "type": "stem"
    },
    "model_name": "",
    "play_count": 0,
    "status": "complete",
    "title": "骑在梦想龙的脊背 - Vocals",
    "upvote_count": 0,
    "video_url": "https://cdn1.suno.ai/5f3587e2-75fb-4c36-84b3-3ec113897a4c.mp4"
  },
  {
    "audio_url": "https://cdn1.suno.ai/9c85d619-4cac-4561-8fa3-604c116fa1c5.mp3",
    "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
    "created_at": "2024-12-25T16:51:36.625Z",
    "display_name": "FluidXylophone2289",
    "handle": "fluidxylophone2289",
    "id": "9c85d619-4cac-4561-8fa3-604c116fa1c5",
    "image_large_url": "https://cdn2.suno.ai/image_large_9c85d619-4cac-4561-8fa3-604c116fa1c5.jpeg",
    "image_url": "https://cdn2.suno.ai/image_9c85d619-4cac-4561-8fa3-604c116fa1c5.jpeg",
    "is_handle_updated": false,
    "is_liked": false,
    "is_public": false,
    "is_trashed": false,
    "major_model_version": "",
    "metadata": {
      "duration": 217.24,
      "prompt": "",
      "stem_from_id": "a624123d-22cc-4d4d-bf28-78d312f61597",
      "tags": "Chinese",
      "type": "stem"
    },
    "model_name": "",
    "play_count": 0,
    "status": "complete",
    "title": "骑在梦想龙的脊背 - Instrumental",
    "upvote_count": 0,
    "video_url": "https://cdn1.suno.ai/9c85d619-4cac-4561-8fa3-604c116fa1c5.mp4"
  }
]

11.Timing:歌词、音频时间线

A.生成音乐

可以通过场景 1 2 3 生成音乐获取其中的一首歌的 clip_id 值为 54834687-5e79-4f08-8e14-cf188f15b598

B.获取歌词

可跨账号
get https://api.openai-hk.com/sunoapi/act/timing/a624123d-22cc-4d4d-bf28-78d312f61597

返回体

json

{
  "aligned_words": [
    {
      "word": "[Verse]\nWinter ",
      "success": true,
      "start_s": 8.38,
      "end_s": 8.78,
      "p_align": 0.982
    },
    {
      "word": "winds ",
      "success": true,
      "start_s": 8.78,
      "end_s": 9.54,
      "p_align": 0.961
    },
    {
      "word": "they ",
      "success": true,
      "start_s": 9.54,
      "end_s": 9.93,
      "p_align": 0.99
    },
    {
      "word": "cut ",
      "success": true,
      "start_s": 9.93,
      "end_s": 10.41,
      "p_align": 0.998
    },
    {
      "word": "so ",
      "success": true,
      "start_s": 10.41,
      "end_s": 10.93,
      "p_align": 0.996
    },
    {
      "word": "deep\n",
      "success": true,
      "start_s": 10.93,
      "end_s": 11.93,
      "p_align": 0.997
    },
    ....
  ],
  "waveform_data": [
    0.001, 0.00109, 0.04219, 0.03597, ....
  ],
  "hoot_cer": 0.03556771545827633,
  "is_streamed": false
}

{
  "aligned_words": [
    {
      "word": "[Verse]\nWinter ",
      "success": true,
      "start_s": 8.38,
      "end_s": 8.78,
      "p_align": 0.982
    },
    {
      "word": "winds ",
      "success": true,
      "start_s": 8.78,
      "end_s": 9.54,
      "p_align": 0.961
    },
    {
      "word": "they ",
      "success": true,
      "start_s": 9.54,
      "end_s": 9.93,
      "p_align": 0.99
    },
    {
      "word": "cut ",
      "success": true,
      "start_s": 9.93,
      "end_s": 10.41,
      "p_align": 0.998
    },
    {
      "word": "so ",
      "success": true,
      "start_s": 10.41,
      "end_s": 10.93,
      "p_align": 0.996
    },
    {
      "word": "deep\n",
      "success": true,
      "start_s": 10.93,
      "end_s": 11.93,
      "p_align": 0.997
    },
    ....
  ],
  "waveform_data": [
    0.001, 0.00109, 0.04219, 0.03597, ....
  ],
  "hoot_cer": 0.03556771545827633,
  "is_streamed": false
}

12.wav:获取 wav 格式文件

A.生成音乐

可以通过场景 1 2 3 生成音乐获取其中的一首歌的 clip_id 值为 a624123d-22cc-4d4d-bf28-78d312f61597

B.获取 wav 文件

get https://api.openai-hk.com/sunoapi/act/wav/a624123d-22cc-4d4d-bf28-78d312f61597

如果返回体 wav_file_url 为 null 多获取几次
为防止滥用会扣除 100 积分
不可跨账号，账号下线后不可调用
返回体

json

{
  "wav_file_url": "https://cdn1.suno.ai/a624123d-22cc-4d4d-bf28-78d312f61597.wav"
}

{
  "wav_file_url": "https://cdn1.suno.ai/a624123d-22cc-4d4d-bf28-78d312f61597.wav"
}

13.mp4:生成 mp4 mv 视频

A.生成音乐

可以通过场景 1 2 3 生成音乐获取其中的一首歌的 clip_id 值为 a624123d-22cc-4d4d-bf28-78d312f61597

B.获取 mp4 文件

get https://api.openai-hk.com/sunoapi/act/mp4/a624123d-22cc-4d4d-bf28-78d312f61597

需要状态是 complete 执行才有效果
执行完需要，等等 30 秒后 url 才能访问
为防止滥用会扣除 100 积分
不可跨账号，账号下线后不可调用
返回体

json

{
  "mp4": "https://cdn1.suno.ai/a624123d-22cc-4d4d-bf28-78d312f61597.mp4"
}

{
  "mp4": "https://cdn1.suno.ai/a624123d-22cc-4d4d-bf28-78d312f61597.mp4"
}

14.all-stems:全轨声曲分离

A.生成音乐

可以通过场景 1 2 3 生成音乐获取其中的一首歌的 clip_id 值为 a624123d-22cc-4d4d-bf28-78d312f61597

B.全轨声曲分离

post https://api.openai-hk.com/suno/generate

注意 mv chirp-auk
task 为 gen_stem
stem_task 为 twelve
stem_type_group_name 为 Twelve
continue_clip_id 就是 A 步骤中的 clip_id
可跨账号
计费 5 倍基础价格，5 次 10 首歌的价格

json

{
  "task": "gen_stem",
  "generation_type": "TEXT",
  "title": "安全之弦",
  "mv": "chirp-auk",
  "prompt": "",
  "make_instrumental": true,
  "continue_clip_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
  "continued_aligned_prompt": null,
  "continue_at": null,
  "stem_type_id": 91,
  "stem_type_group_name": "Twelve",
  "stem_task": "twelve"
}

{
  "task": "gen_stem",
  "generation_type": "TEXT",
  "title": "安全之弦",
  "mv": "chirp-auk",
  "prompt": "",
  "make_instrumental": true,
  "continue_clip_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
  "continued_aligned_prompt": null,
  "continue_at": null,
  "stem_type_id": 91,
  "stem_type_group_name": "Twelve",
  "stem_task": "twelve"
}

返回 24 个 clip_id
使用 24 个 clip_id 一口气查询
返回体实例

json

{
  "id": "b19ee87f-574d-42c7-9761-df6aafc0fd9c",
  "clips": [
    {
      "id": "0e5be1db-4834-4890-acfb-2fea7fd24eb9",
      "entity_type": "song_schema",
      "video_url": "",
      "audio_url": "",
      "major_model_version": "",
      "model_name": "chirp-stem",
      "metadata": {
        "prompt": "",
        "history": [
          {
            "id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
            "type": "gen",
            "source": "web",
            "infill": false,
            "stem_type_id": 91,
            "stem_type_group_name": "Twelve",
            "stem_task": "twelve",
            "stem_from_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc"
          }
        ],
        "stem_from_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
        "stem_task": "twelve",
        "stem_type_id": 91,
        "stem_type_group_name": "Vocals",
        "edited_clip_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
        "type": "gen",
        "stream": true,
        "infill": false,
        "task": "gen_stem",
        "can_remix": true,
        "is_remix": false,
        "priority": 10
      },
      "is_liked": false,
      "user_id": "a8a4d117-d5aa-4a9f-ab5b-88cc2c2eb79d",
      "display_name": "ugknurymt91r",
      "handle": "ugknurymt91r",
      "is_handle_updated": false,
      "avatar_image_url": "https://cdn1.suno.ai/sAura20.jpg",
      "is_trashed": false,
      "flag_count": 0,
      "created_at": "2025-06-06T11:22:30.753Z",
      "status": "submitted",
      "title": "安全之弦 (Vocals)",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false,
      "allow_comments": true
    },
    {
      "more": "有24个类似这样的东西"
    }
  ],
  "metadata": {
    "prompt": "",
    "history": [
      {
        "id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
        "type": "gen",
        "source": "web",
        "infill": false,
        "stem_type_id": 91,
        "stem_type_group_name": "Twelve",
        "stem_task": "twelve",
        "stem_from_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc"
      }
    ],
    "stem_from_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
    "stem_task": "twelve",
    "stem_type_id": 91,
    "stem_type_group_name": "Twelve",
    "edited_clip_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
    "type": "gen",
    "stream": true,
    "infill": false,
    "task": "gen_stem",
    "can_remix": true,
    "is_remix": false,
    "priority": 10
  },
  "major_model_version": "",
  "status": "complete",
  "created_at": "2025-06-06T11:22:30.737Z",
  "batch_size": 1
}

{
  "id": "b19ee87f-574d-42c7-9761-df6aafc0fd9c",
  "clips": [
    {
      "id": "0e5be1db-4834-4890-acfb-2fea7fd24eb9",
      "entity_type": "song_schema",
      "video_url": "",
      "audio_url": "",
      "major_model_version": "",
      "model_name": "chirp-stem",
      "metadata": {
        "prompt": "",
        "history": [
          {
            "id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
            "type": "gen",
            "source": "web",
            "infill": false,
            "stem_type_id": 91,
            "stem_type_group_name": "Twelve",
            "stem_task": "twelve",
            "stem_from_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc"
          }
        ],
        "stem_from_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
        "stem_task": "twelve",
        "stem_type_id": 91,
        "stem_type_group_name": "Vocals",
        "edited_clip_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
        "type": "gen",
        "stream": true,
        "infill": false,
        "task": "gen_stem",
        "can_remix": true,
        "is_remix": false,
        "priority": 10
      },
      "is_liked": false,
      "user_id": "a8a4d117-d5aa-4a9f-ab5b-88cc2c2eb79d",
      "display_name": "ugknurymt91r",
      "handle": "ugknurymt91r",
      "is_handle_updated": false,
      "avatar_image_url": "https://cdn1.suno.ai/sAura20.jpg",
      "is_trashed": false,
      "flag_count": 0,
      "created_at": "2025-06-06T11:22:30.753Z",
      "status": "submitted",
      "title": "安全之弦 (Vocals)",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false,
      "allow_comments": true
    },
    {
      "more": "有24个类似这样的东西"
    }
  ],
  "metadata": {
    "prompt": "",
    "history": [
      {
        "id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
        "type": "gen",
        "source": "web",
        "infill": false,
        "stem_type_id": 91,
        "stem_type_group_name": "Twelve",
        "stem_task": "twelve",
        "stem_from_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc"
      }
    ],
    "stem_from_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
    "stem_task": "twelve",
    "stem_type_id": 91,
    "stem_type_group_name": "Twelve",
    "edited_clip_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
    "type": "gen",
    "stream": true,
    "infill": false,
    "task": "gen_stem",
    "can_remix": true,
    "is_remix": false,
    "priority": 10
  },
  "major_model_version": "",
  "status": "complete",
  "created_at": "2025-06-06T11:22:30.737Z",
  "batch_size": 1
}

C.获取结果

GET https://api.openai-hk.com/suno/feed/4f72cbf2-44ec-4afa-8e54-9ac1d8fad362,9d6b3790-e460-4d86-9dac-0f365de79a13,7bace6af-0424-481d-b11b-285d976a68bc,5edf410a-98bd-4d65-8b5d-85dc823c92d2,90fdb909-6e4c-4b84-950d-de0871ba5f8e,958cf624-4021-4c48-a455-7ef2471cbfb5,9b4e6452-d39b-4071-b25f-b3003058bd5f,d9f39a13-ba39-41d6-abaf-c7035535021d,09a6ad16-c5f7-4a24-9873-0d21d03324d3,6c1138ea-68f5-43fc-a34b-65f0bd7ca3a3,a7004238-4570-4480-8542-698131dcfd9a,9975eda4-551d-48c7-b840-490c59ac7fa1,88860fc9-b09e-44fc-acb8-9373885c0b6b,fa327c28-0468-4a6b-862b-c68e6929f002,300295af-b31a-41de-a21c-c8ed4af45d63,0c9de950-1fc2-44b5-ac1a-71605273ccfd,96c6b96e-a596-4c1c-bda5-bcdbc243030b,d2029f8e-e43a-4bbc-910f-7ca97903caa0,643cc7ee-5f14-47d3-889e-a27a6a764542,f5570d79-2a88-436e-8341-620b7594a47d,37a8686a-5269-46a5-ac9b-5c48486639f3,f6dda4cb-ba98-4498-9735-3fba4a4c1db0,20f6db47-429f-421a-a16c-1a9aeb3d5a98,d93cd7df-cf79-4eaa-8ab9-cbe6215c8b1d

拼凑 24 个 clip_id 一次获取

15.高阶参数

2025 年 6 月份 suno 新增了 3 个高阶参数
参数为 weirdness_constraint style_weight audio_weight
其中 audio_weight 仅在 cover Add Insterumental Add Vocals 的时候出现
取值都是 0-1 之间
2025 年 9 月份新增 vocal_gender 女声 f、男声 m

A.普通生成

post https://api.openai-hk.com/suno/generate

json

{
  "prompt": "[Verse]\nI got a plate of dreams piled high\nA world of flavors I wanna try\nSpices dancing under the sky\nTaste buds soaring I won’t deny\n\n[Chorus]\nCrunch and sizzle sweet and sour\nEvery bite holds a little power\nBite by bite I’m feeling bold\nLife’s a buffet can’t be controlled\n\n[Verse 2]\nFrom tacos wrapped so tight with love\nTo noodles swimming skies above\nPizza slices like a dove\nFlying straight to my tastebud glove\n\n[Bridge]\nOh the crunch of chips so loud\nPopcorn popping in a cloud\nChocolate melting makes me proud\nIn this feast I’m unbowed\n\n[Chorus]\nCrunch and sizzle sweet and sour\nEvery bite holds a little power\nBite by bite I’m feeling bold\nLife’s a buffet can’t be controlled\n\n[Verse 3]\nSaucy rivers on a plate\nFlavors whispering don’t be late\nEvery meal’s a twist of fate\nI’ll devour till it’s too great",
  "generation_type": "TEXT",
  "tags": "house, tight drums",
  "negative_tags": "现代",
  "mv": "chirp-auk",
  "title": "Savor the Flavor",
  "metadata": {
    "create_mode": "custom",
    "control_sliders": {
      "style_weight": 0.4,
      "weirdness_constraint": 0.7
    },
    "can_control_sliders": ["weirdness_constraint", "style_weight"],
    "vocal_gender": "f"
  }
}

{
  "prompt": "[Verse]\nI got a plate of dreams piled high\nA world of flavors I wanna try\nSpices dancing under the sky\nTaste buds soaring I won’t deny\n\n[Chorus]\nCrunch and sizzle sweet and sour\nEvery bite holds a little power\nBite by bite I’m feeling bold\nLife’s a buffet can’t be controlled\n\n[Verse 2]\nFrom tacos wrapped so tight with love\nTo noodles swimming skies above\nPizza slices like a dove\nFlying straight to my tastebud glove\n\n[Bridge]\nOh the crunch of chips so loud\nPopcorn popping in a cloud\nChocolate melting makes me proud\nIn this feast I’m unbowed\n\n[Chorus]\nCrunch and sizzle sweet and sour\nEvery bite holds a little power\nBite by bite I’m feeling bold\nLife’s a buffet can’t be controlled\n\n[Verse 3]\nSaucy rivers on a plate\nFlavors whispering don’t be late\nEvery meal’s a twist of fate\nI’ll devour till it’s too great",
  "generation_type": "TEXT",
  "tags": "house, tight drums",
  "negative_tags": "现代",
  "mv": "chirp-auk",
  "title": "Savor the Flavor",
  "metadata": {
    "create_mode": "custom",
    "control_sliders": {
      "style_weight": 0.4,
      "weirdness_constraint": 0.7
    },
    "can_control_sliders": ["weirdness_constraint", "style_weight"],
    "vocal_gender": "f"
  }
}

B.cover 生成

cover 的时候会有一个 audio_weight 参数

post https://api.openai-hk.com/suno/generate

json

{
  "prompt": "[Verse]\n新年钟声敲响\n烟花照亮夜晚\n笑声传遍四方\n好运陪伴身旁\n\n[Chorus]\n新年快乐喜气洋洋\n红灯高挂满街辉煌\n团圆美满幸福绽放\n心愿成真福满堂\n\n[Verse 2]\n春风轻轻吹来\n带着吉祥花开\n新衣新鞋新期待\n梦想从此展开\n\n[Chorus]\n新年快乐喜气洋洋\n红灯高挂满街辉煌\n团圆美满幸福绽放\n心愿成真福满堂\n\n[Bridge]\n鞭炮声声响起\n迎接新的契机\n家家户户欢喜\n年味浓郁传递\n\n[Chorus]\n新年快乐喜气洋洋\n红灯高挂满街辉煌\n团圆美满幸福绽放\n心愿成真福满堂",
  "generation_type": "TEXT",
  "tags": "",
  "negative_tags": "",
  "mv": "chirp-auk",
  "title": "新年快乐 (Remix)",
  "task": "cover",
  "cover_clip_id": "f31754fc-2c83-4fc1-8a07-70ae218dd0a6",
  "metadata": {
    "create_mode": "custom",
    "control_sliders": {
      "style_weight": 0.68,
      "audio_weight": 0.48,
      "weirdness_constraint": 0.37
    },
    "can_control_sliders": [
      "weirdness_constraint",
      "style_weight",
      "audio_weight"
    ],
    "is_remix": true
  }
}

{
  "prompt": "[Verse]\n新年钟声敲响\n烟花照亮夜晚\n笑声传遍四方\n好运陪伴身旁\n\n[Chorus]\n新年快乐喜气洋洋\n红灯高挂满街辉煌\n团圆美满幸福绽放\n心愿成真福满堂\n\n[Verse 2]\n春风轻轻吹来\n带着吉祥花开\n新衣新鞋新期待\n梦想从此展开\n\n[Chorus]\n新年快乐喜气洋洋\n红灯高挂满街辉煌\n团圆美满幸福绽放\n心愿成真福满堂\n\n[Bridge]\n鞭炮声声响起\n迎接新的契机\n家家户户欢喜\n年味浓郁传递\n\n[Chorus]\n新年快乐喜气洋洋\n红灯高挂满街辉煌\n团圆美满幸福绽放\n心愿成真福满堂",
  "generation_type": "TEXT",
  "tags": "",
  "negative_tags": "",
  "mv": "chirp-auk",
  "title": "新年快乐 (Remix)",
  "task": "cover",
  "cover_clip_id": "f31754fc-2c83-4fc1-8a07-70ae218dd0a6",
  "metadata": {
    "create_mode": "custom",
    "control_sliders": {
      "style_weight": 0.68,
      "audio_weight": 0.48,
      "weirdness_constraint": 0.37
    },
    "can_control_sliders": [
      "weirdness_constraint",
      "style_weight",
      "audio_weight"
    ],
    "is_remix": true
  }
}

16. Add Insterumental

版本必须高于 v4.5+
2025 年 8 月份 suno 新出 Add Insterumental
上传一首清唱无配音的歌曲, 让 suno 帮你配乐
task 为 underpainting
underpainting_clip_id 为 upload_clip_id
underpainting_end_s 必须小于等于 upload 的 duration
计费一次歌曲费用
不允许跨账号

A.上传清唱歌曲

post https://api.openai-hk.com/suno/uploads/audio-url

shell

curl --request POST \
  --url https://api.openai-hk.com/suno/uploads/audio-url \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Connection: keep-alive' \
  --header 'Content-Type: application/json' \
  --data '{
  "url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}'

curl --request POST \
  --url https://api.openai-hk.com/suno/uploads/audio-url \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Connection: keep-alive' \
  --header 'Content-Type: application/json' \
  --data '{
  "url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}'

得到 clip_id 为 upload_clip_id

json

{
  "clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
  "code": "success",
  "data": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
  "message": ""
}

{
  "clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
  "code": "success",
  "data": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
  "message": ""
}

B.获取歌曲时长等参数

get http://api.openai-hk.com/suno/feed/9b1d2e8d-a365-4bfd-8a18-8989e159b29f

通过获取接口得到 metadata.duration 时长

C.执行 Add Insterumental

post https://api.openai-hk.com/suno/generate

task 为 underpainting
underpainting_clip_id 为 upload_clip_id
underpainting_end_s 必须小于等于 upload 的 duration
最好是不用歌词毕竟是配音
提交体为

json

{
  "mv": "chirp-bluejay",
  "tags": "Pop rap, uplifting, magnetic male vocals, piano, synth, electric guitar, driving bass, clear structure",
  "title": "Hi Insterumental",
  "underpainting_clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
  "underpainting_start_s": 0,
  "underpainting_end_s": 57.9,
  "task": "underpainting",
  "prompt": "",
  "override_fields": ["prompt", "tags"]
}

{
  "mv": "chirp-bluejay",
  "tags": "Pop rap, uplifting, magnetic male vocals, piano, synth, electric guitar, driving bass, clear structure",
  "title": "Hi Insterumental",
  "underpainting_clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
  "underpainting_start_s": 0,
  "underpainting_end_s": 57.9,
  "task": "underpainting",
  "prompt": "",
  "override_fields": ["prompt", "tags"]
}

17. Add Vocals

版本必须高于 v4.5+
2025 年 8 月份 suno 新出 Add Vocals
上传一首纯音乐，让 suno 填词、出人声歌唱
task 为 overpainting
overpainting_clip_id 为 upload_clip_id
overpainting_end_s 必须小于等于 upload 的 duration
计费一次歌曲费用
不允许跨账号

A.上传纯音乐

post https://api.openai-hk.com/suno/uploads/audio-url

shell

curl --request POST \
  --url https://api.openai-hk.com/suno/uploads/audio-url \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Connection: keep-alive' \
  --header 'Content-Type: application/json' \
  --data '{
  "url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}'

curl --request POST \
  --url https://api.openai-hk.com/suno/uploads/audio-url \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Connection: keep-alive' \
  --header 'Content-Type: application/json' \
  --data '{
  "url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}'

得到 clip_id 为 upload_clip_id

json

{
  "clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
  "code": "success",
  "data": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
  "message": ""
}

{
  "clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
  "code": "success",
  "data": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
  "message": ""
}

B.获取歌曲时长等参数

get http://api.openai-hk.com/suno/feed/9b1d2e8d-a365-4bfd-8a18-8989e159b29f

通过获取接口得到 metadata.duration 时长
同时获取 metadata.tags Tags

C.执行 Add Vocals

post https://api.openai-hk.com/suno/generate

task 为 overpainting
overpainting_clip_id 为 upload_clip_id
overpainting_end_s 必须小于等于 upload 的 metadata.duration
tags 为 upload 的 metadata.tags
提交体为

json

{
  "mv": "chirp-crow",
  "tags": "pop rap, uplifting, magnetic male vocals, piano, synth, electric guitar, driving bass, clear structure",
  "title": "Hi vocal",
  "overpainting_clip_id": "c18c0a49-ec30-4848-b7ad-c3f78ec5e481",
  "task": "overpainting",
  "prompt": "[Verse 1]\nYou left your sketchbook on my chair\nCoffee ring on every page\nLittle storms you drew in pen\nSaid they’re “just some passing days”\n\n[Chorus]\nMather\nI still say your name too soft\nLike it might break in my mouth\nMather\nEvery quiet room you’re in it\nEvery clock that stops a minute\nMather\nI keep setting one more place\nFor a ghost I can’t erase\n\n[Verse 2]\nFound your sweater in July\nThreadbare cuffs and summer sweat\nSmelled like soil and engine smoke\nLike the day that we first met\n\n[Chorus]\nMather\nI still say your name too soft\nLike it might break in my mouth\nMather\nEvery quiet room you’re in it\nEvery clock that stops a minute\nMather\nI keep setting one more place\nFor a ghost I can’t erase"
}

{
  "mv": "chirp-crow",
  "tags": "pop rap, uplifting, magnetic male vocals, piano, synth, electric guitar, driving bass, clear structure",
  "title": "Hi vocal",
  "overpainting_clip_id": "c18c0a49-ec30-4848-b7ad-c3f78ec5e481",
  "task": "overpainting",
  "prompt": "[Verse 1]\nYou left your sketchbook on my chair\nCoffee ring on every page\nLittle storms you drew in pen\nSaid they’re “just some passing days”\n\n[Chorus]\nMather\nI still say your name too soft\nLike it might break in my mouth\nMather\nEvery quiet room you’re in it\nEvery clock that stops a minute\nMather\nI keep setting one more place\nFor a ghost I can’t erase\n\n[Verse 2]\nFound your sweater in July\nThreadbare cuffs and summer sweat\nSmelled like soil and engine smoke\nLike the day that we first met\n\n[Chorus]\nMather\nI still say your name too soft\nLike it might break in my mouth\nMather\nEvery quiet room you’re in it\nEvery clock that stops a minute\nMather\nI keep setting one more place\nFor a ghost I can’t erase"
}

18. 获取 midi

A.全轨分离的 clip_id

通过 14.all-stems:全轨声曲分离获取其中的一首歌的 clip_id 值为 a624123d-22cc-4d4d-bf28-78d312f61597
注意普通音乐的 clip_id 也能执行，但是官网只有全轨分离的 clip_id 才有
扣费：100 积分
不可跨账号，账号下线后不可调用

B.获取 midi

get https://api.openai-hk.com/suno/act/midi/c5bffd3a-96ad-4e83-9fbe-4720a5b9a664

没成功都是

json

{ "state": "running" }

{ "state": "running" }

成功后

json

{
    "state": "complete",
    "instruments": [
        {
            "name": "String Ensembles 1",
            "notes": [
             {
                    "pitch": 60,
                    "start": 1.1041666666666667,
                    "end": 1.9583333333333333,
                    "velocity": 0.7165354330708661
                },
               ......
            ]

        },
        ......
    ]
}

{
    "state": "complete",
    "instruments": [
        {
            "name": "String Ensembles 1",
            "notes": [
             {
                    "pitch": 60,
                    "start": 1.1041666666666667,
                    "end": 1.9583333333333333,
                    "velocity": 0.7165354330708661
                },
               ......
            ]

        },
        ......
    ]
}

19.拓展 style tags

tags 就是 style
不知道如何写 style 可以使用这个接口
扣费：100 积分

post https://api.openai-hk.com/suno/act/tags

shell

curl --request POST \
  --url https://api.openai-hk.com/suno/act/tags \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Connection: keep-alive' \
  --header 'Content-Type: application/json' \
  --header 'myuid: 123' \
  --data '{"original_tags":"student"}'

curl --request POST \
  --url https://api.openai-hk.com/suno/act/tags \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Connection: keep-alive' \
  --header 'Content-Type: application/json' \
  --header 'myuid: 123' \
  --data '{"original_tags":"student"}'

original_tags 传入相关提示词
返回体

json

{
  "upsampled_tags": "Laid-back indie pop driven by a clean guitar riff, tight bass, and crisp drums. Verses feature subtle synth textures and gentle background vocals. A catchy chorus lifts with layered harmonies and handclaps. Bridge introduces a bright Rhodes piano before a dynamic final chorus.",
  "request_id": "507acd16-8b84-4e55-be2b-4329d82efb26"
}

{
  "upsampled_tags": "Laid-back indie pop driven by a clean guitar riff, tight bass, and crisp drums. Verses feature subtle synth textures and gentle background vocals. A catchy chorus lifts with layered harmonies and handclaps. Bridge introduces a bright Rhodes piano before a dynamic final chorus.",
  "request_id": "507acd16-8b84-4e55-be2b-4329d82efb26"
}

20. Remaster

post https://api.openai-hk.com/suno/generate

model_name 为chirp-flounder为 v5.5 chirp-carp 为 v5、chirp-bass为 v4.5+
版本 model_name
v5.5 chirp-flounder
v5 chirp-carp
v4.5+ chirp-bass
clip_id 为重新生成的 id
variation_category 仅在 v5 以上版本支持，而且只有 3 个值 high normal subtle
不可跨账号
计费:一次生成费用
提交体为

版本	model_name
v5.5	chirp-flounder
v5	chirp-carp
v4.5+	chirp-bass

json

{
  "clip_id": "e8bd1ba8-63cd-45f9-b340-7d00f5cfd25b",
  "model_name": "chirp-carp",
  "variation_category": "high"
}

{
  "clip_id": "e8bd1ba8-63cd-45f9-b340-7d00f5cfd25b",
  "model_name": "chirp-carp",
  "variation_category": "high"
}

21.Persona-v2-vox 版:歌手风格

A.生成音乐

可以通过场景 1 2 3 生成音乐获取其中的一首歌的 clip_id 值为 7b5a87af-d567-4444-97c2-387ba5c816d5

B.获取 vox

post https://api.openai-hk.com/suno/act/vox/{clip_id}

不能跨账号所以可能账号下线用不了
为防止滥用会扣 100 积分
vocal_end_s-vocal_start_s 小于 30
post https://api.openai-hk.com/suno/act/vox/7b5a87af-d567-4444-97c2-387ba5c816d5

json

{
  "vocal_start_s": 45,
  "vocal_end_s": 74
}

{
  "vocal_start_s": 45,
  "vocal_end_s": 74
}

返回得到 id 为 vox_audio_id =e044ac0d-7eb1-4014-b134-3ff7656886be

json

{
	"id": "e044ac0d-7eb1-4014-b134-3ff7656886be",
	"source_clip_id": "7b5a87af-d567-4444-97c2-387ba5c816d5",
	"status": "complete",
	"vocal_audio_url": "https://cdn1.suno.ai/processed_e044ac0d-7eb1-4014-b134-3ff7656886be_vocals.m4a",
	"vocal_end_s": 74,
	"vocal_start_s": 45,
	"wave_response": {
		"waveform_aggregates": [
			{
				"data": [
					[
						-54,
						60,
						-146,
            ...
          ]
        ]
      }
    ]
  }
}

{
	"id": "e044ac0d-7eb1-4014-b134-3ff7656886be",
	"source_clip_id": "7b5a87af-d567-4444-97c2-387ba5c816d5",
	"status": "complete",
	"vocal_audio_url": "https://cdn1.suno.ai/processed_e044ac0d-7eb1-4014-b134-3ff7656886be_vocals.m4a",
	"vocal_end_s": 74,
	"vocal_start_s": 45,
	"wave_response": {
		"waveform_aggregates": [
			{
				"data": [
					[
						-54,
						60,
						-146,
            ...
          ]
        ]
      }
    ]
  }
}

C.新建 Persona

post https://api.openai-hk.com/sunoapi/persona/create/

root_clip_id 需要系统内存在的,非 uploader 从步骤 A 得到的clip_id
不能跨账号所以可能账号下线用不了
为防止滥用会扣 100 积分
vocal_end_s-vocal_start_s 小于 30
persona_type 必须为 vox

请求体

json

{
  "root_clip_id": "7b5a87af-d567-4444-97c2-387ba5c816d5",
  "name": "food",
  "description": "123",
  "is_public": true,
  "persona_type": "vox",
  "vox_audio_id": "e044ac0d-7eb1-4014-b134-3ff7656886be",
  "vocal_start_s": 66.3,
  "vocal_end_s": 95.3,
  "user_input_styles": "Style: Verse—Chinese Folk narrative + Chorus—explosive rock + Hook—catchy, repetitive loop. A breezy guitar riff kicks in with building drum intensity, blended with \"keyboard typing sounds + faint vocal samples,\" followed by electronic effects layering after 15 seconds. The intro cuts abruptly into the verse with a sharp, punchy \"Lao Xu!\" to instantly grab attention."
}

{
  "root_clip_id": "7b5a87af-d567-4444-97c2-387ba5c816d5",
  "name": "food",
  "description": "123",
  "is_public": true,
  "persona_type": "vox",
  "vox_audio_id": "e044ac0d-7eb1-4014-b134-3ff7656886be",
  "vocal_start_s": 66.3,
  "vocal_end_s": 95.3,
  "user_input_styles": "Style: Verse—Chinese Folk narrative + Chorus—explosive rock + Hook—catchy, repetitive loop. A breezy guitar riff kicks in with building drum intensity, blended with \"keyboard typing sounds + faint vocal samples,\" followed by electronic effects layering after 15 seconds. The intro cuts abruptly into the verse with a sharp, punchy \"Lao Xu!\" to instantly grab attention."
}

返回体关键的得到 id 为 fd213afd-ac1c-4822-9802-c1c0ea45e77b 设定为 persona_id 供下一步使用

json

{
  "id": "fd213afd-ac1c-4822-9802-c1c0ea45e77b",
  "name": "food",
  "description": "123",
  "root_clip_id": "54834687-5e79-4f08-8e14-cf188f15b598",
  "clip": {
    "id": "54834687-5e79-4f08-8e14-cf188f15b598"
  }
}

{
  "id": "fd213afd-ac1c-4822-9802-c1c0ea45e77b",
  "name": "food",
  "description": "123",
  "root_clip_id": "54834687-5e79-4f08-8e14-cf188f15b598",
  "clip": {
    "id": "54834687-5e79-4f08-8e14-cf188f15b598"
  }
}

D.使用 persona_id 创作

post https://api.openai-hk.com/suno/generate

task 为 vox 原来是 artist_consistency,
注意 mv 仅支持 chirp-crow （v5 以上）
persona_id 为 C 步骤得到的
artist_clip_id 就是 A 步骤中的 clip_id
可跨账号
mv 如要使用 chirp-v4-tau 或者 chirp-auk 或 chirp-bluejay 则 task 必须为 artist_consistency

json

{
  "prompt": "[Verse]\n喧嚣终于肯退场，\n月光悄悄爬满窗。\n疲惫的灵魂请卸下伪装，\n躲进柔软的梦乡。\n[Chorus] (建议使用温柔气声，极致轻柔)\n晚安，枕边的星光，\n带你去银河流浪。\n忘掉白昼的慌张，\n睡吧，夜还很长",
  "generation_type": "TEXT",
  "tags": "Ethereal Lullaby, Acoustic Piano, Ambient, Healing, Slow Tempo",
  "negative_tags": "",
  "mv": "chirp-crow",
  "title": "老公",
  "task": "vox",
  "persona_id": "88cca736-7263-4794-8480-360c0123b6fc",
  "artist_clip_id": "6c983654-7ee9-4e1f-b195-47259a5bed48"
}

{
  "prompt": "[Verse]\n喧嚣终于肯退场，\n月光悄悄爬满窗。\n疲惫的灵魂请卸下伪装，\n躲进柔软的梦乡。\n[Chorus] (建议使用温柔气声，极致轻柔)\n晚安，枕边的星光，\n带你去银河流浪。\n忘掉白昼的慌张，\n睡吧，夜还很长",
  "generation_type": "TEXT",
  "tags": "Ethereal Lullaby, Acoustic Piano, Ambient, Healing, Slow Tempo",
  "negative_tags": "",
  "mv": "chirp-crow",
  "title": "老公",
  "task": "vox",
  "persona_id": "88cca736-7263-4794-8480-360c0123b6fc",
  "artist_clip_id": "6c983654-7ee9-4e1f-b195-47259a5bed48"
}

22.Mashup:混曲

A.生成音乐

可以通过场景 1 2 3 生成音乐获取其中的一首歌的 clip_id_1 值为 9f102969-0024-479e-b38f-c0c5db21383dclip_id_2 值为 6aebb715-701c-433f-b976-a7ff5cf16255

B.生成 Mashup

task 为 mashup_condition
mashup_clip_ids 为 A 步骤得到的 ['clip_id_1','clip_id_2']
prompt 歌词，如果你想要 2 首歌的歌词混曲可以参考 23. Lyrics Mashup: 歌词混曲
计费:一次生成歌曲基础费用

post https://api.openai-hk.com/suno/generate

json

{
  "task": "mashup_condition",
  "generation_type": "TEXT",
  "title": "Banban83 vs bluespawn x 广州的孤儿 (Mashup)",
  "tags": "",
  "negative_tags": "",
  "mv": "chirp-crow",
  "prompt": "你在站里频频回头\n我在站外舍不得走\n有一种不祥的感受\n今天的离别像分手\n \n你消失在人群之中\n就像被风吹散的梦\n广州南站人潮汹涌\n有谁在乎我的心痛\n \n我像个广州的孤儿\n我像个多余的孤儿\n我像个无助的孤儿\n如今又是独自一人\n \n一路平安我爱的人\n一路珍重我爱的人\n一路平安离去的人\n一路珍重远去的人\n \n坐在二号线地铁里\n忽然感觉有些委屈\n永泰站外飘着细雨\n有谁在乎我的哭泣\n \n在注定失眠的夜里\n不知如何安慰自己\n举杯敬自己和过去\n今天终将成为回忆\n \n我像个广州的孤儿\n我像个被弃的孤儿\n我像个漂泊的孤儿\n如今仍是独自一人\n \n一生平安我爱的人\n一生珍重我爱的人\n一生平安离去的人\n一生珍重远去的人\n \n啦啦啦啦啦啦啦啦\n啦啦啦啦啦啦啦啦\n啦啦啦啦啦啦啦啦\n我像个广州的孤儿\n \n啦啦啦啦啦啦啦啦\n啦啦啦啦啦啦啦啦\n啦啦啦啦啦啦啦啦\n我像个广州的孤儿",

  "mashup_clip_ids": [
    "9f102969-0024-479e-b38f-c0c5db21383d",
    "6aebb715-701c-433f-b976-a7ff5cf16255"
  ]
}

{
  "task": "mashup_condition",
  "generation_type": "TEXT",
  "title": "Banban83 vs bluespawn x 广州的孤儿 (Mashup)",
  "tags": "",
  "negative_tags": "",
  "mv": "chirp-crow",
  "prompt": "你在站里频频回头\n我在站外舍不得走\n有一种不祥的感受\n今天的离别像分手\n \n你消失在人群之中\n就像被风吹散的梦\n广州南站人潮汹涌\n有谁在乎我的心痛\n \n我像个广州的孤儿\n我像个多余的孤儿\n我像个无助的孤儿\n如今又是独自一人\n \n一路平安我爱的人\n一路珍重我爱的人\n一路平安离去的人\n一路珍重远去的人\n \n坐在二号线地铁里\n忽然感觉有些委屈\n永泰站外飘着细雨\n有谁在乎我的哭泣\n \n在注定失眠的夜里\n不知如何安慰自己\n举杯敬自己和过去\n今天终将成为回忆\n \n我像个广州的孤儿\n我像个被弃的孤儿\n我像个漂泊的孤儿\n如今仍是独自一人\n \n一生平安我爱的人\n一生珍重我爱的人\n一生平安离去的人\n一生珍重远去的人\n \n啦啦啦啦啦啦啦啦\n啦啦啦啦啦啦啦啦\n啦啦啦啦啦啦啦啦\n我像个广州的孤儿\n \n啦啦啦啦啦啦啦啦\n啦啦啦啦啦啦啦啦\n啦啦啦啦啦啦啦啦\n我像个广州的孤儿",

  "mashup_clip_ids": [
    "9f102969-0024-479e-b38f-c0c5db21383d",
    "6aebb715-701c-433f-b976-a7ff5cf16255"
  ]
}

23. Lyrics Mashup: 歌词混曲

lyrics_a 为歌词 1
lyrics_b 为歌词 2
计费:100 积分/次
post https://api.openai-hk.com/suno/act/lyrics-mashup

json

{
  "lyrics_a": "Sambuy come back bluespawn greenspawn are making you a spawn",
  "lyrics_b": "你在站里频频回头\n我在站外舍不得走\n有一种不祥的感受\n今天的离别像分手\n \n你消失在人群之中\n就像被风吹散的梦\n广州南站人潮汹涌\n有谁在乎我的心痛\n \n我像个广州的孤儿\n我像个多余的孤儿\n我像个无助的孤儿\n如今又是独自一人\n \n一路平安我爱的人\n一路珍重我爱的人\n一路平安离去的人\n一路珍重远去的人\n \n坐在二号线地铁里\n忽然感觉有些委屈\n永泰站外飘着细雨\n有谁在乎我的哭泣\n \n在注定失眠的夜里\n不知如何安慰自己\n举杯敬自己和过去\n今天终将成为回忆\n \n我像个广州的孤儿\n我像个被弃的孤儿\n我像个漂泊的孤儿\n如今仍是独自一人\n \n一生平安我爱的人\n一生珍重我爱的人\n一生平安离去的人\n一生珍重远去的人\n \n啦啦啦啦啦啦啦啦\n啦啦啦啦啦啦啦啦\n啦啦啦啦啦啦啦啦\n我像个广州的孤儿\n \n啦啦啦啦啦啦啦啦\n啦啦啦啦啦啦啦啦\n啦啦啦啦啦啦啦啦\n我像个广州的孤儿"
}

{
  "lyrics_a": "Sambuy come back bluespawn greenspawn are making you a spawn",
  "lyrics_b": "你在站里频频回头\n我在站外舍不得走\n有一种不祥的感受\n今天的离别像分手\n \n你消失在人群之中\n就像被风吹散的梦\n广州南站人潮汹涌\n有谁在乎我的心痛\n \n我像个广州的孤儿\n我像个多余的孤儿\n我像个无助的孤儿\n如今又是独自一人\n \n一路平安我爱的人\n一路珍重我爱的人\n一路平安离去的人\n一路珍重远去的人\n \n坐在二号线地铁里\n忽然感觉有些委屈\n永泰站外飘着细雨\n有谁在乎我的哭泣\n \n在注定失眠的夜里\n不知如何安慰自己\n举杯敬自己和过去\n今天终将成为回忆\n \n我像个广州的孤儿\n我像个被弃的孤儿\n我像个漂泊的孤儿\n如今仍是独自一人\n \n一生平安我爱的人\n一生珍重我爱的人\n一生平安离去的人\n一生珍重远去的人\n \n啦啦啦啦啦啦啦啦\n啦啦啦啦啦啦啦啦\n啦啦啦啦啦啦啦啦\n我像个广州的孤儿\n \n啦啦啦啦啦啦啦啦\n啦啦啦啦啦啦啦啦\n啦啦啦啦啦啦啦啦\n我像个广州的孤儿"
}

得到结果

json

{
  "lyrics_request_id": "04edfa84-290e-4a08-bd35-73906079b26e",
  "mashup_id": "1c250665-a7c9-4852-97d1-3d291ebb9565",
  "response": {
    "error_message": "",
    "status": "complete",
    "tags": [],
    "text": "你在站里频频回头  \n我在站外舍不得走  \n有一种不祥的感受  \n今天的离别像分手  \n\nSambuy come back  \nbluespawn greenspawn are making you a spawn  \nSambuy come back  \nbluespawn greenspawn are making you a spawn  \n\n你消失在人群之中  \n就像被风吹散的梦  \n广州南站人潮汹涌  \n有谁在乎我的心痛  \n\nSambuy come back  \nbluespawn greenspawn  \nare making you a spawn  \n\n我像个广州的孤儿  \n我像个多余的孤儿  \n我像个无助的孤儿  \n如今又是独自一人  \n\n一路平安我爱的人  \n一路珍重我爱的人  \n一路平安离去的人  \n一路珍重远去的人  \n\nSambuy come back  \nbluespawn greenspawn are making you a spawn  \nSambuy don’t go  \nbluespawn greenspawn are making you a spawn  \n\n坐在二号线地铁里  \n忽然感觉有些委屈  \n永泰站外飘着细雨  \n有谁在乎我的哭泣  \n\n在注定失眠的夜里  \n不知如何安慰自己  \n举杯敬自己和过去  \n今天终将成为回忆  \n\n我像个广州的孤儿  \n我像个被弃的孤儿  \n我像个漂泊的孤儿  \n如今仍是独自一人  \n\nSambuy come back  \n我像个广州的孤儿  \nbluespawn greenspawn are making you a spawn  \n如今仍是独自一人  \n\n啦啦啦啦啦啦啦啦  \nSambuy come back  \n啦啦啦啦啦啦啦啦  \n广州的孤儿在呼喊  \n\n啦啦啦啦啦啦啦啦  \nSambuy come back  \nbluespawn greenspawn are making you a spawn  \n我像个广州的孤儿",
    "title": "Lyrics Mashup"
  }
}

{
  "lyrics_request_id": "04edfa84-290e-4a08-bd35-73906079b26e",
  "mashup_id": "1c250665-a7c9-4852-97d1-3d291ebb9565",
  "response": {
    "error_message": "",
    "status": "complete",
    "tags": [],
    "text": "你在站里频频回头  \n我在站外舍不得走  \n有一种不祥的感受  \n今天的离别像分手  \n\nSambuy come back  \nbluespawn greenspawn are making you a spawn  \nSambuy come back  \nbluespawn greenspawn are making you a spawn  \n\n你消失在人群之中  \n就像被风吹散的梦  \n广州南站人潮汹涌  \n有谁在乎我的心痛  \n\nSambuy come back  \nbluespawn greenspawn  \nare making you a spawn  \n\n我像个广州的孤儿  \n我像个多余的孤儿  \n我像个无助的孤儿  \n如今又是独自一人  \n\n一路平安我爱的人  \n一路珍重我爱的人  \n一路平安离去的人  \n一路珍重远去的人  \n\nSambuy come back  \nbluespawn greenspawn are making you a spawn  \nSambuy don’t go  \nbluespawn greenspawn are making you a spawn  \n\n坐在二号线地铁里  \n忽然感觉有些委屈  \n永泰站外飘着细雨  \n有谁在乎我的哭泣  \n\n在注定失眠的夜里  \n不知如何安慰自己  \n举杯敬自己和过去  \n今天终将成为回忆  \n\n我像个广州的孤儿  \n我像个被弃的孤儿  \n我像个漂泊的孤儿  \n如今仍是独自一人  \n\nSambuy come back  \n我像个广州的孤儿  \nbluespawn greenspawn are making you a spawn  \n如今仍是独自一人  \n\n啦啦啦啦啦啦啦啦  \nSambuy come back  \n啦啦啦啦啦啦啦啦  \n广州的孤儿在呼喊  \n\n啦啦啦啦啦啦啦啦  \nSambuy come back  \nbluespawn greenspawn are making you a spawn  \n我像个广州的孤儿",
    "title": "Lyrics Mashup"
  }
}

24. Samples: 取样生成歌曲

A.生成音乐

可以通过场景 1 2 3 生成音乐获取其中的一首歌的 clip_id 值为 0fa07665-6b8e-4a8b-8bd3-7e0cfcdada88
或者通过上传得到 clip_id

B.生成 Samples

task 为 chop_sample_condition
chop_sample_clip_id 为 A 步骤得到的clip_id
chop_sample_start_s 取样开始时间
chop_sample_end_s 取样结束时间
计费:一次生成歌曲基础费用
允许跨账号

post https://api.openai-hk.com/suno/generate

json

{
  "task": "chop_sample_condition",
  "generation_type": "TEXT",
  "title": "Breaking My Own News",
  "tags": "",
  "negative_tags": "",
  "mv": "chirp-crow",
  "prompt": "[Verse 1]\nPhone lit up\nHeadline in my hand\nFeels made up\nStill says “you won’t understand”\nYour name\nMy name\nSide by side in the scroll\nCold black text\nOn a story I used to hold\n\n[Chorus]\nYou’re breaking news\nAnd I’m just breaking\nFront-page truth\nHeart still shaking\nEverybody reads\nWhat we already knew\nYou’re a story now\nAnd I’m the one you broke it to\n\n[Verse 2]\nNeighbors talk\nThrough a half-closed door\nCoffee cools\nOn a cracked old floor\nYour suitcase snaps\nLike a camera flash\nOne last quote\nThen you cut to black\n\n[Chorus]\nYou’re breaking news\nAnd I’m just breaking\nFront-page truth\nHeart still shaking\nEverybody reads\nWhat we already knew\nYou’re a story now\nAnd I’m the one you broke it to\n\n[Bridge]\nIs there a line\nWhere we rewind\nOr just a feed\nThat leaves us behind\nTell me\nWho gets\nThe final view\nWhen I stop trending\nWith you\n\n[Chorus]\nYou’re breaking news\nAnd I’m just breaking\nFront-page truth\nHeart still shaking\nEverybody reads\nWhat we already knew\nYou’re a story now\nAnd I’m the one you broke it to (yeah)",
  "chop_sample_clip_id": "0fa07665-6b8e-4a8b-8bd3-7e0cfcdada88",
  "chop_sample_start_s": 59.88,
  "chop_sample_end_s": 102.16
}

{
  "task": "chop_sample_condition",
  "generation_type": "TEXT",
  "title": "Breaking My Own News",
  "tags": "",
  "negative_tags": "",
  "mv": "chirp-crow",
  "prompt": "[Verse 1]\nPhone lit up\nHeadline in my hand\nFeels made up\nStill says “you won’t understand”\nYour name\nMy name\nSide by side in the scroll\nCold black text\nOn a story I used to hold\n\n[Chorus]\nYou’re breaking news\nAnd I’m just breaking\nFront-page truth\nHeart still shaking\nEverybody reads\nWhat we already knew\nYou’re a story now\nAnd I’m the one you broke it to\n\n[Verse 2]\nNeighbors talk\nThrough a half-closed door\nCoffee cools\nOn a cracked old floor\nYour suitcase snaps\nLike a camera flash\nOne last quote\nThen you cut to black\n\n[Chorus]\nYou’re breaking news\nAnd I’m just breaking\nFront-page truth\nHeart still shaking\nEverybody reads\nWhat we already knew\nYou’re a story now\nAnd I’m the one you broke it to\n\n[Bridge]\nIs there a line\nWhere we rewind\nOr just a feed\nThat leaves us behind\nTell me\nWho gets\nThe final view\nWhen I stop trending\nWith you\n\n[Chorus]\nYou’re breaking news\nAnd I’m just breaking\nFront-page truth\nHeart still shaking\nEverybody reads\nWhat we already knew\nYou’re a story now\nAnd I’m the one you broke it to (yeah)",
  "chop_sample_clip_id": "0fa07665-6b8e-4a8b-8bd3-7e0cfcdada88",
  "chop_sample_start_s": 59.88,
  "chop_sample_end_s": 102.16
}

25. Sound: 声音任务

task 类型为 sound
mv 目前仅支持 chirp-crow
参数都放在 tags 中, 比如循环 loop ,比如 BMP 60 则为 tempo: 60 , 比如 G# 则为 key: G#
计费:一次生成歌曲基础费用

post https://api.openai-hk.com/suno/generate

json

{
  "task": "sound",
  "generation_type": "TEXT",
  "title": "Ready To Drop Into Anything.",
  "tags": "loop, key: G#, tempo: 60, effects, loops, and one-shots. Ready to drop into anything.",
  "negative_tags": "",
  "mv": "chirp-crow",
  "prompt": "",
  "make_instrumental": true,
  "metadata": {
    "create_mode": "custom"
  }
}

{
  "task": "sound",
  "generation_type": "TEXT",
  "title": "Ready To Drop Into Anything.",
  "tags": "loop, key: G#, tempo: 60, effects, loops, and one-shots. Ready to drop into anything.",
  "negative_tags": "",
  "mv": "chirp-crow",
  "prompt": "",
  "make_instrumental": true,
  "metadata": {
    "create_mode": "custom"
  }
}

26. inspo: 灵感创作

task 类型为 playlist_condition
playlist_id 为 inspiration
playlist_clip_ids 为参考歌曲的 clip_id 最多可以选择 4 首歌
不可跨账号， playlist_clip_ids中的 clip_id 必须来自同一个账号
计费:一次生成歌曲基础费用

post https://api.openai-hk.com/suno/generate

json

{
  "task": "playlist_condition",
  "generation_type": "TEXT",
  "title": "Dad, Are You Listening?",
  "tags": "deepstep, harmonizing vocals, improvisation",
  "negative_tags": "",
  "mv": "chirp-crow",
  "prompt": "[Verse 1]\nYou missed my birthday\nSaid you got the days all wrong\nI laughed and said it's okay\nBut it stung all day long\nYou call me \"kiddo\"\nLike I'm still eight years old\nI'm standing in the doorway\nYou’re already grabbing your coat\n\n[Chorus]\nDad\nAre you listening?\nOr just hearing me talk?\nI’m standing right beside you\nStill feel across the block\nI’d trade every story\nYou tell about what you did\nFor five quiet minutes\nWhere you ask me how I am\n\n[Verse 2]\nYou fix the hallway light\nAsk if my car’s been tuned\nYou never touch the photos\nStacked in the spare room\nYou say you’re proud of me\nLike it’s something to get through\nI keep saving all my questions\nFor a softer version of you\n\n[Chorus]\nDad\nAre you listening?\nOr just hearing me talk?\nI’m standing right beside you\nStill feel across the block\nI’d trade every story\nYou tell about what you did\nFor five quiet minutes\nWhere you ask me how I am\n\n[Bridge]\nWhat was it like to be your age?\nWho broke your heart\nWho slammed your door?\nDid you ever feel this small\nIn your own kitchen floor? (yeah)\n\n[Chorus]\nDad\nAre you listening?\nI’m not asking you to change\nJust sit here at this table\nSay my name like it’s my name\nI’d trade every silence\nEvery shrug and every laugh\nFor one honest moment\nWhere you let me love you back",
  "make_instrumental": false,
  "metadata": {
    "create_mode": "custom"
  },
  "playlist_id": "inspiration",
  "playlist_clip_ids": [
    "150ff04a-496e-4425-9ad7-d878354129de",
    "b09ed072-04c2-485f-a925-9f0cc9db4e26"
  ]
}

{
  "task": "playlist_condition",
  "generation_type": "TEXT",
  "title": "Dad, Are You Listening?",
  "tags": "deepstep, harmonizing vocals, improvisation",
  "negative_tags": "",
  "mv": "chirp-crow",
  "prompt": "[Verse 1]\nYou missed my birthday\nSaid you got the days all wrong\nI laughed and said it's okay\nBut it stung all day long\nYou call me \"kiddo\"\nLike I'm still eight years old\nI'm standing in the doorway\nYou’re already grabbing your coat\n\n[Chorus]\nDad\nAre you listening?\nOr just hearing me talk?\nI’m standing right beside you\nStill feel across the block\nI’d trade every story\nYou tell about what you did\nFor five quiet minutes\nWhere you ask me how I am\n\n[Verse 2]\nYou fix the hallway light\nAsk if my car’s been tuned\nYou never touch the photos\nStacked in the spare room\nYou say you’re proud of me\nLike it’s something to get through\nI keep saving all my questions\nFor a softer version of you\n\n[Chorus]\nDad\nAre you listening?\nOr just hearing me talk?\nI’m standing right beside you\nStill feel across the block\nI’d trade every story\nYou tell about what you did\nFor five quiet minutes\nWhere you ask me how I am\n\n[Bridge]\nWhat was it like to be your age?\nWho broke your heart\nWho slammed your door?\nDid you ever feel this small\nIn your own kitchen floor? (yeah)\n\n[Chorus]\nDad\nAre you listening?\nI’m not asking you to change\nJust sit here at this table\nSay my name like it’s my name\nI’d trade every silence\nEvery shrug and every laugh\nFor one honest moment\nWhere you let me love you back",
  "make_instrumental": false,
  "metadata": {
    "create_mode": "custom"
  },
  "playlist_id": "inspiration",
  "playlist_clip_ids": [
    "150ff04a-496e-4425-9ad7-d878354129de",
    "b09ed072-04c2-485f-a925-9f0cc9db4e26"
  ]
}

27. voice: 声音克隆

声音克隆本质是建立个人的声音库(persona)，克隆后的声音可以用于生成歌曲
persona 必须有一首歌曲
读一段文字，入库自己声音进来

A. 上传歌曲

post https://api.openai-hk.com/suno/persona/voice/vox

json

{
  "url": "http://cos.aitutu.cc/mp4/c4818ce3-37d6-4b45-8e01-58b750e5fe57.mp3",
  "vocal_end_s": 23.24,
  "vocal_start_s": 0
}

{
  "url": "http://cos.aitutu.cc/mp4/c4818ce3-37d6-4b45-8e01-58b750e5fe57.mp3",
  "vocal_end_s": 23.24,
  "vocal_start_s": 0
}

json

{
  "id": "9e196fa1-20f3-43c1-8066-06a2a6b6bea9",
  "status": "submitted",
  "voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768"
}

{
  "id": "9e196fa1-20f3-43c1-8066-06a2a6b6bea9",
  "status": "submitted",
  "voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768"
}

返回的 id 为 vox_audio_id 供下一步使用
计费 100 积分/次

B. 获取样本句子

post https://api.openai-hk.com/suno/act/phrase

language 语言有 zh en es fr pt de ja ko hi ru
voice_recording_id A 步骤的返回
不允许跨账号
计费 100 积分/次

shell

curl --request POST \
  --url https://api.openai-hk.com/suno/act/phrase \
  --header 'Authorization: Bearer sk-youkey' \
  --header 'Content-Type: application/json' \
  --data '{
	 "language":"zh","voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768"
}
'

curl --request POST \
  --url https://api.openai-hk.com/suno/act/phrase \
  --header 'Authorization: Bearer sk-youkey' \
  --header 'Content-Type: application/json' \
  --data '{
	 "language":"zh","voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768"
}
'

body

json

{
  "language": "zh",
  "voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768"
}

{
  "language": "zh",
  "voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768"
}

返回 phrase_id 句子 id 供下一步使用只能用一次

json

{
  "phrase_id": "45d639aa-ad8a-41cd-a356-f81207491d3a",
  "phrase_text": "轻快的歌声在空气中自由飘扬"
}

{
  "phrase_id": "45d639aa-ad8a-41cd-a356-f81207491d3a",
  "phrase_text": "轻快的歌声在空气中自由飘扬"
}

C. 声音验证

post https://api.openai-hk.com/suno/persona/voice/verify

url 用户的录音，请用户录音文本为 phrase_text 并上传保存为 url ，支持格式 mp3 wav
voice_recording_id A 步骤的返回
phrase_id B 步骤的返回
不允许跨账号
注意: 这个请求只能用一次，一次性不过得重新获取 phrase
计费 100 积分/次

json

{
  "url": "https://cdn1.suno.ai/28fc2b84-07d3-45d7-85f3-3db6684801aa.mp3",
  "phrase_id": "45d639aa-ad8a-41cd-a356-f81207491d3a",
  "voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768"
}

{
  "url": "https://cdn1.suno.ai/28fc2b84-07d3-45d7-85f3-3db6684801aa.mp3",
  "phrase_id": "45d639aa-ad8a-41cd-a356-f81207491d3a",
  "voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768"
}

返回 id 为 verification_id

json

{
  "id": "979282b1-8968-46bc-b599-ea14946be48e",
  "status": "approved",
  "voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768",
  "verification_recording_id": "286df4b3-c10d-42ab-b757-f6381ae34853",
  "verification_prompt_text": "轻快的歌声在空气中自由飘扬",
  "rejection_reason": "",
  "created_at": "2026-03-29T12:51:51.030983Z",
  "updated_at": "2026-03-29T12:51:52.016067Z"
}

{
  "id": "979282b1-8968-46bc-b599-ea14946be48e",
  "status": "approved",
  "voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768",
  "verification_recording_id": "286df4b3-c10d-42ab-b757-f6381ae34853",
  "verification_prompt_text": "轻快的歌声在空气中自由飘扬",
  "rejection_reason": "",
  "created_at": "2026-03-29T12:51:51.030983Z",
  "updated_at": "2026-03-29T12:51:52.016067Z"
}

D. 创建 persona

post https://api.openai-hk.com/suno/persona/voice/create

vox_audio_id A 步骤的返回
voice_recording_id A 步骤的返回
verification_id C 步骤的返回
singer_skill_level 可选值 Advanced Intermediate Beginner Professional
image_s3_id 必须为图片的 base64 格式
注意: is_public 无论为 true false 都会自动设置为 false
is_public 为 false 导致创后的 persona_id 不能跨账号使用
不允许跨账号
计费 100 积分/次

json

{
  "name": "mytitle",
  "description": "god",
  "image_s3_id": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/ base64的图片....",
  "is_public": true,
  "persona_type": "vox",
  "vocal_start_s": 0,
  "vocal_end_s": 23.24,
  "user_input_styles": "pop",
  "source": "random_song",
  "singer_skill_level": "Intermediate",
  "is_voice_recording": true,
  "vox_audio_id": "9e196fa1-20f3-43c1-8066-06a2a6b6bea9",
  "voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768",
  "verification_id": "979282b1-8968-46bc-b599-ea14946be48e"
}

{
  "name": "mytitle",
  "description": "god",
  "image_s3_id": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/ base64的图片....",
  "is_public": true,
  "persona_type": "vox",
  "vocal_start_s": 0,
  "vocal_end_s": 23.24,
  "user_input_styles": "pop",
  "source": "random_song",
  "singer_skill_level": "Intermediate",
  "is_voice_recording": true,
  "vox_audio_id": "9e196fa1-20f3-43c1-8066-06a2a6b6bea9",
  "voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768",
  "verification_id": "979282b1-8968-46bc-b599-ea14946be48e"
}

返回 id 为 persona_id

json

{
  "id": "dde0be60-5280-4bd2-89a0-4020ddd3db52",
  "name": "mytitle",
  "description": "god",
  "image_s3_id": "https://cdn1.suno.ai/d81b5898.jpeg",
  "is_suno_persona": false,
  "is_trashed": false,
  "is_hidden": false,
  "is_owned": true,
  "is_public": false,
  "is_public_approved": false,
  "is_loved": false,
  "upvote_count": 0,
  "clip_count": 0,
  "is_following": false,
  "follower_count": 0,
  "persona_type": "vox",
  "source": "recording",
  "user_input_styles": "pop",
  "vocal_start_s": 0,
  "vocal_end_s": 23.24,
  "vocal_clip_id": "9e196fa1-20f3-43c1-8066-06a2a6b6bea9"
}

{
  "id": "dde0be60-5280-4bd2-89a0-4020ddd3db52",
  "name": "mytitle",
  "description": "god",
  "image_s3_id": "https://cdn1.suno.ai/d81b5898.jpeg",
  "is_suno_persona": false,
  "is_trashed": false,
  "is_hidden": false,
  "is_owned": true,
  "is_public": false,
  "is_public_approved": false,
  "is_loved": false,
  "upvote_count": 0,
  "clip_count": 0,
  "is_following": false,
  "follower_count": 0,
  "persona_type": "vox",
  "source": "recording",
  "user_input_styles": "pop",
  "vocal_start_s": 0,
  "vocal_end_s": 23.24,
  "vocal_clip_id": "9e196fa1-20f3-43c1-8066-06a2a6b6bea9"
}

E.使用 persona_id 生成音乐

post https://api.openai-hk.com/suno/generate

persona_id 为 D 步骤得到
不允许跨账号

json

{
  "task": "vox",
  "generation_type": "TEXT",
  "title": "过年",
  "tags": "",
  "negative_tags": "",
  "mv": "chirp-fenix",
  "prompt": "[Verse 1]\n红纸贴上老门楣\n锅里汤冒着热白汽\n手机里一条条消息\n“回来吗？” 像从前一样着急\n\n[Chorus]\n过年啦 过年啦\n烟花一朵一朵开在天上啊\n你回家啦 我回家啦\n拥抱一秒 把一整年的委屈放下\n过年啦 过年啦\n桌子转啊转着全家的回答\n先吃一口再说心里话\n这一刻 世界都变小了吧\n\n[Verse 2]\n爸在厨房假装很忙\n其实偷看门口好几趟\n妈嫌鞭炮味太呛\n却把围巾又给我围得更紧一点儿长\n\n[Chorus]\n过年啦 过年啦\n烟花一朵一朵开在天上啊\n你回家啦 我回家啦\n拥抱一秒 把一整年的委屈放下\n过年啦 过年啦\n桌子转啊转着全家的回答\n先喝一口再说心里话\n这一刻 别催时间往前跑\n\n[Bridge]\n倒计时时针 快到零点\n我们一起大声许个心愿 (嘿)\n来年就算再远再赶\n也要像今天一样团圆\n\n[Chorus]\n过年啦 过年啦\n笑声一阵一阵飘在屋檐下\n你回家啦 我回家啦\n再拍一张 把现在都收进电话\n过年啦 过年啦\n窗外春风已经替我们出发\n等到下次听到这句话\n你要记得 有个家在等你啊",
  "make_instrumental": false,
  "metadata": {
    "create_mode": "custom"
  },

  "persona_id": "dde0be60-5280-4bd2-89a0-4020ddd3db52"
}

{
  "task": "vox",
  "generation_type": "TEXT",
  "title": "过年",
  "tags": "",
  "negative_tags": "",
  "mv": "chirp-fenix",
  "prompt": "[Verse 1]\n红纸贴上老门楣\n锅里汤冒着热白汽\n手机里一条条消息\n“回来吗？” 像从前一样着急\n\n[Chorus]\n过年啦 过年啦\n烟花一朵一朵开在天上啊\n你回家啦 我回家啦\n拥抱一秒 把一整年的委屈放下\n过年啦 过年啦\n桌子转啊转着全家的回答\n先吃一口再说心里话\n这一刻 世界都变小了吧\n\n[Verse 2]\n爸在厨房假装很忙\n其实偷看门口好几趟\n妈嫌鞭炮味太呛\n却把围巾又给我围得更紧一点儿长\n\n[Chorus]\n过年啦 过年啦\n烟花一朵一朵开在天上啊\n你回家啦 我回家啦\n拥抱一秒 把一整年的委屈放下\n过年啦 过年啦\n桌子转啊转着全家的回答\n先喝一口再说心里话\n这一刻 别催时间往前跑\n\n[Bridge]\n倒计时时针 快到零点\n我们一起大声许个心愿 (嘿)\n来年就算再远再赶\n也要像今天一样团圆\n\n[Chorus]\n过年啦 过年啦\n笑声一阵一阵飘在屋檐下\n你回家啦 我回家啦\n再拍一张 把现在都收进电话\n过年啦 过年啦\n窗外春风已经替我们出发\n等到下次听到这句话\n你要记得 有个家在等你啊",
  "make_instrumental": false,
  "metadata": {
    "create_mode": "custom"
  },

  "persona_id": "dde0be60-5280-4bd2-89a0-4020ddd3db52"
}

28. custom-model 自建模型

2026.3.28 suno 新出 custom-model
上传自己至少 6 收歌曲的自建模型
限制一个账号只能自建 3 个模型

A.上传音乐

post https://api.openai-hk.com/suno/uploads/audio-url

body

json

{
  "url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}

{
  "url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}

首先通过上传接口得到 clip_id 值为 7173c086-844d-4b9e-9cee-e771f7ded3eb
上传第二首开始需要带上 clip_id 因为需要统一到一个账号下
第二首开始的 body

json

{
  "url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3",
  "clip_id": "7173c086-844d-4b9e-9cee-e771f7ded3eb"
}

{
  "url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3",
  "clip_id": "7173c086-844d-4b9e-9cee-e771f7ded3eb"
}

至少上传 6 首歌曲

B.创建 custom-model

post https://api.openai-hk.com/suno/custom-model

clip_ids 为上传的歌曲的 clip_id 必须在同一个账号下的，且至少上传 6 首最优是 24 首
计费 10 倍歌曲费用
body

json

{
  "clip_ids": [
    "7173c086-844d-4b9e-9cee-e771f7ded3eb",
    "c87451ec-8e09-4358-b93b-99a0f59374b3",
    "9c58ae41-4364-4995-827c-8033109abb5d",
    "92022750-af59-44e1-a559-74d6f2503f5e",
    "06215aa7-7725-4741-91d2-cc316e2454fe",
    "f7a1e392-e659-4376-8b24-f267ba4f6e30",
    "1c18d446-51ca-479f-9086-80d269f839ab",
    "51a70cdf-2c7f-4b02-bb28-3c1034c5437b",
    "2c1a6a20-4dfe-4680-867f-cc3b8368ddc4"
  ],
  "name": "你模型名称"
}

{
  "clip_ids": [
    "7173c086-844d-4b9e-9cee-e771f7ded3eb",
    "c87451ec-8e09-4358-b93b-99a0f59374b3",
    "9c58ae41-4364-4995-827c-8033109abb5d",
    "92022750-af59-44e1-a559-74d6f2503f5e",
    "06215aa7-7725-4741-91d2-cc316e2454fe",
    "f7a1e392-e659-4376-8b24-f267ba4f6e30",
    "1c18d446-51ca-479f-9086-80d269f839ab",
    "51a70cdf-2c7f-4b02-bb28-3c1034c5437b",
    "2c1a6a20-4dfe-4680-867f-cc3b8368ddc4"
  ],
  "name": "你模型名称"
}

返回得到 id 为 model_id

json

{
  "id": "3f788ae1-4646-4d20-aa76-c33035bf12e6",
  "status": "pending"
}

{
  "id": "3f788ae1-4646-4d20-aa76-c33035bf12e6",
  "status": "pending"
}

C.查询 custom-model 任务

get https://api.openai-hk.com/suno/custom-model/feed/{model_id}

model_id 为上述返回的 id
返回成功

json

{
  "id": "3f788ae1-4646-4d20-aa76-c33035bf12e6",
  "status": "complete"
}

{
  "id": "3f788ae1-4646-4d20-aa76-c33035bf12e6",
  "status": "complete"
}

D.使用 custom-model

post https://api.openai-hk.com/suno/generate

mv 为 chirp-custom:{model_id} 即为 chirp-custom:3f788ae1-4646-4d20-aa76-c33035bf12e6
不支持跨账号，会根据 model_id 查询账号
body

json

{
  "generation_type": "TEXT",
  "title": "Dook",
  "tags": "dungeon neo soul, bass music",
  "negative_tags": "",
  "mv": "chirp-custom:3f788ae1-4646-4d20-aa76-c33035bf12e6",
  "prompt": "[Verse]\nSunrise creepin' up again\nAnother day another spin\nMy head is buzzin' like a wire\nFuelin' up this inner fire\n\n[Prechorus]\nYeah fire\nJust fire\n\n[Chorus]\nOh my my my what a world we got\nOh my my my never thought I'd trot\nThrough these streets so wild and free\nOh my my my lookin' back at me\n\n[Verse 2]\nCoffee strong and news is weak\nAnother headline makes me shriek\nBut then a bird sings on the pane\nWashes out that worry rain\n\n[Bridge]\nSome folks chase the silver gleam\nSome folks live inside a dream\nMe I just keep movin' on\nTill the break of a brand new dawn\n\n[Chorus]\nOh my my my what a world we got\nOh my my my never thought",
  "metadata": {
    "create_mode": "custom"
  }
}

{
  "generation_type": "TEXT",
  "title": "Dook",
  "tags": "dungeon neo soul, bass music",
  "negative_tags": "",
  "mv": "chirp-custom:3f788ae1-4646-4d20-aa76-c33035bf12e6",
  "prompt": "[Verse]\nSunrise creepin' up again\nAnother day another spin\nMy head is buzzin' like a wire\nFuelin' up this inner fire\n\n[Prechorus]\nYeah fire\nJust fire\n\n[Chorus]\nOh my my my what a world we got\nOh my my my never thought I'd trot\nThrough these streets so wild and free\nOh my my my lookin' back at me\n\n[Verse 2]\nCoffee strong and news is weak\nAnother headline makes me shriek\nBut then a bird sings on the pane\nWashes out that worry rain\n\n[Bridge]\nSome folks chase the silver gleam\nSome folks live inside a dream\nMe I just keep movin' on\nTill the break of a brand new dawn\n\n[Chorus]\nOh my my my what a world we got\nOh my my my never thought",
  "metadata": {
    "create_mode": "custom"
  }
}

Suno 场景应用 ​

1.灵感模式 ​

2.自定义.歌词歌名 ​

3.纯音乐.自定义 ​

4.纯音乐.灵感模式 ​

5.续写自定义音频 ​

A.上传音乐 ​

B.扩展音乐.带版本信息 ​

C.扩展音乐.将弃用 ​

D.拼接完整音乐 ​

6.续写音乐并获取完整音乐 ​

A.生成音乐 ​

B.扩展音乐 ​

C.拼接完整音乐 ​

7.Cover 音乐:音乐翻版\修改风格 ​

A.生成音乐 ​

B.Cover 音乐 ​

8.Replace Section:替换片段 ​

A.生成音乐 ​

B.Replace Section ​

C.确认.拼接完整音乐 ​

8.V2 Replace Section: V2 替换片段 ​

A.获取时间线 ​

B.替换片段 ​

C.确认.拼接完整音乐 ​

9.Persona:歌手风格 ​

A.生成音乐 ​

B.新建 Persona ​

C.使用 persona_id 创作 ​

10.stems:声曲分离 Vocals Instrumental ​

A.生成音乐 ​

B.声曲分离(弃用) ​

B.声曲分离.新 ​

C.获取结果 ​

11.Timing:歌词、音频时间线 ​

A.生成音乐 ​

B.获取歌词 ​

12.wav:获取 wav 格式文件 ​

A.生成音乐 ​

B.获取 wav 文件 ​

13.mp4:生成 mp4 mv 视频 ​

A.生成音乐 ​

B.获取 mp4 文件 ​

14.all-stems:全轨声曲分离 ​

A.生成音乐 ​

B.全轨声曲分离 ​

C.获取结果 ​

15.高阶参数 ​

A.普通生成 ​

B.cover 生成 ​

16. Add Insterumental ​

A.上传清唱歌曲 ​

B.获取歌曲时长等参数 ​

C.执行 Add Insterumental ​

17. Add Vocals ​

A.上传纯音乐 ​

B.获取歌曲时长等参数 ​

C.执行 Add Vocals ​

18. 获取 midi ​

A.全轨分离的 clip_id ​

B.获取 midi ​

19.拓展 style tags ​

20. Remaster ​

21.Persona-v2-vox 版:歌手风格 ​

A.生成音乐 ​

B.获取 vox ​

C.新建 Persona ​

D.使用 persona_id 创作 ​

22.Mashup:混曲 ​

A.生成音乐 ​

B.生成 Mashup ​

23. Lyrics Mashup: 歌词混曲 ​

24. Samples: 取样生成歌曲 ​

A.生成音乐 ​

B.生成 Samples ​

25. Sound: 声音任务 ​

26. inspo: 灵感创作 ​

27. voice: 声音克隆 ​

A. 上传歌曲 ​

B. 获取样本句子 ​

Suno 场景应用

1.灵感模式

2.自定义.歌词歌名

3.纯音乐.自定义

4.纯音乐.灵感模式

5.续写自定义音频

A.上传音乐

B.扩展音乐.带版本信息

C.扩展音乐.将弃用

D.拼接完整音乐

6.续写音乐并获取完整音乐

A.生成音乐

B.扩展音乐

C.拼接完整音乐

7.Cover 音乐:音乐翻版\修改风格

A.生成音乐

B.Cover 音乐

8.Replace Section:替换片段

A.生成音乐

B.Replace Section

C.确认.拼接完整音乐

8.V2 Replace Section: V2 替换片段

A.获取时间线

B.替换片段

C.确认.拼接完整音乐

9.Persona:歌手风格

A.生成音乐

B.新建 Persona

C.使用 persona_id 创作

10.stems:声曲分离 Vocals Instrumental

A.生成音乐

B.声曲分离(弃用)

B.声曲分离.新

C.获取结果

11.Timing:歌词、音频时间线

A.生成音乐

B.获取歌词

12.wav:获取 wav 格式文件

A.生成音乐

B.获取 wav 文件

13.mp4:生成 mp4 mv 视频

A.生成音乐

B.获取 mp4 文件

14.all-stems:全轨声曲分离

A.生成音乐

B.全轨声曲分离

C.获取结果

15.高阶参数

A.普通生成

B.cover 生成

16. Add Insterumental

A.上传清唱歌曲

B.获取歌曲时长等参数

C.执行 Add Insterumental

17. Add Vocals

A.上传纯音乐

B.获取歌曲时长等参数

C.执行 Add Vocals

18. 获取 midi

A.全轨分离的 clip_id

B.获取 midi

19.拓展 style tags

20. Remaster

21.Persona-v2-vox 版:歌手风格

A.生成音乐

B.获取 vox

C.新建 Persona

D.使用 persona_id 创作

22.Mashup:混曲

A.生成音乐

B.生成 Mashup

23. Lyrics Mashup: 歌词混曲

24. Samples: 取样生成歌曲

A.生成音乐

B.生成 Samples

25. Sound: 声音任务

26. inspo: 灵感创作

27. voice: 声音克隆

A. 上传歌曲

B. 获取样本句子