Suno ユースケースシナリオ
- 2026.08.01 nice uploadによる著作権検出回避をサポート
- 2026.04.10 Sunoは
v3.5以下のバージョンを廃止しました。現在、3.5以下のバージョンは強制的にv4.5-allに変換され、価格は変更されません - 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に送信されます - すべての結果は
GEThttps://api.openai-hk.com/sunoapi/feed/clipsId1,clipsId2で取得されます - 以下のリクエストボディは異なる効果を生成します
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": "nostalgia"
}'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": "nostalgia"
}'1. インスピレーションモード
{
"gpt_description_prompt": "nostalgia"
}{
"gpt_description_prompt": "nostalgia"
}2. カスタム歌詞とタイトル
{
"prompt": "[Verse]\nBusy days one after another\nFiles piling up with no end in sight\nDreams tucked away in a drawer\nCoffee cup already gone cold\n\n[Verse 2]\nClock in at eight every morning\nTired eyes with no spark left\nSmall talk with colleagues feels pointless\nJust waiting for time to speed by\n\n[Chorus]\nWork work the boss keeps calling\nFinish up finish up then we're safe\nOvertime overtime just to earn a little\nDreams dreams when will they come true\n\n[Verse 3]\nLunch break eating a bento box\nWatching sunshine pour through the window\nLife feels so far from the dream\nAll I see is the desk and chair\n\n[Bridge]\nThe boss's footsteps sound like thunder\nHeartbeat quickening with the rhythm\nA mountain of files on the desk\nThe sound of complaints slowly fades\n\n[Chorus]\nWork work the boss keeps calling\nFinish up finish up then we're safe\nOvertime overtime just to earn a little\nDreams dreams when will they come true",
"mv": "chirp-v3-5",
"title": "Work",
"tags": " edm"
}{
"prompt": "[Verse]\nBusy days one after another\nFiles piling up with no end in sight\nDreams tucked away in a drawer\nCoffee cup already gone cold\n\n[Verse 2]\nClock in at eight every morning\nTired eyes with no spark left\nSmall talk with colleagues feels pointless\nJust waiting for time to speed by\n\n[Chorus]\nWork work the boss keeps calling\nFinish up finish up then we're safe\nOvertime overtime just to earn a little\nDreams dreams when will they come true\n\n[Verse 3]\nLunch break eating a bento box\nWatching sunshine pour through the window\nLife feels so far from the dream\nAll I see is the desk and chair\n\n[Bridge]\nThe boss's footsteps sound like thunder\nHeartbeat quickening with the rhythm\nA mountain of files on the desk\nThe sound of complaints slowly fades\n\n[Chorus]\nWork work the boss keeps calling\nFinish up finish up then we're safe\nOvertime overtime just to earn a little\nDreams dreams when will they come true",
"mv": "chirp-v3-5",
"title": "Work",
"tags": " edm"
}3. インストゥルメンタル(カスタム)
{
"prompt": "",
"tags": "heavy metal",
"mv": "chirp-v3-5",
"title": "Beijing",
"continue_clip_id": null,
"continue_at": null,
"infill_start_s": null,
"infill_end_s": null
}{
"prompt": "",
"tags": "heavy metal",
"mv": "chirp-v3-5",
"title": "Beijing",
"continue_clip_id": null,
"continue_at": null,
"infill_start_s": null,
"infill_end_s": null
}4. インストゥルメンタル(インスピレーションモード)
{
"gpt_description_prompt": "A national dance pop anthem about dancing all night long",
"mv": "chirp-v3-5",
"prompt": "",
"make_instrumental": true
}{
"gpt_description_prompt": "A national dance pop anthem about dancing all night long",
"mv": "chirp-v3-5",
"prompt": "",
"make_instrumental": true
}5. カスタムオーディオの拡張
A. オーディオのアップロード
まず、アップロードAPIを使用して、値がabcd-1234-1234-1234-abdのclip_idを取得します
B. オーディオの拡張(バージョン付き)
- mvは
chirp-v4、chirp-auk、またはchirp-bluejayにできます - taskは
upload_extendである必要があります
{
"prompt": "lyrics",
"tags": "",
"negative_tags": "",
"mv": "chirp-v4",
"title": "Title",
"continue_clip_id": "ca94a97d-d3f2-4a63-aeee-ba3a43384bcd",
"continue_at": 10,
"task": "upload_extend"
}{
"prompt": "lyrics",
"tags": "",
"negative_tags": "",
"mv": "chirp-v4",
"title": "Title",
"continue_clip_id": "ca94a97d-d3f2-4a63-aeee-ba3a43384bcd",
"continue_at": 10,
"task": "upload_extend"
}C. オーディオの拡張(非推奨)
注:ここでの
mvはchirp-v3-5-uploadまたはchirp-v4-uploadです
{
"prompt": "[Verse]\nBusy days one after another\nFiles piling up with no end in sight\nDreams tucked away in a drawer\nCoffee cup already gone cold\n\n[Verse 2]\nClock in at eight every morning\nTired eyes with no spark left\nSmall talk with colleagues feels pointless\nJust waiting for time to speed by\n\n[Chorus]\nWork work the boss keeps calling\nFinish up finish up then we're safe\nOvertime overtime just to earn a little\nDreams dreams when will they come true\n\n[Verse 3]\nLunch break eating a bento box\nWatching sunshine pour through the window\nLife feels so far from the dream\nAll I see is the desk and chair\n\n[Bridge]\nThe boss's footsteps sound like thunder\nHeartbeat quickening with the rhythm\nA mountain of files on the desk\nThe sound of complaints slowly fades\n\n[Chorus]\nWork work the boss keeps calling\nFinish up finish up then we're safe\nOvertime overtime just to earn a little\nDreams dreams when will they come true",
"tags": "heavy metal",
"mv": "chirp-v3-5-upload",
"title": "Work",
"continue_clip_id": "abcd-1234-1234-1234-abd",
"continue_at": 30.792
}{
"prompt": "[Verse]\nBusy days one after another\nFiles piling up with no end in sight\nDreams tucked away in a drawer\nCoffee cup already gone cold\n\n[Verse 2]\nClock in at eight every morning\nTired eyes with no spark left\nSmall talk with colleagues feels pointless\nJust waiting for time to speed by\n\n[Chorus]\nWork work the boss keeps calling\nFinish up finish up then we're safe\nOvertime overtime just to earn a little\nDreams dreams when will they come true\n\n[Verse 3]\nLunch break eating a bento box\nWatching sunshine pour through the window\nLife feels so far from the dream\nAll I see is the desk and chair\n\n[Bridge]\nThe boss's footsteps sound like thunder\nHeartbeat quickening with the rhythm\nA mountain of files on the desk\nThe sound of complaints slowly fades\n\n[Chorus]\nWork work the boss keeps calling\nFinish up finish up then we're safe\nOvertime overtime just to earn a little\nDreams dreams when will they come true",
"tags": "heavy metal",
"mv": "chirp-v3-5-upload",
"title": "Work",
"continue_clip_id": "abcd-1234-1234-1234-abd",
"continue_at": 30.792
}D. フルソングの結合
- 注:
is_infillはfalseである必要があります - 置き換えられた曲IDを取得した後、クエリAPIを使用してステータスを確認します
- 課金:1曲分のコスト
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
}'リクエストボディ:
{
"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を使用して音楽を生成し、1つの曲のclip_id(値abcd-1234-1234-1234-abd)を取得します
B. 音楽の拡張
2つの新しいclip_id値を返します。そのうちの1つはnewid-1234-1234-1234-oneです
{
"prompt": "[Verse]\nBusy days one after another\nFiles piling up with no end in sight\nDreams tucked away in a drawer\nCoffee cup already gone cold\n\n[Verse 2]\nClock in at eight every morning\nTired eyes with no spark left\nSmall talk with colleagues feels pointless\nJust waiting for time to speed by\n\n[Chorus]\nWork work the boss keeps calling\nFinish up finish up then we're safe\nOvertime overtime just to earn a little\nDreams dreams when will they come true\n\n[Verse 3]\nLunch break eating a bento box\nWatching sunshine pour through the window\nLife feels so far from the dream\nAll I see is the desk and chair\n\n[Bridge]\nThe boss's footsteps sound like thunder\nHeartbeat quickening with the rhythm\nA mountain of files on the desk\nThe sound of complaints slowly fades\n\n[Chorus]\nWork work the boss keeps calling\nFinish up finish up then we're safe\nOvertime overtime just to earn a little\nDreams dreams when will they come true",
"tags": "heavy metal",
"mv": "chirp-v3-5",
"title": "Work",
"continue_clip_id": "abcd-1234-1234-1234-abd",
"continue_at": 30,
"task": "extend"
}{
"prompt": "[Verse]\nBusy days one after another\nFiles piling up with no end in sight\nDreams tucked away in a drawer\nCoffee cup already gone cold\n\n[Verse 2]\nClock in at eight every morning\nTired eyes with no spark left\nSmall talk with colleagues feels pointless\nJust waiting for time to speed by\n\n[Chorus]\nWork work the boss keeps calling\nFinish up finish up then we're safe\nOvertime overtime just to earn a little\nDreams dreams when will they come true\n\n[Verse 3]\nLunch break eating a bento box\nWatching sunshine pour through the window\nLife feels so far from the dream\nAll I see is the desk and chair\n\n[Bridge]\nThe boss's footsteps sound like thunder\nHeartbeat quickening with the rhythm\nA mountain of files on the desk\nThe sound of complaints slowly fades\n\n[Chorus]\nWork work the boss keeps calling\nFinish up finish up then we're safe\nOvertime overtime just to earn a little\nDreams dreams when will they come true",
"tags": "heavy metal",
"mv": "chirp-v3-5",
"title": "Work",
"continue_clip_id": "abcd-1234-1234-1234-abd",
"continue_at": 30,
"task": "extend"
}C. フルソングの結合
- 注:
is_infillはfalseである必要があります - 置き換えられた曲IDを取得した後、クエリAPIを使用してステータスを確認します
- 課金:100クレジット(¥0.01)
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
}'リクエストボディ:
{
"clip_id": "newid-1234-1234-1234-one",
"is_infill": false
}{
"clip_id": "newid-1234-1234-1234-one",
"is_infill": false
}7. カバー音楽:リメイク / スタイル変更
A. 音楽の生成
- シナリオ1、2、または3を使用して音楽を生成し、1つの曲の
clip_id(値abcd-1234-1234-1234-abd)を取得します - アップロードAPIを使用して
clip_idを取得し、カスタムオーディオをカバーすることもできます
B. 音楽のカバー
- 注:
mvはchirp-v4、chirp-auk、またはchirp-bluejayである必要があります taskはcoverである必要があります- クロスアカウント使用がサポートされています。アカウントの有効期限を心配する必要はありません
cover_clip_idがアップロードされたclip_idの場合、クロスアカウントはサポートされませんmvはchirp-v3-5-tauまたはchirp-v4-tauを使用しなくなりました
{
"prompt": "[Verse]\nBusy days one after another\nFiles piling up with no end in sight\nDreams tucked away in a drawer\nCoffee cup already gone cold\n\n[Verse 2]\nClock in at eight every morning\nTired eyes with no spark left\nSmall talk with colleagues feels pointless\nJust waiting for time to speed by\n\n[Chorus]\nWork work the boss keeps calling\nFinish up finish up then we're safe\nOvertime overtime just to earn a little\nDreams dreams when will they come true\n\n[Verse 3]\nLunch break eating a bento box\nWatching sunshine pour through the window\nLife feels so far from the dream\nAll I see is the desk and chair\n\n[Bridge]\nThe boss's footsteps sound like thunder\nHeartbeat quickening with the rhythm\nA mountain of files on the desk\nThe sound of complaints slowly fades\n\n[Chorus]\nWork work the boss keeps calling\nFinish up finish up then we're safe\nOvertime overtime just to earn a little\nDreams dreams when will they come true",
"generation_type": "TEXT",
"tags": "rock, punk",
"negative_tags": "",
"mv": "chirp-auk",
"title": "Work (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]\nBusy days one after another\nFiles piling up with no end in sight\nDreams tucked away in a drawer\nCoffee cup already gone cold\n\n[Verse 2]\nClock in at eight every morning\nTired eyes with no spark left\nSmall talk with colleagues feels pointless\nJust waiting for time to speed by\n\n[Chorus]\nWork work the boss keeps calling\nFinish up finish up then we're safe\nOvertime overtime just to earn a little\nDreams dreams when will they come true\n\n[Verse 3]\nLunch break eating a bento box\nWatching sunshine pour through the window\nLife feels so far from the dream\nAll I see is the desk and chair\n\n[Bridge]\nThe boss's footsteps sound like thunder\nHeartbeat quickening with the rhythm\nA mountain of files on the desk\nThe sound of complaints slowly fades\n\n[Chorus]\nWork work the boss keeps calling\nFinish up finish up then we're safe\nOvertime overtime just to earn a little\nDreams dreams when will they come true",
"generation_type": "TEXT",
"tags": "rock, punk",
"negative_tags": "",
"mv": "chirp-auk",
"title": "Work (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. セクションの置き換え
A. 音楽の生成
シナリオ1、2、または3を使用して音楽を生成し、1つの曲のclip_id(値abcd-1234-1234-1234-abd)を取得します
B. セクションの置き換え
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値を返します。次のステップのために1つ(newid-1234-1234-1234-one)を選択します mvはchirp-v3-5-tauまたはchirp-v4-tauを使用しなくなりました
{
"task": "infill",
"generation_type": "TEXT",
"title": "Scale of Longing-replace",
"tags": "Sorrow/Sad,Female Vocals,Mandarin",
"mv": "chirp-auk",
"prompt": "《Scale of Longing》 \n \nLyrics: A Guo Yi Luo\nThe rings of a tree hold the warmth of your running steps. \nEvery falling leaf calls out your name\nBut one gust of wind turns it to mist. \nTidying up your guitar in the corner \nThe case holds all the rainy seasons,\nSoaking the back of the rosewood. \nIf I wound my longing into new strings,\nI fear one touch would shatter them\nInto echoes of back then. \nTime is a rewound videotape,\nThe deeper the night, the clearer your laughter comes. \nIf tears could water a time tunnel,\nI'd cry my eyes into a sea. \nWhen every spring becomes about you,\nI learn to breathe through the wound. \nTo keep loving you,\nUsing up",
"metadata": {
"infill_lyrics": ". \nTidying up your guitar in the corner \nThe case holds all the rainy seasons,\nSoaking the back of the rosewood. \nIf I wound my longing into new strings,\nI fear one touch would shatter them\nInto echoes of back then"
},
"continue_clip_id": "8a858961-8831-4423-8ffb-2dec096aea0a",
"continued_aligned_prompt": "《Scale of Longing》 \n \nLyrics: A Guo Yi Luo\nThe rings of a tree hold the warmth of your running steps. \nEvery falling leaf calls out your name\nBut one gust of wind turns it to mist. \nTidying up your guitar in the corner \nThe case holds all the rainy seasons,\nSoaking the back of the rosewood. \nIf I wound my longing into new strings,\nI fear one touch would shatter them\nInto echoes of back then. \nTime is a rewound videotape,\nThe deeper the night, the clearer your laughter comes. \nIf tears could water a time tunnel,\nI'd cry my eyes into a sea. \nWhen every spring becomes about you,\nI learn to breathe through the wound. \nTo keep loving you,\nUsing up everything\nA heartbeat that no longer beats.\nTidying up your guitar in the corner \nThe case holds all the rainy seasons,\nSoaking the back of the rosewood. \nIf I wound my longing into new strings,\nI fear one touch would shatter them\nInto echoes of back then. \nWhen every spring becomes about you,\nI learn to breathe through the wound. \nTo keep loving you,\nUsing up everything\nA heartbeat that no longer beats.\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": "Scale of Longing-replace",
"tags": "Sorrow/Sad,Female Vocals,Mandarin",
"mv": "chirp-auk",
"prompt": "《Scale of Longing》 \n \nLyrics: A Guo Yi Luo\nThe rings of a tree hold the warmth of your running steps. \nEvery falling leaf calls out your name\nBut one gust of wind turns it to mist. \nTidying up your guitar in the corner \nThe case holds all the rainy seasons,\nSoaking the back of the rosewood. \nIf I wound my longing into new strings,\nI fear one touch would shatter them\nInto echoes of back then. \nTime is a rewound videotape,\nThe deeper the night, the clearer your laughter comes. \nIf tears could water a time tunnel,\nI'd cry my eyes into a sea. \nWhen every spring becomes about you,\nI learn to breathe through the wound. \nTo keep loving you,\nUsing up",
"metadata": {
"infill_lyrics": ". \nTidying up your guitar in the corner \nThe case holds all the rainy seasons,\nSoaking the back of the rosewood. \nIf I wound my longing into new strings,\nI fear one touch would shatter them\nInto echoes of back then"
},
"continue_clip_id": "8a858961-8831-4423-8ffb-2dec096aea0a",
"continued_aligned_prompt": "《Scale of Longing》 \n \nLyrics: A Guo Yi Luo\nThe rings of a tree hold the warmth of your running steps. \nEvery falling leaf calls out your name\nBut one gust of wind turns it to mist. \nTidying up your guitar in the corner \nThe case holds all the rainy seasons,\nSoaking the back of the rosewood. \nIf I wound my longing into new strings,\nI fear one touch would shatter them\nInto echoes of back then. \nTime is a rewound videotape,\nThe deeper the night, the clearer your laughter comes. \nIf tears could water a time tunnel,\nI'd cry my eyes into a sea. \nWhen every spring becomes about you,\nI learn to breathe through the wound. \nTo keep loving you,\nUsing up everything\nA heartbeat that no longer beats.\nTidying up your guitar in the corner \nThe case holds all the rainy seasons,\nSoaking the back of the rosewood. \nIf I wound my longing into new strings,\nI fear one touch would shatter them\nInto echoes of back then. \nWhen every spring becomes about you,\nI learn to breathe through the wound. \nTo keep loving you,\nUsing up everything\nA heartbeat that no longer beats.\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を取得した後、クエリAPIを使用してステータスを確認します
- 課金:100クレジット(¥0.01)
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
}'リクエストボディ:
{
"clip_id": "newid-1234-1234-1234-one",
"is_infill": true
}{
"clip_id": "newid-1234-1234-1234-one",
"is_infill": true
}8.V2 セクションの置き換え:V2セグメントの置き換え
- 目標:clip_id
4cd8a76f-802a-42a5-8064-3ba9c6138072の歌詞just missing your presence by my sideをjust missing yesterday without you by my sideに置き換えます - 実際には
by my side→yesterdayのみを置き換えます
A. タイムラインの取得
get https://api.openai-hk.com/suno/act/timing/4cd8a76f-802a-42a5-8064-3ba9c6138072
- タイムラインコンテンツパラメータはこちらからダウンロードできます:https://www.openai-hk.com/res/timing.json
- ターゲットワードを検索して、その
start_sをaligned_lyrics[8].words[8]=60.6からinfill_context_start_sとして見つけます
{
"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として見つけます
{
"text": "回",
"start_s": 90.47872340425532,
"end_s": 90.55851063829788
}{
"text": "回",
"start_s": 90.47872340425532,
"end_s": 90.55851063829788
}- 置き換えるワードを検索し、
aligned_lyrics[11]を見つけます
{
"text": "just missing by my side,",
"words": [
......
{
"text": "by",
"start_s": 75.47872340425532, // これをinfill_start_sとして使用
"end_s": 75.55851063829788
},
{
"text": "side",
"start_s": 75.71808510638299,
"end_s": 75.79787234042553 // これをinfill_end_sとして使用
},
......
]
}{
"text": "just missing by my side,",
"words": [
......
{
"text": "by",
"start_s": 75.47872340425532, // これをinfill_start_sとして使用
"end_s": 75.55851063829788
},
{
"text": "side",
"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値を返します。次のステップのために1つ(newid-1234-1234-1234-one)を選択します
{
"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を取得した後、クエリAPIを使用してステータスを確認します
- 課金:100クレジット(¥0.01)
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
}'リクエストボディ:
{
"clip_id": "newid-1234-1234-1234-one",
"is_infill": true
}{
"clip_id": "newid-1234-1234-1234-one",
"is_infill": true
}9. ペルソナ:歌手スタイル
A. 音楽の生成
シナリオ1、2、または3を使用して音楽を生成し、1つの曲のclip_id(値4cd8a76f-802a-42a5-8064-3ba9c6138072)を取得します
B. ペルソナの作成
clip_idはシステムに存在する必要があり、アップロードされたクリップにすることはできません- クロスアカウントはサポートされていません。アカウントの有効期限が切れると利用できない場合があります
- 悪用を防ぐため、100クレジットが差し引かれます
リクエストボディ:
{
"root_clip_id": "54834687-5e79-4f08-8e14-cf188f15b598",
"name": "Persona Title",
"description": "Persona Description",
"clips": ["54834687-5e79-4f08-8e14-cf188f15b598"],
"is_public": true
}{
"root_clip_id": "54834687-5e79-4f08-8e14-cf188f15b598",
"name": "Persona Title",
"description": "Persona Description",
"clips": ["54834687-5e79-4f08-8e14-cf188f15b598"],
"is_public": true
}レスポンス:キーidの値fd213afd-ac1c-4822-9802-c1c0ea45e77bが次のステップのpersona_idです
{
"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を使用して作成
- 注:
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を使用しなくなりました
{
"prompt": "[Verse]\nFrom dawn to dusk you've been by my side so warm\nRain or shine I'm not afraid\nHolding hands we'll never part\n\n[Verse 2]\nWith you I'm never alone\nLike stars shining in the night\nNo road feels too long\nBecause you are my light\n\n[Chorus]\nDarling darling I love you\nYou're the only one in my world\nNo matter where we roam\nOur hearts will always follow\n\n[Verse 3]\nYou're my safe harbor\nEvery night my dreams are of you\nEven if the road ahead is hard\nWith you everything's beautiful\n\n[Chorus]\nDarling darling I love you\nYou're the only one in my world\nNo matter where we roam\nOur hearts will always follow\n\n[Bridge]\nEvery moment in this life\nWith you to share and feel\nAll tomorrows will be better\nBecause with you I'm invincible",
"generation_type": "TEXT",
"tags": "electronic, pop",
"negative_tags": "",
"mv": "chirp-v4",
"title": "Darling",
"task": "artist_consistency",
"persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
"artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163"
}{
"prompt": "[Verse]\nFrom dawn to dusk you've been by my side so warm\nRain or shine I'm not afraid\nHolding hands we'll never part\n\n[Verse 2]\nWith you I'm never alone\nLike stars shining in the night\nNo road feels too long\nBecause you are my light\n\n[Chorus]\nDarling darling I love you\nYou're the only one in my world\nNo matter where we roam\nOur hearts will always follow\n\n[Verse 3]\nYou're my safe harbor\nEvery night my dreams are of you\nEven if the road ahead is hard\nWith you everything's beautiful\n\n[Chorus]\nDarling darling I love you\nYou're the only one in my world\nNo matter where we roam\nOur hearts will always follow\n\n[Bridge]\nEvery moment in this life\nWith you to share and feel\nAll tomorrows will be better\nBecause with you I'm invincible",
"generation_type": "TEXT",
"tags": "electronic, pop",
"negative_tags": "",
"mv": "chirp-v4",
"title": "Darling",
"task": "artist_consistency",
"persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
"artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163"
}レスポンス:
{
"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": "...(lyrics)...",
"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": "Darling",
"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": "...(lyrics)...",
"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": "Darling",
"play_count": 0,
"upvote_count": 0,
"is_public": false
}
],
"metadata": {
"tags": "electronic, pop",
"prompt": "...(lyrics)...",
"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": "...(lyrics)...",
"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": "Darling",
"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": "...(lyrics)...",
"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": "Darling",
"play_count": 0,
"upvote_count": 0,
"is_public": false
}
],
"metadata": {
"tags": "electronic, pop",
"prompt": "...(lyrics)...",
"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:ボーカル/インストゥルメンタル分離
- 分離後:ボーカル(ボーカルトラック)
- 分離後:インストゥルメンタル(バッキングトラック / 純音楽)
A. 音楽の生成
シナリオ1、2、または3を使用して音楽を生成し、1つの曲のclip_id(値a624123d-22cc-4d4d-bf28-78d312f61597)を取得します
B. ボーカル/インストゥルメンタルの分離(非推奨)
公式API廃止、以下の新しいAPIを使用してください
get https://api.openai-hk.com/sunoapi/act/stems/a624123d-22cc-4d4d-bf28-78d312f61597
悪用を防ぐため、
100クレジットが差し引かれますレスポンスはclip_1とclip_2を返します
クロスアカウントはサポートされていません。アカウントの有効期限が切れると利用できません
B. ボーカル/インストゥルメンタルの分離(新規)
リクエストボディ:
- 注:
mvはchirp-aukである必要があります taskはgen_stemである必要がありますstem_taskはtwoである必要がありますstem_type_group_nameはTwoである必要がありますcontinue_clip_idはステップAのclip_idです- クロスアカウントサポート
- 課金:1回の生成コスト
{
"task": "gen_stem",
"generation_type": "TEXT",
"title": "Safety String",
"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": "Safety String",
"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"
}- レスポンス:
{
"clips": [
{
"id": "5f3587e2-75fb-4c36-84b3-3ec113897a4c",
"video_url": "",
"audio_url": "",
"major_model_version": "",
"model_name": "",
"metadata": {
"tags": "Chinese",
"prompt": "...(lyrics)...",
"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": "Riding the Dream Dragon - 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": "Riding the Dream Dragon - 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": "...(lyrics)...",
"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": "Riding the Dream Dragon - 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": "Riding the Dream Dragon - Instrumental",
"play_count": 0,
"upvote_count": 0,
"is_public": false
}
]
}C. 結果の取得
レスポンス:
[
{
"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": "...(lyrics)...",
"stem_from_id": "a624123d-22cc-4d4d-bf28-78d312f61597",
"tags": "Chinese",
"type": "stem"
},
"model_name": "",
"play_count": 0,
"status": "complete",
"title": "Riding the Dream Dragon - 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": "Riding the Dream Dragon - 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": "...(lyrics)...",
"stem_from_id": "a624123d-22cc-4d4d-bf28-78d312f61597",
"tags": "Chinese",
"type": "stem"
},
"model_name": "",
"play_count": 0,
"status": "complete",
"title": "Riding the Dream Dragon - 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": "Riding the Dream Dragon - Instrumental",
"upvote_count": 0,
"video_url": "https://cdn1.suno.ai/9c85d619-4cac-4561-8fa3-604c116fa1c5.mp4"
}
]11. Timing:歌詞とオーディオのタイムライン
A. 音楽の生成
シナリオ1、2、または3を使用して音楽を生成し、1つの曲のclip_id(値54834687-5e79-4f08-8e14-cf188f15b598)を取得します
B. 歌詞の取得
レスポンス:
{
"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を使用して音楽を生成し、1つの曲の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クレジットが差し引かれます - クロスアカウントはサポートされていません。アカウントの有効期限が切れると利用できません
- レスポンス:
{
"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を使用して音楽を生成し、1つの曲のclip_id(値a624123d-22cc-4d4d-bf28-78d312f61597)を取得します
B. MP4ファイルの取得
get https://api.openai-hk.com/sunoapi/act/mp4/a624123d-22cc-4d4d-bf28-78d312f61597
- 曲のステータスが
completeである必要があります - 実行後、URLにアクセスできるようになるまで約30秒待ちます
- 悪用を防ぐため、
100クレジットが差し引かれます - クロスアカウントはサポートされていません。アカウントの有効期限が切れると利用できません
- レスポンス:
{
"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を使用して音楽を生成し、1つの曲のclip_id(値a624123d-22cc-4d4d-bf28-78d312f61597)を取得します
B. フルトラック分離
- 注:
mvはchirp-aukである必要があります taskはgen_stemである必要がありますstem_taskはtwelveである必要がありますstem_type_group_nameはTwelveである必要がありますcontinue_clip_idはステップAのclip_idです- クロスアカウントサポート
- 課金:基本価格の5倍 — 5リクエスト / 10曲のコスト
{
"task": "gen_stem",
"generation_type": "TEXT",
"title": "Safety String",
"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": "Safety String",
"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を一度にクエリします
レスポンス例:
{
"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": "Safety String (Vocals)",
"play_count": 0,
"upvote_count": 0,
"is_public": false,
"allow_comments": true
},
{
"more": "24 similar items in total"
}
],
"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": "Safety String (Vocals)",
"play_count": 0,
"upvote_count": 0,
"is_public": false,
"allow_comments": true
},
{
"more": "24 similar items in total"
}
],
"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. 結果の取得
- 24個すべてのclip_idを1つのリクエストに連結します
15. 高度なパラメータ
- 2025年6月、Sunoは3つの新しい高度なパラメータを追加しました
- パラメータ:
weirdness_constraint、style_weight、audio_weight audio_weightはcover、Add Instrumental、Add Vocalsの際にのみ表示されます- すべての値は0から1の範囲です
- 2025年9月、
vocal_genderが追加されました:女性f、男性m
A. 標準生成
{
"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": "modern",
"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": "modern",
"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. カバー生成
- カバーの際は、追加の
audio_weightパラメータがあります
{
"prompt": "[Verse]\nNew Year's bell is ringing\nFireworks light up the night\nLaughter spreading everywhere\nGood fortune by your side\n\n[Chorus]\nHappy New Year joy and cheer\nRed lanterns glow along the street\nFamily reunion happiness blooms\nMay wishes come true and blessings meet\n\n[Verse 2]\nSpring breeze gently blowing\nBringing luck and flowers in bloom\nNew clothes new shoes new expectations\nDreams begin to unfold\n\n[Chorus]\nHappy New Year joy and cheer\nRed lanterns glow along the street\nFamily reunion happiness blooms\nMay wishes come true and blessings meet\n\n[Bridge]\nFirecracker sounds exploding\nWelcoming new opportunities\nEvery household filled with joy\nThe spirit of the new year spreading\n\n[Chorus]\nHappy New Year joy and cheer\nRed lanterns glow along the street\nFamily reunion happiness blooms\nMay wishes come true and blessings meet",
"generation_type": "TEXT",
"tags": "",
"negative_tags": "",
"mv": "chirp-auk",
"title": "Happy New Year (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]\nNew Year's bell is ringing\nFireworks light up the night\nLaughter spreading everywhere\nGood fortune by your side\n\n[Chorus]\nHappy New Year joy and cheer\nRed lanterns glow along the street\nFamily reunion happiness blooms\nMay wishes come true and blessings meet\n\n[Verse 2]\nSpring breeze gently blowing\nBringing luck and flowers in bloom\nNew clothes new shoes new expectations\nDreams begin to unfold\n\n[Chorus]\nHappy New Year joy and cheer\nRed lanterns glow along the street\nFamily reunion happiness blooms\nMay wishes come true and blessings meet\n\n[Bridge]\nFirecracker sounds exploding\nWelcoming new opportunities\nEvery household filled with joy\nThe spirit of the new year spreading\n\n[Chorus]\nHappy New Year joy and cheer\nRed lanterns glow along the street\nFamily reunion happiness blooms\nMay wishes come true and blessings meet",
"generation_type": "TEXT",
"tags": "",
"negative_tags": "",
"mv": "chirp-auk",
"title": "Happy New Year (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. インストゥルメンタルの追加
- バージョンは
v4.5+以上である必要があります - 2025年8月、Sunoによって導入されました
- アカペラ(ボーカルのみ、音楽なし)トラックをアップロードし、Sunoに楽器演奏を追加させます
taskはunderpaintingである必要がありますunderpainting_clip_idはupload_clip_idですunderpainting_end_sはアップロードのduration以下である必要があります- 課金:1曲生成のコスト
- クロスアカウント不可
A. アカペラトラックのアップロード
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として返します:
{
"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
- feed APIを使用して
metadata.durationを取得します
C. インストゥルメンタルの追加を実行
taskはunderpaintingである必要がありますunderpainting_clip_idはupload_clip_idですunderpainting_end_sはアップロードのduration以下である必要があります- これは音楽を追加するためなので、歌詞は空にするのが最適です
- リクエストボディ:
{
"mv": "chirp-bluejay",
"tags": "Pop rap, uplifting, magnetic male vocals, piano, synth, electric guitar, driving bass, clear structure",
"title": "Hi Instrumental",
"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 Instrumental",
"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. ボーカルの追加
- バージョンは
v4.5+以上である必要があります - 2025年8月、Sunoによって導入されました
- インストゥルメンタルトラックをアップロードし、Sunoに歌詞を書いてボーカルを追加させます
taskはoverpaintingである必要がありますoverpainting_clip_idはupload_clip_idですoverpainting_end_sはアップロードのduration以下である必要があります- 課金:1曲生成のコスト
- クロスアカウント不可
A. インストゥルメンタルトラックのアップロード
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として返します:
{
"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
- feed APIを使用して
metadata.durationを取得します - また、
metadata.tags(タグ)も取得します
C. ボーカルの追加を実行
taskはoverpaintingである必要がありますoverpainting_clip_idはupload_clip_idですoverpainting_end_sはアップロードのmetadata.duration以下である必要がありますtagsはアップロードのmetadata.tagsと一致する必要があります- リクエストボディ:
{
"mv": "chirp-bluejay",
"tags": "A smooth, soulful R&B track with a moderate tempo and a relaxed, laid-back feel. The instrumentation features a clean electric guitar playing arpeggiated chords, a prominent bass guitar providing a walking bass line, and a drum kit with a soft, brushed snare sound. The male lead vocal is smooth and melodic, with a baritone range and a slightly melancholic tone. The song is in a minor key, contributing to its introspective mood. Production elements include a subtle reverb on the vocals and guitar, creating a spacious and intimate atmosphere. The song structure follows a typical verse-chorus format with a clear melodic progression.",
"title": "Hi Vocal",
"overpainting_clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
"overpainting_start_s": 0,
"overpainting_end_s": 57.9,
"task": "overpainting",
"prompt": "Write the lyrics yourself",
"override_fields": ["prompt", "tags"]
}{
"mv": "chirp-bluejay",
"tags": "A smooth, soulful R&B track with a moderate tempo and a relaxed, laid-back feel. The instrumentation features a clean electric guitar playing arpeggiated chords, a prominent bass guitar providing a walking bass line, and a drum kit with a soft, brushed snare sound. The male lead vocal is smooth and melodic, with a baritone range and a slightly melancholic tone. The song is in a minor key, contributing to its introspective mood. Production elements include a subtle reverb on the vocals and guitar, creating a spacious and intimate atmosphere. The song structure follows a typical verse-chorus format with a clear melodic progression.",
"title": "Hi Vocal",
"overpainting_clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
"overpainting_start_s": 0,
"overpainting_end_s": 57.9,
"task": "overpainting",
"prompt": "Write the lyrics yourself",
"override_fields": ["prompt", "tags"]
}18. MIDIの取得
A. フルトラック分離されたclip_id
- 14. all-stems:フルトラック分離から
clip_id(値a624123d-22cc-4d4d-bf28-78d312f61597)を取得します - 注:通常の音楽
clip_idも使用できますが、公式サイトではフルトラック分離されたクリップのみがこの機能を持っています - 課金:100クレジット
- クロスアカウントはサポートされていません。アカウントの有効期限が切れると利用できません
B. MIDIの取得
get https://api.openai-hk.com/suno/act/midi/c5bffd3a-96ad-4e83-9fbe-4720a5b9a664
- 処理中の場合:
{ "state": "running" }{ "state": "running" }- 完了時:
{
"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. スタイルタグの拡張
- タグはスタイルと同じです
- スタイルの書き方がわからない場合は、このAPIを使用してください
- 課金:100クレジット
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:関連するプロンプトキーワードを入力しますレスポンス:
{
"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. リマスター
model_name:v5の場合はchirp-carp、v4.5+の場合はchirp-bassclip_id:リマスターするIDvariation_categoryはv5+でのみサポートされ、3つの値のみ:high、normal、subtleクロスアカウント不可
課金:1回の生成コスト
リクエストボディ:
{
"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を使用して音楽を生成し、1つの曲のclip_id(値7b5a87af-d567-4444-97c2-387ba5c816d5)を取得します
B. Voxの取得
- クロスアカウントはサポートされていません。アカウントの有効期限が切れると利用できない場合があります
- 悪用を防ぐため、100クレジットが差し引かれます
vocal_end_s-vocal_start_sは30未満である必要がありますpost https://api.openai-hk.com/suno/act/vox/7b5a87af-d567-4444-97c2-387ba5c816d5
{
"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です
{
"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. ペルソナの作成
root_clip_idはシステムに存在する必要があり、アップロードされたクリップにすることはできません。ステップAから取得します- クロスアカウントはサポートされていません。アカウントの有効期限が切れると利用できない場合があります
- 悪用を防ぐため、100クレジットが差し引かれます
vocal_end_s-vocal_start_sは30未満である必要がありますpersona_typeはvoxである必要があります
リクエストボディ:
{
"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です
{
"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を使用して作成
taskはvoxである必要があります(以前はartist_consistency)- 注:
mvはchirp-crow(v5+)のみをサポートします persona_idはステップCから取得しますartist_clip_idはステップAのclip_idです- クロスアカウントサポート
chirp-v4-tau、chirp-auk、またはchirp-bluejayを使用するには、taskをartist_consistencyにする必要があります
{
"prompt": "[Verse]\nThe noise finally steps aside,\nMoonlight quietly climbs the window frame.\nWeary soul, put down your disguise,\nHide in the soft world of dreams.\n[Chorus] (recommend soft breathy vocals, extremely gentle)\nGoodnight, starlight by the pillow,\nTake you drifting through the Milky Way.\nForget the panic of the daylight,\nSleep now, the night is long.",
"generation_type": "TEXT",
"tags": "Ethereal Lullaby, Acoustic Piano, Ambient, Healing, Slow Tempo",
"negative_tags": "",
"mv": "chirp-crow",
"title": "Goodnight",
"task": "vox",
"persona_id": "88cca736-7263-4794-8480-360c0123b6fc",
"artist_clip_id": "6c983654-7ee9-4e1f-b195-47259a5bed48"
}{
"prompt": "[Verse]\nThe noise finally steps aside,\nMoonlight quietly climbs the window frame.\nWeary soul, put down your disguise,\nHide in the soft world of dreams.\n[Chorus] (recommend soft breathy vocals, extremely gentle)\nGoodnight, starlight by the pillow,\nTake you drifting through the Milky Way.\nForget the panic of the daylight,\nSleep now, the night is long.",
"generation_type": "TEXT",
"tags": "Ethereal Lullaby, Acoustic Piano, Ambient, Healing, Slow Tempo",
"negative_tags": "",
"mv": "chirp-crow",
"title": "Goodnight",
"task": "vox",
"persona_id": "88cca736-7263-4794-8480-360c0123b6fc",
"artist_clip_id": "6c983654-7ee9-4e1f-b195-47259a5bed48"
}22. マッシュアップ
A. 音楽の生成
シナリオ1、2、または3を使用して音楽を生成し、2つの曲を取得します: clip_id_1 = 9f102969-0024-479e-b38f-c0c5db21383dclip_id_2 = 6aebb715-701c-433f-b976-a7ff5cf16255
B. マッシュアップの生成
taskはmashup_conditionである必要がありますmashup_clip_idsはステップAの配列['clip_id_1', 'clip_id_2']ですpromptは歌詞です。両方の曲の歌詞をミックスしたい場合は、23. 歌詞マッシュアップを参照してください- 課金:1曲生成の基本コスト
{
"task": "mashup_condition",
"generation_type": "TEXT",
"title": "Banban83 vs bluespawn x Orphan of Guangzhou (Mashup)",
"tags": "",
"negative_tags": "",
"mv": "chirp-crow",
"prompt": "You keep turning back inside the station\nI can't bring myself to leave outside\nI have an ominous feeling\nToday's farewell feels like a breakup\n \nYou disappear into the crowd\nLike a dream scattered by the wind\nGuangzhou South Station, crowds surging\nWho cares about the pain in my heart\n \nI'm like an orphan of Guangzhou\nI'm like a superfluous orphan\nI'm like a helpless orphan\nAlone again now\n \nSafe travels my loved one\nTake care my loved one\nSafe travels the one who left\nTake care the one gone far away",
"mashup_clip_ids": [
"9f102969-0024-479e-b38f-c0c5db21383d",
"6aebb715-701c-433f-b976-a7ff5cf16255"
]
}{
"task": "mashup_condition",
"generation_type": "TEXT",
"title": "Banban83 vs bluespawn x Orphan of Guangzhou (Mashup)",
"tags": "",
"negative_tags": "",
"mv": "chirp-crow",
"prompt": "You keep turning back inside the station\nI can't bring myself to leave outside\nI have an ominous feeling\nToday's farewell feels like a breakup\n \nYou disappear into the crowd\nLike a dream scattered by the wind\nGuangzhou South Station, crowds surging\nWho cares about the pain in my heart\n \nI'm like an orphan of Guangzhou\nI'm like a superfluous orphan\nI'm like a helpless orphan\nAlone again now\n \nSafe travels my loved one\nTake care my loved one\nSafe travels the one who left\nTake care the one gone far away",
"mashup_clip_ids": [
"9f102969-0024-479e-b38f-c0c5db21383d",
"6aebb715-701c-433f-b976-a7ff5cf16255"
]
}23. 歌詞マッシュアップ:歌詞マッシュアップ
lyrics_a:歌詞セット1lyrics_b:歌詞セット2- 課金:100クレジット/リクエスト
{
"lyrics_a": "Sambuy come back bluespawn greenspawn are making you a spawn",
"lyrics_b": "You keep turning back inside the station\nI can't bring myself to leave outside\nI have an ominous feeling\nToday's farewell feels like a breakup\n \nYou disappear into the crowd\nLike a dream scattered by the wind\nGuangzhou South Station, crowds surging\nWho cares about the pain in my heart\n \nI'm like an orphan of Guangzhou\nI'm like a superfluous orphan\nI'm like a helpless orphan\nAlone again now\n \nSafe travels my loved one\nTake care my loved one\nSafe travels the one who left\nTake care the one gone far away"
}{
"lyrics_a": "Sambuy come back bluespawn greenspawn are making you a spawn",
"lyrics_b": "You keep turning back inside the station\nI can't bring myself to leave outside\nI have an ominous feeling\nToday's farewell feels like a breakup\n \nYou disappear into the crowd\nLike a dream scattered by the wind\nGuangzhou South Station, crowds surging\nWho cares about the pain in my heart\n \nI'm like an orphan of Guangzhou\nI'm like a superfluous orphan\nI'm like a helpless orphan\nAlone again now\n \nSafe travels my loved one\nTake care my loved one\nSafe travels the one who left\nTake care the one gone far away"
}結果:
{
"lyrics_request_id": "04edfa84-290e-4a08-bd35-73906079b26e",
"mashup_id": "1c250665-a7c9-4852-97d1-3d291ebb9565",
"response": {
"error_message": "",
"status": "complete",
"tags": [],
"text": "You keep turning back inside the station \nI can't bring myself to leave outside \nI have an ominous feeling \nToday's farewell feels like a breakup \n\nSambuy come back \nbluespawn greenspawn are making you a spawn \nSambuy come back \nbluespawn greenspawn are making you a spawn \n\nYou disappear into the crowd \nLike a dream scattered by the wind \nGuangzhou South Station, crowds surging \nWho cares about the pain in my heart \n\nSambuy come back \nbluespawn greenspawn \nare making you a spawn \n\nI'm like an orphan of Guangzhou \nI'm like a superfluous orphan \nI'm like a helpless orphan \nAlone again now \n\nSafe travels my loved one \nTake care my loved one \nSafe travels the one who left \nTake care the one gone far away \n\nSambuy come back \nbluespawn greenspawn are making you a spawn \nSambuy don't go \nbluespawn greenspawn are making you a spawn",
"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": "You keep turning back inside the station \nI can't bring myself to leave outside \nI have an ominous feeling \nToday's farewell feels like a breakup \n\nSambuy come back \nbluespawn greenspawn are making you a spawn \nSambuy come back \nbluespawn greenspawn are making you a spawn \n\nYou disappear into the crowd \nLike a dream scattered by the wind \nGuangzhou South Station, crowds surging \nWho cares about the pain in my heart \n\nSambuy come back \nbluespawn greenspawn \nare making you a spawn \n\nI'm like an orphan of Guangzhou \nI'm like a superfluous orphan \nI'm like a helpless orphan \nAlone again now \n\nSafe travels my loved one \nTake care my loved one \nSafe travels the one who left \nTake care the one gone far away \n\nSambuy come back \nbluespawn greenspawn are making you a spawn \nSambuy don't go \nbluespawn greenspawn are making you a spawn",
"title": "Lyrics Mashup"
}
}24. サンプル:サンプルベースの曲生成
A. 音楽の生成
- シナリオ1、2、または3を使用して音楽を生成し、1つの曲の
clip_id(値0fa07665-6b8e-4a8b-8bd3-7e0cfcdada88)を取得します - または、アップロードAPIを介して
clip_idを取得します
B. サンプルの生成
taskはchop_sample_conditionである必要がありますchop_sample_clip_idはステップAのclip_idですchop_sample_start_s:サンプル開始時間chop_sample_end_s:サンプル終了時間- 課金:1曲生成の基本コスト
- クロスアカウント可
{
"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. サウンド:サウンドタスク
taskタイプはsoundですmvは現在chirp-crowのみをサポートします- パラメータは
tagsに配置されます。例:loop、BPM 60はtempo: 60、G#はkey: G#になります - 課金:1曲生成の基本コスト
{
"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. インスポ:インスピレーション作成
taskタイプはplaylist_conditionまたはvox_playlist_conditionですplaylist_idはinspirationですplaylist_clip_idsは参照曲のclip_id値で、最大4曲を選択できます- クロスアカウント不可、
playlist_clip_idsのclip_id値は同じアカウントからである必要があります playlist_clip_idsを1つのアカウント下に統一するには、「指定clip_id」アップロードを使用しますtaskがvox_playlist_conditionの場合、persona_idは空ではいけません- 課金:1曲生成の基本コスト
{
"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"
]
}taskタイプがvox_playlist_conditionの場合
{
"task": "vox_playlist_condition",
"generation_type": "TEXT",
"title": "Wind and Rain",
"tags": "dark orchestral, heavy dense percussion, suspenseful, intense, dynamic tempo, brass, strings, synths, D minor, 120 BPM, massive soundstage, no distortion",
"mv": "chirp-fenix",
"prompt": "[Verse 1]\nWater marks still on the windowsill\nYou left and I never wiped them dry\nI kept the umbrella by the door\nLike words taken back halfway\n\nThe tree on the corner keeps swaying\nLeaves answer for me first\nIf you're also on the road\nWould you look up at me?\n\n[Pre-Chorus]\nWind blows old letters open\nRain soaks the names\nI stand in place\nListening to thoughts drip one by one\n\n[Chorus]\nWind and rain, wind and rain\nBoth searching for you\nWind and rain, wind and rain\nTurning silence into memory\nIf you turn back and see me\nDon't hide in the past again\nWind and rain, wind and rain\nI'm still here",
"make_instrumental": false,
"metadata": {
"create_mode": "custom"
},
"persona_id": "eaa7f82b-c617-4f1f-a5ec-5ce241b8845a",
"playlist_clip_ids": [
"b5af4274-52f9-44c7-b1a7-0fad16da7649",
"bf6cb6a3-b71a-4680-8a1c-87361036b7b4"
]
}{
"task": "vox_playlist_condition",
"generation_type": "TEXT",
"title": "Wind and Rain",
"tags": "dark orchestral, heavy dense percussion, suspenseful, intense, dynamic tempo, brass, strings, synths, D minor, 120 BPM, massive soundstage, no distortion",
"mv": "chirp-fenix",
"prompt": "[Verse 1]\nWater marks still on the windowsill\nYou left and I never wiped them dry\nI kept the umbrella by the door\nLike words taken back halfway\n\nThe tree on the corner keeps swaying\nLeaves answer for me first\nIf you're also on the road\nWould you look up at me?\n\n[Pre-Chorus]\nWind blows old letters open\nRain soaks the names\nI stand in place\nListening to thoughts drip one by one\n\n[Chorus]\nWind and rain, wind and rain\nBoth searching for you\nWind and rain, wind and rain\nTurning silence into memory\nIf you turn back and see me\nDon't hide in the past again\nWind and rain, wind and rain\nI'm still here",
"make_instrumental": false,
"metadata": {
"create_mode": "custom"
},
"persona_id": "eaa7f82b-c617-4f1f-a5ec-5ce241b8845a",
"playlist_clip_ids": [
"b5af4274-52f9-44c7-b1a7-0fad16da7649",
"bf6cb6a3-b71a-4680-8a1c-87361036b7b4"
]
}27. ボイス:ボイスクローニング
- ボイスクローニングは本質的に個人の音声ライブラリ(ペルソナ)を作成し、それを使用して曲を生成します
- ペルソナにはユーザーの声を含む1つのオーディオファイルのみが必要で、テキストまたは歌詞が含まれている必要があります
- 二次検証不要
A. ペルソナの生成
- 二次検証不要
- 課金:500クレジット/リクエスト
singer_skill_levelオプション:AdvancedIntermediateBeginnerProfessionalurlユーザーの録音、テキストを読むか歌う必要があります、サポート形式mp3wav
{
"url": "http://cos.aitutu.cc/mp4/ru-user-voice.mp3",
"singer_skill_level": "Intermediate",
"name": "mytitle",
"vocal_end_s": 120,
"vocal_start_s": 0
}{
"url": "http://cos.aitutu.cc/mp4/ru-user-voice.mp3",
"singer_skill_level": "Intermediate",
"name": "mytitle",
"vocal_end_s": 120,
"vocal_start_s": 0
}idをpersona_idとして返します
{
"id": "5d8772c3-f901-48b4-a966-96e360930351",
"name": "mytitle",
"description": "",
"image_s3_id": "https://cdn1.suno.ai/d41a1c49.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": 120,
"vocal_clip_id": "60c14c78-3aec-436e-b0bf-c8007c2653e9"
}{
"id": "5d8772c3-f901-48b4-a966-96e360930351",
"name": "mytitle",
"description": "",
"image_s3_id": "https://cdn1.suno.ai/d41a1c49.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": 120,
"vocal_clip_id": "60c14c78-3aec-436e-b0bf-c8007c2653e9"
}B. persona_idを使用して音楽を生成
- ステップAから取得した
persona_id - クロスアカウント不可
{
"task": "vox",
"generation_type": "TEXT",
"title": "New Year",
"tags": "",
"negative_tags": "",
"mv": "chirp-fenix",
"prompt": "[Verse 1]\nRed paper on the old door frame\nSteam rising white from the pot\nMessages pouring into my phone\n'Coming back?' just like before, so eager\n\n[Chorus]\nHappy New Year joy all around\nRed lanterns hanging bright downtown\nFamily reunion happiness blooms\nWishes coming true blessings abound\nHappy New Year\n\n[Verse 2]\nSpring breeze gently blowing in\nBringing lucky flowers to bloom\nNew clothes new shoes new hopes\nDreams unfold from this room",
"make_instrumental": false,
"metadata": {
"create_mode": "custom"
},
"persona_id": "5d8772c3-f901-48b4-a966-96e360930351"
}{
"task": "vox",
"generation_type": "TEXT",
"title": "New Year",
"tags": "",
"negative_tags": "",
"mv": "chirp-fenix",
"prompt": "[Verse 1]\nRed paper on the old door frame\nSteam rising white from the pot\nMessages pouring into my phone\n'Coming back?' just like before, so eager\n\n[Chorus]\nHappy New Year joy all around\nRed lanterns hanging bright downtown\nFamily reunion happiness blooms\nWishes coming true blessings abound\nHappy New Year\n\n[Verse 2]\nSpring breeze gently blowing in\nBringing lucky flowers to bloom\nNew clothes new shoes new hopes\nDreams unfold from this room",
"make_instrumental": false,
"metadata": {
"create_mode": "custom"
},
"persona_id": "5d8772c3-f901-48b4-a966-96e360930351"
}27. ボイス:ボイスクローニング - 二次検証が必要
- ボイスクローニングは本質的に個人の音声ライブラリ(ペルソナ)を作成し、それを使用して曲を生成します
- ペルソナには2つのオーディオファイルが必要:1つはユーザーの声、もう1つは検証音声
- 検証:テキストを読んで音声を登録します
A. 曲のアップロード
{
"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
}- 返される値:
{
"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. サンプル文の取得
languageオプション:zhenesfrptdejakohiruvoice_recording_idはステップAの返り値から- クロスアカウント不可
- 課金:100クレジット/リクエスト
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"
}
'- ボディ:
{
"language": "zh",
"voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768"
}{
"language": "zh",
"voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768"
}phrase_id文のIDを次のステップ用に返します(1回のみ使用可能)
{
"phrase_id": "45d639aa-ad8a-41cd-a356-f81207491d3a",
"phrase_text": "轻快的歌声在空气中自由飘扬"
}{
"phrase_id": "45d639aa-ad8a-41cd-a356-f81207491d3a",
"phrase_text": "轻快的歌声在空气中自由飘扬"
}C. 音声検証
urlユーザーの録音、phrase_textからのテキストを録音してURLとしてアップロードするようユーザーに依頼します、サポート形式mp3wavvoice_recording_idはステップAの返り値からphrase_idはステップBの返り値から- クロスアカウント不可
- 注:このリクエストは1回のみ使用できます。失敗した場合は、新しい
phraseを取得する必要があります - 課金:100クレジット/リクエスト
{
"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として返します
{
"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. ペルソナの作成
vox_audio_idはステップAの返り値からvoice_recording_idはステップAの返り値からverification_idはステップCの返り値からsinger_skill_levelオプション:AdvancedIntermediateBeginnerProfessionalimage_s3_idは画像のbase64形式である必要があります- 注:
is_publicがtrueまたはfalseに関わらず、自動的にfalseに設定されます is_publicがfalseの場合、作成されたpersona_idはクロスアカウントで使用できません- クロスアカウント不可
- 課金:100クレジット/リクエスト
{
"name": "mytitle",
"description": "god",
"image_s3_id": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/ base64 image....",
"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 image....",
"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として返します
{
"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を使用して音楽を生成
- ステップDから取得した
persona_id - クロスアカウント不可
{
"task": "vox",
"generation_type": "TEXT",
"title": "New Year",
"tags": "",
"negative_tags": "",
"mv": "chirp-fenix",
"prompt": "[Verse 1]\nRed paper on the old door frame\nSteam rising white from the pot\nMessages pouring into my phone\n'Coming back?' just like before, so eager",
"make_instrumental": false,
"metadata": {
"create_mode": "custom"
},
"persona_id": "dde0be60-5280-4bd2-89a0-4020ddd3db52"
}{
"task": "vox",
"generation_type": "TEXT",
"title": "New Year",
"tags": "",
"negative_tags": "",
"mv": "chirp-fenix",
"prompt": "[Verse 1]\nRed paper on the old door frame\nSteam rising white from the pot\nMessages pouring into my phone\n'Coming back?' just like before, so eager",
"make_instrumental": false,
"metadata": {
"create_mode": "custom"
},
"persona_id": "dde0be60-5280-4bd2-89a0-4020ddd3db52"
}28. カスタムモデル:カスタムモデル
- 2026.03.28 Sunoは
custom-modelを導入しました - 少なくとも6曲の自分の曲をアップロードして、カスタムモデルを構築します
- 制限:1つのアカウントで3つのモデルのみ構築できます
A. 音楽のアップロード
- ボディ:
{
"url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}{
"url": "http://cdnimg.exbapp.com/ai/2024-06-18/d416d9c3c34eb22c7d8c094831d8dbd0.mp3"
}まず、アップロードAPIを介してclip_id値
7173c086-844d-4b9e-9cee-e771f7ded3ebを取得します2回目のアップロードから、1つのアカウント下に統一するためにclip_idを含める必要があります
2回目以降のアップロード用のボディ:
{
"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. カスタムモデルの作成
clip_idsはアップロードした曲のclip_id値で、同じアカウント下にある必要があります、少なくとも6つのアップロード、最適には24- 課金:10×曲生成コスト
- ボディ:
{
"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"
],
"name": "Your Model 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"
],
"name": "Your Model Name"
}idをmodel_idとして返します
{
"id": "3f788ae1-4646-4d20-aa76-c33035bf12e6",
"status": "pending"
}{
"id": "3f788ae1-4646-4d20-aa76-c33035bf12e6",
"status": "pending"
}C. カスタムモデルタスクのクエリ
get https://api.openai-hk.com/suno/custom-model/feed/{model_id}
model_idは上記から返されたidです- 成功時の返り値:
{
"id": "3f788ae1-4646-4d20-aa76-c33035bf12e6",
"status": "complete"
}{
"id": "3f788ae1-4646-4d20-aa76-c33035bf12e6",
"status": "complete"
}D. カスタムモデルの使用
mvはchirp-custom:{model_id}、つまりchirp-custom:3f788ae1-4646-4d20-aa76-c33035bf12e6です- クロスアカウントはサポートされていません、
model_idに基づいてアカウントをクエリします - ボディ:
{
"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",
"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",
"metadata": {
"create_mode": "custom"
}
}29. スピード:速度変更
- 作成またはアップロードを通じてclip_idを取得します
A. 速度変更の作成
speed_multiplierは速度倍率、値の範囲0.25~4.0keep_pitchがtrueの場合はピッチを維持、falseの場合はピッチを変更しますtitleは速度変更後のタイトルです
curl --request POST \
--url https://api.openai-hk.com/suno/act/speed/6718cf1e-fa9f-433f-b859-a71f994cd3b8 \
--header 'Accept: */*' \
--header 'Authorization: Bearer hk-your-key' \
--header 'Content-Type: application/json' \
--data '{
"speed_multiplier": 0.9439,
"keep_pitch": false,
"title": "Good News (0.94x)"
}'curl --request POST \
--url https://api.openai-hk.com/suno/act/speed/6718cf1e-fa9f-433f-b859-a71f994cd3b8 \
--header 'Accept: */*' \
--header 'Authorization: Bearer hk-your-key' \
--header 'Content-Type: application/json' \
--data '{
"speed_multiplier": 0.9439,
"keep_pitch": false,
"title": "Good News (0.94x)"
}'後でクエリするための新しいclip_idとしてidを返します:
{
"id": "01a4c72b-db63-4be2-a0db-008fe0f105a4",
"status": "processing",
"title": "Good News (0.94x)",
"play_count": 0,
"upvote_count": 0
}{
"id": "01a4c72b-db63-4be2-a0db-008fe0f105a4",
"status": "processing",
"title": "Good News (0.94x)",
"play_count": 0,
"upvote_count": 0
}B. 速度変更のクエリ
curl --request GET \
--url https://api.openai-hk.com/suno/feed/01a4c72b-db63-4be2-a0db-008fe0f105a4 \
--header 'Accept: */*' \
--header 'Authorization: Bearer hk-your-key'curl --request GET \
--url https://api.openai-hk.com/suno/feed/01a4c72b-db63-4be2-a0db-008fe0f105a4 \
--header 'Accept: */*' \
--header 'Authorization: Bearer hk-your-key'30. ステムの追加:楽器の追加
{
"task": "stem_condition",
"generation_type": "TEXT",
"title": "Good News",
"tags": "Pop with bright four-on-the-floor drums",
"negative_tags": "",
"mv": "chirp-fenix",
"prompt": "[Verse 1]\nI got a note in my hand",
"make_instrumental": false,
"metadata": {
"create_mode": "custom",
"is_remix": true
},
"stem_condition_clip_id": "d4b0af45-c974-4197-abdf-d51f6619ab6d",
"stem_control_tags": "add Drums",
"batch_size": 2
}{
"task": "stem_condition",
"generation_type": "TEXT",
"title": "Good News",
"tags": "Pop with bright four-on-the-floor drums",
"negative_tags": "",
"mv": "chirp-fenix",
"prompt": "[Verse 1]\nI got a note in my hand",
"make_instrumental": false,
"metadata": {
"create_mode": "custom",
"is_remix": true
},
"stem_condition_clip_id": "d4b0af45-c974-4197-abdf-d51f6619ab6d",
"stem_control_tags": "add Drums",
"batch_size": 2
}クロスアカウント可
パラメータの注意事項:
- インストゥルメンタル音楽の場合、
make_instrumentalはtrueである必要があります taskはstem_conditionである必要がありますstem_condition_clip_idはアップロードされたまたは通常のSuno生成されたclip_idですstem_control_tagsはadd Strings、またadd Drumsadd Bassなど、suno-studioを参照してくださいbatch_sizeは2です
- インストゥルメンタル音楽の場合、
課金:Sunoのstem_conditionに対するリスク管理により基本コストの1.2倍
標準の作成API データを返します
{
"id": "8fb0a232-aef3-4f8a-82ad-72a3fde0bcc6",
"clips": [
{
"id": "clipsId1"
},
{
"id": "clipsId2"
}
]
}{
"id": "8fb0a232-aef3-4f8a-82ad-72a3fde0bcc6",
"clips": [
{
"id": "clipsId1"
},
{
"id": "clipsId2"
}
]
}31. ステムとMIDIの抽出:ステムとMIDIの抽出
- クロスアカウント不可
- パラメータの注意事項:
taskはgen_stemである必要がありますstem_taskはextractである必要がありますstem_type_idは91である必要がありますstem_type_group_nameとstem_nameは同じ値を持ちます、参照値:Lead VocalDrum KitKickSnareRisersBassBacking VocalsPianoElectric GuitarPercussionString SectionSynthAcoustic GuitarSound EffectsSynth PadSynth BassGuitarBrass SectionOrganElectronic Drum KitLead Electric GuitarSynth KeysRhythm Electric GuitarElectric PianoUpright BassKeyboardsDistorted Electric GuitarSynth StringsSynth LeadWoodwindsRhythm Acoustic GuitarFluteHarpTambourineTrumpetArpeggiatorAccordionFiddlePedal Steel GuitarSynth VoiceViolinDigital PianoSynth BrassMandolinChoirBanjoBellsClarinetTenor SaxophoneTromboneShakerFrench HornGlockenspielElectric BassCelloTimpaniHarmonicaMarimbaVibraphoneLap Steel GuitarSaxophoneOrchestraHornsCymbalsHand ClapOboeCelestaCongasDroneAlto SaxophoneDouble BassUkuleleHarpsichordBaritone SaxophoneXylophoneTubaBass GuitarWhistleLead GuitarRhodes808BongosBassoonCowbellViolaSitarSteel DrumsPiccoloThereminBagpipesHi-HatMusic BoxMelodicaTablaKotoDjembeTaikoDidgeridoo
- 課金:1×基本コスト
{
"task": "gen_stem",
"generation_type": "TEXT",
"title": "my title",
"tags": "pop",
"negative_tags": "",
"mv": "chirp-v3-0",
"prompt": "",
"make_instrumental": true,
"metadata": {
"create_mode": "custom",
"is_remix": true
},
"continue_clip_id": "fcd7be5e-f907-4fce-a47f-f0784a139be3",
"stem_type_id": 91,
"stem_type_group_name": "Piano",
"stem_task": "extract",
"stem_name": "Piano"
}{
"task": "gen_stem",
"generation_type": "TEXT",
"title": "my title",
"tags": "pop",
"negative_tags": "",
"mv": "chirp-v3-0",
"prompt": "",
"make_instrumental": true,
"metadata": {
"create_mode": "custom",
"is_remix": true
},
"continue_clip_id": "fcd7be5e-f907-4fce-a47f-f0784a139be3",
"stem_type_id": 91,
"stem_type_group_name": "Piano",
"stem_task": "extract",
"stem_name": "Piano"
}- 4つのclip_idを返します
- これらの4つのclip_idを使用してMIDIを取得します。18. MIDIの取得を参照してください
32. Durationパラメータ
durationは10~360秒です- v5.5+でのみサポート、
mvはchirp-fenixである必要があります
{
"generation_type": "TEXT",
"title": "Good news",
"tags": "syncopated basslines, modal",
"negative_tags": "",
"mv": "chirp-fenix",
"prompt": "[Verse]\nSunrise creepin\nGold on the floor",
"make_instrumental": false,
"metadata": {
"create_mode": "custom"
},
"duration": 330
}{
"generation_type": "TEXT",
"title": "Good news",
"tags": "syncopated basslines, modal",
"negative_tags": "",
"mv": "chirp-fenix",
"prompt": "[Verse]\nSunrise creepin\nGold on the floor",
"make_instrumental": false,
"metadata": {
"create_mode": "custom"
},
"duration": 330
}33. Nice Upload
- アップロードした曲の著作権問題を解決するために、nice upload APIを使用できます
- アップロード後、アカウントの有効期限を心配することなく、クロスアカウントでカバー/リミックスできます
- 所要時間:2分以上かかります、非同期タスクとして実装されます
- 課金:10,000クレジット/リクエスト
- 短い長さの方が成功率が高くなります
- 生成されたclip_idは現在以下をサポートします:
- カバー クロスアカウント可
- ステムとMIDIの抽出 クロスアカウント不可
- フルトラック分離 クロスアカウント不可
- ボーカル/インストゥルメンタル分離 クロスアカウント不可
- サンプル クロスアカウント可
- マッシュアップ クロスアカウント可
A. アップロードタスクの作成
name曲名、必須url曲のリンク、必須
curl --request POST \
--url https://api.openai-hk.com/suno/uploads/nice \
--header 'Authorization: Bearer hk-your-key' \
--header 'Content-Type: application/json' \
--data '{
"url": "https://myfile.aibeke.com/dong-feng-po.mp3",
"name":"Dong Feng Po"
} 'curl --request POST \
--url https://api.openai-hk.com/suno/uploads/nice \
--header 'Authorization: Bearer hk-your-key' \
--header 'Content-Type: application/json' \
--data '{
"url": "https://myfile.aibeke.com/dong-feng-po.mp3",
"name":"Dong Feng Po"
} '- 返り値:
{
"clip_id": "",
"id": "hkfc3337-8e41-4d30-9fd9-55bfe352876c",
"message": "",
"status": "submitted"
}{
"clip_id": "",
"id": "hkfc3337-8e41-4d30-9fd9-55bfe352876c",
"message": "",
"status": "submitted"
}B. アップロードタスクのステータス取得
curl --request GET \
--url https://api.openai-hk.com/suno/uploads/nice/hkfc3337-8e41-4d30-9fd9-55bfe352876c \
--header 'Authorization: Bearer hk-your-key'curl --request GET \
--url https://api.openai-hk.com/suno/uploads/nice/hkfc3337-8e41-4d30-9fd9-55bfe352876c \
--header 'Authorization: Bearer hk-your-key'- 成功レスポンス:
clip_idはSunoの曲IDです
{
"id": "hkfc3337-8e41-4d30-9fd9-55bfe352876c",
"status": "complete",
"clip_id": "e5021b7a-6f9f-4eed-8690-448126593d1f",
"message": ""
}{
"id": "hkfc3337-8e41-4d30-9fd9-55bfe352876c",
"status": "complete",
"clip_id": "e5021b7a-6f9f-4eed-8690-448126593d1f",
"message": ""
}- 失敗レスポンス:
{
"id": "hkfc3337-8e41-4d30-9fd9-55bfe352876c",
"status": "error",
"clip_id": "",
"message": "Song download failed: HTTP Error 404: Not Found"
}{
"id": "hkfc3337-8e41-4d30-9fd9-55bfe352876c",
"status": "error",
"clip_id": "",
"message": "Song download failed: HTTP Error 404: Not Found"
}C. clip_idを使用してカバー/リミックス
cover_clip_idはカバーするclip_idですprompt歌詞は中国語からピンインへの変換が必要です、そうしないと著作権の問題が発生する可能性がありますtagsは異なるスタイルを制御できます- ペイロード:
{
"prompt": "[Intro]\n[arpeggiated clean electric guitar riff, piano chords]\n\n[Verse 1]\n[breathy male vocals]\nyī zhǎn lí chóu gū dān zhù lì zài chuāng kǒu\nwǒ zài mén hòu jiǎ zhuāng nǐ rén hái méi zǒu\njiù dì rú zhòng yóu yuè yuán gèng jì mò\nyè bàn qīng xǐng de zhú huǒ bù rěn kē zé wǒ\nyī hú piāo pō làng jī tiān yá nán rù hóu\nnǐ zǒu zhī hòu jiǔ nuǎn huí yì sī niàn shòu\nshuǐ xiàng dōng liú shí jiān zěn me tōu\nhuā kāi jiù yī cì chéng shú wǒ què cuò guò\n\n[Chorus]\n[drums and bass enter, full band arrangement]\nshuí zài yòng pí pá dàn zòu yī qū dōng fēng pò\nfēng yè jiāng gù shì rǎn sè jié jú wǒ kàn tòu\nlí bā wài de gǔ dào wǒ qiān zhù nǐ zǒu guò\nhuāng yān màn cǎo de nián tóu jiù lián fēn shǒu dōu hěn shěn mò\nshuí zài yòng pí pá dàn zòu yī qū dōng fēng pò\nfēng yè jiāng gù shì rǎn sè jié jú wǒ kàn tòu\nlí bā wài de gǔ dào wǒ qiān zhù nǐ zǒu guò\nhuāng yān màn cǎo de nián tóu jiù lián fēn shǒu dōu hěn shěn mò",
"generation_type": "TEXT",
"tags": "rock, punk",
"negative_tags": "",
"mv": "chirp-fenix",
"title": "My Dong Feng Po",
"continue_clip_id": null,
"continue_at": null,
"continued_aligned_prompt": null,
"infill_start_s": null,
"infill_end_s": null,
"task": "cover",
"cover_clip_id": "e5021b7a-6f9f-4eed-8690-448126593d1f"
}{
"prompt": "[Intro]\n[arpeggiated clean electric guitar riff, piano chords]\n\n[Verse 1]\n[breathy male vocals]\nyī zhǎn lí chóu gū dān zhù lì zài chuāng kǒu\nwǒ zài mén hòu jiǎ zhuāng nǐ rén hái méi zǒu\njiù dì rú zhòng yóu yuè yuán gèng jì mò\nyè bàn qīng xǐng de zhú huǒ bù rěn kē zé wǒ\nyī hú piāo pō làng jī tiān yá nán rù hóu\nnǐ zǒu zhī hòu jiǔ nuǎn huí yì sī niàn shòu\nshuǐ xiàng dōng liú shí jiān zěn me tōu\nhuā kāi jiù yī cì chéng shú wǒ què cuò guò\n\n[Chorus]\n[drums and bass enter, full band arrangement]\nshuí zài yòng pí pá dàn zòu yī qū dōng fēng pò\nfēng yè jiāng gù shì rǎn sè jié jú wǒ kàn tòu\nlí bā wài de gǔ dào wǒ qiān zhù nǐ zǒu guò\nhuāng yān màn cǎo de nián tóu jiù lián fēn shǒu dōu hěn shěn mò\nshuí zài yòng pí pá dàn zòu yī qū dōng fēng pò\nfēng yè jiāng gù shì rǎn sè jié jú wǒ kàn tòu\nlí bā wài de gǔ dào wǒ qiān zhù nǐ zǒu guò\nhuāng yān màn cǎo de nián tóu jiù lián fēn shǒu dōu hěn shěn mò",
"generation_type": "TEXT",
"tags": "rock, punk",
"negative_tags": "",
"mv": "chirp-fenix",
"title": "My Dong Feng Po",
"continue_clip_id": null,
"continue_at": null,
"continued_aligned_prompt": null,
"infill_start_s": null,
"infill_end_s": null,
"task": "cover",
"cover_clip_id": "e5021b7a-6f9f-4eed-8690-448126593d1f"
}
OpenAi-HK