curl --request POST \
--url https://toapis.com/v1/music/generations/generation \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "suno",
"gpt_description": "雨の夜のカフェに合う lo-fi ジャズ",
"instrumental": false,
"version": "v6"
}'
import requests
resp = requests.post(
"https://toapis.com/v1/music/generations/generation",
headers={"Authorization": "Bearer <token>"},
json={
"model": "suno",
"custom": True,
"prompt": "[Verse]\nネオンが灯る\n[Chorus]\n夜明けまで駆け抜ける",
"title": "ネオンライド",
"style": "synthwave",
"max_mode": True
}
)
print(resp.json())
const resp = await fetch("https://toapis.com/v1/music/generations/generation", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "suno",
gpt_description: "dreamy synthwave with female vocals",
version: "v6-wild"
})
});
console.log(await resp.json());
{
"task_id": "<string>",
"status": "<string>"
}Suno 音楽
音楽生成
Suno 音楽生成。インスピレーション/カスタム歌詞モード、Max ティア対応
POST
/
v1
/
music
/
generations
/
generation
curl --request POST \
--url https://toapis.com/v1/music/generations/generation \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "suno",
"gpt_description": "雨の夜のカフェに合う lo-fi ジャズ",
"instrumental": false,
"version": "v6"
}'
import requests
resp = requests.post(
"https://toapis.com/v1/music/generations/generation",
headers={"Authorization": "Bearer <token>"},
json={
"model": "suno",
"custom": True,
"prompt": "[Verse]\nネオンが灯る\n[Chorus]\n夜明けまで駆け抜ける",
"title": "ネオンライド",
"style": "synthwave",
"max_mode": True
}
)
print(resp.json())
const resp = await fetch("https://toapis.com/v1/music/generations/generation", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "suno",
gpt_description: "dreamy synthwave with female vocals",
version: "v6-wild"
})
});
console.log(await resp.json());
{
"task_id": "<string>",
"status": "<string>"
}- テキスト説明またはカスタム歌詞から楽曲を生成(1回につき2候補)
- 非同期タスク。タスク ID で結果をポーリング
customがpromptの意味を決定:カスタム歌詞 vs インスピレーション説明
Authorizations
string
必須
Bearer Token。API Key:API Key 管理ページ
Body
string
必須
固定値
"suno"boolean
モード切替。デフォルト
falsefalse:インスピレーションモード —gpt_description(またはprompt)に楽曲の説明true:カスタム歌詞モード —promptが歌詞本文、title/style/negative_tagsが有効
string
インスピレーションモードの楽曲説明。例:
"雨の夜のカフェに合う lo-fi"。カスタムモードでは不要string
カスタムモードの歌詞本文(
[Verse]/[Chorus] 構造タグ対応)string
曲タイトル(カスタムモード)
string
スタイルタグ(カスタムモード)。例:
"dreamy synthwave, female vocal"string
避けたい要素(カスタムモード)
boolean
インストゥルメンタル生成
string
エンジン版:
v6 / v6-wild / v6-miniboolean
Max 品質ティア(2倍料金 $0.10)。
custom=true が必要string
作成済みペルソナ ID。
custom_model_id と排他string
カスタム学習モデル ID。
version・persona_id と排他オプションの調整パラメータ
style_weight、weirdness、audio_weight、vocal_gender、auto_lyrics、variety はすべて省略可(省略時は上流の既定値)。
Response
string
submitted / queued / in_progressresult.music[] に 2 候補が返り、各 audio_url、image_url、title、tags、lyrics、duration を含みます。メディア URL は CDN にミラー済みです。
curl --request POST \
--url https://toapis.com/v1/music/generations/generation \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "suno",
"gpt_description": "雨の夜のカフェに合う lo-fi ジャズ",
"instrumental": false,
"version": "v6"
}'
import requests
resp = requests.post(
"https://toapis.com/v1/music/generations/generation",
headers={"Authorization": "Bearer <token>"},
json={
"model": "suno",
"custom": True,
"prompt": "[Verse]\nネオンが灯る\n[Chorus]\n夜明けまで駆け抜ける",
"title": "ネオンライド",
"style": "synthwave",
"max_mode": True
}
)
print(resp.json())
const resp = await fetch("https://toapis.com/v1/music/generations/generation", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "suno",
gpt_description: "dreamy synthwave with female vocals",
version: "v6-wild"
})
});
console.log(await resp.json());