Skip to main content
POST
custom はテキストフィールドの解釈方法を制御します。custom=true(カスタムモード)では prompt に歌詞を指定し、title、style、negative_tags、auto_lyrics、persona_id が有効になります。custom=false(インスピレーションモード)では prompt にインスピレーションの説明を指定し、上記のカスタムモード用フィールドは無視されます。style_weight、weirdness_constraint、audio_weight、vocal_gender は両方のモードで検証され、有効になります。
このエンドポイントではフィールド名が一部異なり、tags ではなく style を使用します。

Authorizations

string
必須
すべてのエンドポイントは Bearer Token による認証が必要ですAPI Key の取得:API Key 管理ページ にアクセスして API Key を取得してください使用時にリクエストヘッダーに追加します:

Body

string
デフォルト:"suno"
音声モデル.現在は suno を渡します(指定しない場合はデフォルトで suno).
boolean
デフォルト:"false"
false=インスピレーションモード;true=カスタムモード(prompt を歌詞として使用).デフォルトは false.
boolean
デフォルト:"false"
true=インストゥルメンタルのみ、ボーカルなし.デフォルトは false.
string
公開バージョン:v6 / v6-wild / v6-mini。custom_model_id といずれか一方を必ず指定し、カスタムモデル使用時はこのフィールドを省略してください。
string
作成済みカスタムモデルタスクの完全な UUID。version および persona_id と同時に指定できません。このフィールドを指定すると、カスタムモデルの料金区分で課金されます。
string
インスピレーションの説明/歌詞。custom=false の場合は必須で最大 3,000 文字です。custom=true かつ instrumental=false の場合も必須で最大 5,000 文字です。カスタムのインストゥルメンタルでは省略できます。
string
カスタムモードのタイトル。最大 80 文字。custom=false(インスピレーションモード)では無視されます。
string
スタイルタグ(カスタムモード)。最大 1,000 文字。custom=false(インスピレーションモード)では無視されます。
string
負のスタイルタグ(避けたいスタイル).custom=true の場合のみ有効です.
boolean
true=入力された歌詞をもとに二次創作します.custom=true の場合のみ有効です.
string
Persona スタイル ID。custom=true の場合のみ有効で、custom_model_id と同時に指定できません。
string
ボーカルの性別:Male / Female(m / f / male / female も受け付けられ、バックエンドで自動的に正規化されます).両方のモードで有効です.
number
スタイルの重み。0.00~1.00。両方のモードで検証され、有効になります。
number
創造性スコア。0.00~1.00。両方のモードで検証され、有効になります。
number
音声の重み。0.00~1.00。両方のモードで検証され、有効になります。
string
スタイルの変化:off / normal / high / extra / max。任意で、固定の既定値はありません。
boolean
デフォルト:"false"
Max モードを有効にするかどうか。有効化には custom=true が必要で、料金は通常価格の 2 倍です。
string
出力音声形式:mp3 / m4a / wav。省略した場合はサービスの既定値が使用されます。
integer
目標生成時間は 10~360 秒です。custom=true の場合のみ使用でき、実際の完成品の長さはタスク結果に基づきます。
結果の取得:これは非同期タスクです。送信後に task_id を取得し、status が completed または failed になるまで 3~5 秒ごとに GET /v1/music/tasks/{task_id} をポーリングします(音楽生成は通常 30~120 秒かかります。処理中の status は pending または processing で、progress は 0~100 の整数ですが一定間隔で変化するとは限りません)。完了後、data.result.music[] から audio_url を取得します(image_url、video_url、title、duration なども含まれます)。失敗時は data.error.message に理由が入り、差し引かれた金額は自動返金されます。

Response

integer
レスポンスステータスコード
array
返却データ配列