メインコンテンツへスキップ
POST
/
v1
/
audios
/
generations
curl --request POST \
  --url https://api.evolink.ai/v1/audios/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "suno-v5-beta",
  "prompt": "A cheerful summer pop song about road trips and freedom"
}
'
{
  "created": 1766319090,
  "id": "task-unified-1766319089-oqs9cue4",
  "model": "suno-v5-beta",
  "object": "audio.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "audio",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 10,
    "user_group": "default"
  }
}

承認

​
Authorization
string
header
必須

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

APIキーの取得：

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

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

Authorization: Bearer YOUR_API_KEY

ボディ

application/json
​
model
enum<string>
必須

モデル名

後方互換性： 以前に統合されたモデル名（suno-v5、suno-v4.5、suno-v4.5plus、suno-v4.5all、suno-v4など）は引き続き使用可能で、対応する-betaバージョンに自動的にマッピングされます

利用可能なオプション：

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

"suno-v5-beta"

​
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

​
persona_id
string

Persona ID、作成済みのPersonaスタイルを今回の音楽生成に適用

custom_mode=true の場合のみ使用可能。Suno Persona 作成 APIで取得し、一貫したボーカルとスタイル特性を維持できます

取得方法： Personaタスク完了後、result_data.persona_id から取得

例:

"5c57d49ef834110496fae5aa14fec441"

​
persona_model
enum<string>

Persona の適用方式

オプション：

  1. style_persona：スタイル指向型、音楽スタイル特性（編曲、リズム、音色）を重視、すべてのモデルバージョンに対応
  2. voice_persona：ボイス指向型、ボーカル特性（音色、歌唱法、声質）を重視、V5のみ対応

custom_mode=true の場合のみ使用可能、通常 persona_id と組み合わせて使用。voice_persona 使用時はモデルが suno-v5-beta である必要があり、そうでない場合はエラーが返されます

利用可能なオプション:
style_persona,
voice_persona
例:

"style_persona"

​
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

​
id
string

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

例:

"task-unified-1766319089-oqs9cue4"

​
model
string

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

例:

"suno-v5-beta"

​
object
enum<string>

タスクタイプ

利用可能なオプション:
audio.generation.task
​
progress
integer

タスク進捗率（0-100）

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

0

​
status
enum<string>

タスクステータス

利用可能なオプション:
pending,
processing,
completed,
failed
例:

"pending"

​
task_info
object

音声タスクの詳細

​
type
enum<string>

タスク出力タイプ

利用可能なオプション:
audio
例:

"audio"

​
usage
object

使用量と課金情報