Suno 音楽生成

承認

Authorization

string

header

必須

##すべてのAPIにBearer Token認証が必要です##

APIキーの取得：

APIキー管理ページにアクセスしてAPIキーを取得してください

リクエストヘッダーに追加：

Authorization: Bearer YOUR_API_KEY

ボディ

application/json

model

enum<string>

必須

モデル名

利用可能なオプション：

suno-v4：V4バージョン、ボーカル品質向上、最大4分、プロンプト最大3000文字、スタイル最大200文字
suno-v4.5：V4.5バージョン（推奨）、よりスマートなプロンプト、高速生成、最大8分、プロンプト最大5000文字、スタイル最大1000文字
suno-v4.5plus：V4.5+強化バージョン、より豊かな音色、新しいクリエイティブ手法、最大8分、プロンプト最大5000文字、スタイル最大1000文字
suno-v4.5all：V4.5フル機能バージョン、よりスマートなプロンプト、高速生成、最大8分、プロンプト最大5000文字、スタイル最大1000文字
suno-v5：V5最新バージョン、優れた音楽表現力、高速生成、プロンプト最大5000文字、スタイル最大1000文字

利用可能なオプション:

suno-v4,

suno-v4.5,

suno-v4.5plus,

suno-v4.5all,

suno-v5

例:

"suno-v4.5"

custom_mode

boolean

必須

カスタムモードを有効化

説明：

false：シンプルモード、promptのみ提供、AIが歌詞とスタイルを自動生成
true：カスタムモード、style、title、歌詞などを細かく制御可能

カスタムモードの必須パラメータ：

style：必須
title：必須
prompt：instrumental=falseの場合は必須（歌詞として使用）

例:

false

instrumental

boolean

必須

インストゥルメンタル音楽を生成（ボーカルなし）

説明：

false：ボーカル付き音楽を生成
true：ボーカルなしのインストゥルメンタル/BGMを生成

注意：

非カスタムモードでは、このパラメータは必須フィールドに影響しません
カスタムモードでtrueに設定すると、promptはオプションになります

例:

false

prompt

string

希望する音楽内容を説明するプロンプト

非カスタムモード（custom_mode=false）：

必須、音楽の説明として使用、AIが歌詞とスタイルを自動生成
最大文字数：500文字

カスタムモード（custom_mode=true）：

instrumental=falseの場合に必須、正確な歌詞として使用
instrumental=trueの場合は任意
最大文字数：V4は3000文字、V4.5+は5000文字

歌詞フォーマットの提案：

[Verse]、[Chorus]、[Bridge]などのタグを使用して歌詞構造を整理してください

例:

"A cheerful summer pop song about road trips and freedom"

style

string

音楽スタイルの指定

説明：

カスタムモード（custom_mode=true）で必須
音楽のジャンル、ムード、またはアーティスティックな方向性を定義
英語のカンマ区切りタグの使用を推奨

文字数制限：

V4：最大200文字
V4.5+：最大1000文字

一般的なスタイルタグ：

ジャンル：pop, rock, jazz, classical, electronic, hip-hop, r&b, country, folk
ムード：happy, sad, energetic, calm, romantic, dark, uplifting
楽器：piano, guitar, drums, bass, violin, saxophone, synthesizer
ボーカル：male vocals, female vocals, choir, harmonies
テンポ：slow, fast, upbeat, groovy, 120bpm

例:

"pop, electronic, upbeat, female vocals"

title

string

曲名

説明:

カスタムモード（custom_mode=true）で必須
プレーヤーインターフェースとファイル名に表示されます
最大長: 80 文字

Maximum string length: 80

例:

"Summer Dreams"

negative_tags

string

除外スタイル、避けたい音楽スタイルや特徴を指定

例：

heavy metal, screaming, sad
rap, fast tempo

例:

"heavy metal, screaming"

vocal_gender

enum<string>

ボーカルの性別設定

オプション:

m: 男性ボイス
f: 女性ボイス

注意:

custom_mode=true の場合のみ有効
このパラメータは確率を上げるだけで、指定された性別に従うことを保証するものではありません

利用可能なオプション:

m,

f

例:

"f"

style_weight

number

スタイルの重み、指定されたスタイルへの忠実度を制御

範囲: 0.0 ~ 1.0、小数点第1位

説明:

値が高いほど指定されたスタイルにより忠実になります
0 の値は未設定として扱われます

必須範囲: 0 <= x <= 1

例:

0.7

weirdness_constraint

number

奇抜さの制約、出力の創造性/実験性の度合いを制御

範囲: 0.0 ~ 1.0、小数点第1位

説明:

値が高いほどより創造的で実験的な出力になります
値が低いほどより伝統的で保守的な出力になります
0 の値は未設定として扱われます

必須範囲: 0 <= x <= 1

例:

0.3

audio_weight

number

音声の重み、音声特徴の重みを制御

範囲：0.0〜1.0、小数点以下1桁

説明：

値が0の場合は未設定として扱われます

必須範囲: 0 <= x <= 1

例:

0.5

callback_url

string<uri>

タスク完了通知用の HTTPS コールバック URL

コールバックステージ：

コールバックプロセスには3つのステージがあります：text（テキスト生成）、first（最初のトラック完了）、complete（すべて完了）
場合によっては、text と first ステージがスキップされ、直接 complete が返されることがあります

セキュリティ制限：

HTTPS プロトコルのみサポート
内部 IP アドレスへのコールバックは禁止
URL の長さは 2048 文字以内

コールバックメカニズム：

タイムアウト：10 秒
失敗時最大 3 回リトライ
コールバック URL が 2xx ステータスコードを返した場合は成功とみなされます

例:

"https://your-domain.com/webhooks/suno-callback"

レスポンス

音楽タスクの作成に成功しました

created

integer

タスク作成タイムスタンプ

例:

1766319090

string

タスク ID、タスクのステータスと結果を照会するために使用

例:

"task-unified-1766319089-oqs9cue4"

model

string

使用された実際のモデル名

例:

"suno-v5"

object

enum<string>

タスクタイプ

利用可能なオプション:

audio.generation.task

progress

integer

タスク進捗率（0-100）

必須範囲: 0 <= x <= 100

例:

100

result_data

object[]

生成された音楽詳細配列、タスク完了時に返却

表示子属性

results

string<uri>[]

生成された音声URL配列、タスク完了時に返却

例:

[
  "https://media.evolink.ai/xxx.mp3",
  "https://media.evolink.ai/yyy.mp3"
]

status

enum<string>

タスクステータス

利用可能なオプション:

pending,

processing,

completed,

failed

例:

"completed"

task_info

object

音声タスクの詳細

表示子属性

type

enum<string>

タスク出力タイプ

利用可能なオプション:

audio

例:

"audio"

画像シリーズ

動画シリーズ

オーディオシリーズ

テキストシリーズ

アカウント管理

タスク管理

ファイル管理

承認

ボディ

レスポンス