curl --request POST \
--url https://api.aiid.edu.kg/suno/submit/music \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "suno_music",
"upstream_model": "suno-v6",
"prompt": "Create an energetic retro-pop DJ song about the artificial intelligence revolution.",
"make_instrumental": false
}
'{
"code": "success",
"message": "",
"data": "task_xxx"
}音楽または音声生成タスクを作成する
音楽および音声生成の送信 API。旧 /suno/submit/music パスと互換性があります。タスク ID を返し、後続は /suno/fetch/{task_id} で確認します。
音楽および音声生成タスクの送信インターフェースです。upstream_model でサブモデル名を渡します。作成インターフェースは task_id を返し、その後 /suno/fetch/{task_id} で出力を照会します。
upstream_model を指定しない場合（または {"model":"suno_music"} のみを指定した場合）、既定で Suno v5.5 を使用します。旧版 Suno を引き続き使用する場合は、"upstream_model":"suno-v5" を明示的に指定してください。
利用可能なサブモデル
| タイプ | upstream_model |
|---|---|
| 音楽 | suno-v6 |
| 音楽 | suno-v5.5 |
| 音楽 | suno-v5 |
| 音楽 | lyria-3-pro |
| 音声 | seed-audio-1.0 |
| 音声 | minimax-speech-2.8-hd |
プロンプト記述モード
スタイル、感情、言語、歌手タイプ、シーンのみを記述する場合に適しており、モデルが自動的に楽曲内容を生成します。
{
"model": "suno_music",
"upstream_model": "suno-v6",
"prompt": "Create an energetic retro-pop DJ song about the artificial intelligence revolution.",
"make_instrumental": false
}
音声生成
MiniMax Speech では extraParams で音声パラメータを設定できます。
{
"model": "suno_music",
"upstream_model": "minimax-speech-2.8-hd",
"prompt": "欢迎使用新版语音生成服务。",
"extraParams": {
"voice": "moss_audio_ce44fc67-7ce3-11f0-8de5-96e35d26fb85",
"outputFormat": "mp3",
"sampleRate": 32000,
"speed": 1,
"volume": 1,
"pitch": 0
}
}
MiniMax Speech で音声パラメータが未指定の場合、サーバーは既定で上記の voice、outputFormat=mp3、sampleRate=32000、speed=1、volume=1、pitch=0 を送信します。
Lyria 3 Pro は upstream_model=lyria-3-pro を使用します：
{
"model": "suno_music",
"upstream_model": "lyria-3-pro",
"prompt": "Cinematic orchestral music with a hopeful finale."
}
インストゥルメンタルまたは純伴奏
light_music=true または make_instrumental=true を使用できます。light_music はインストゥルメンタル／BGM 寄りであることを示し、make_instrumental は歌唱ボーカルを生成しないことを示します。
{
"model": "suno_music",
"upstream_model": "minimax-music-v2.6",
"prompt": "Warm cafe background music with soft piano and strings, relaxing and cinematic.",
"light_music": true,
"make_instrumental": true
}
歌詞の詳細モード
ビジネス側で歌詞がすでに用意されており、タイトルとスタイルタグを指定する必要がある場合に適しています。custom_mode=true を渡し、lyrics を使用して歌詞を送信します。
{
"model": "suno_music",
"upstream_model": "mureka-v9",
"custom_mode": true,
"title": "Summer Sea Breeze",
"tags": "electro pop, female vocal, bright summer",
"lyrics": "[Verse]\nSea breeze moves across the white sand\n[Chorus]\nTurn the summer into a beam of light"
}
照会
作成成功後、返却された data のタスク ID を保存します。たとえば task_xxx です。GET /suno/fetch/{task_id} を呼び出して、状態、音声 URL、カバー、タイトル、歌詞、および上流から返された元のセグメント情報を照会します。
curl --request POST \
--url https://api.aiid.edu.kg/suno/submit/music \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "suno_music",
"upstream_model": "suno-v6",
"prompt": "Create an energetic retro-pop DJ song about the artificial intelligence revolution.",
"make_instrumental": false
}
'{
"code": "success",
"message": "",
"data": "task_xxx"
}承認
Bearer Token を使用して認証します。
形式: Authorization: Bearer sk-xxxxxx
ボディ
suno_music を固定で送信します。
suno_music "suno_music"
音楽や音声を説明するプロンプト。
サブモデル名（例: suno-v6 または suno-v5.5）。デフォルトは suno-v5.5。
"suno-v6"
MiniMax Speech 2.8 HD 的 voice、outputFormat、sampleRate、speed、volume、pitch 参数。
純粋な伴奏のみを生成するか。
軽音楽/バックグラウンドミュージックの方向で生成するかどうか。
インストゥルメンタル方向で生成するかどうか。
カスタムモードを使用するかどうか。
曲のタイトル。
スタイルタグ、例えば electro pop, female vocal。
歌詞の内容。