curl --request POST \
  --url https://api.evolink.ai/v1/audios/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "suno-persona",
  "model_params": {
    "source_task_id": "task-unified-1774169216-ocqaqde7",
    "result_id": "4fcc4507-a7ae-4441-ad8a-465c2f61d5bb",
    "name": "Electronic Pop Singer",
    "description": "Modern electronic style with energetic beats and synthesizer tones for dance music"
  }
}
'

{
  "created": 1774170584,
  "id": "task-unified-1774170584-su75smg7",
  "model": "suno-persona",
  "object": "audio.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 15
  },
  "type": "audio",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1,
    "user_group": "default"
  }
}

Suno

Suno Persona 作成 Beta

完了済みのSuno音楽生成タスクから再利用可能なPersona（ボーカル/スタイル特性）を抽出
作成成功後に persona_id が返され、後続の Suno 音楽生成で persona_id と persona_model パラメータを通じて適用可能
ソースタスクのモデルバージョンは suno-v4 以上 が必要（v3.5は非対応）
各楽曲（result_id）から Personaは1つのみ 作成可能
非同期処理モード、返却されたタスクIDでステータスを照会
Personaタスクから新しいPersonaを作成することはできません

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-persona",
  "model_params": {
    "source_task_id": "task-unified-1774169216-ocqaqde7",
    "result_id": "4fcc4507-a7ae-4441-ad8a-465c2f61d5bb",
    "name": "Electronic Pop Singer",
    "description": "Modern electronic style with energetic beats and synthesizer tones for dance music"
  }
}
'

{
  "created": 1774170584,
  "id": "task-unified-1774170584-su75smg7",
  "model": "suno-persona",
  "object": "audio.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 15
  },
  "type": "audio",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1,
    "user_group": "default"
  }
}

承認

Authorization

string

header

必須

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

APIキーの取得：

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

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

Authorization: Bearer YOUR_API_KEY

ボディ

application/json

model

enum<string>

必須

モデル名、suno-persona 固定

利用可能なオプション:

suno-persona

例:

"suno-persona"

model_params

object

必須

Persona 作成パラメータ

Show child attributes

レスポンス

Persona作成タスクの送信に成功しました

created

integer

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

例:

1774170584

id

string

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

例:

"task-unified-1774170584-su75smg7"

model

string

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

例:

"suno-persona"

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

音声タスクの詳細

Show child attributes

type

enum<string>

タスク出力タイプ

利用可能なオプション:

audio

例:

"audio"

usage

object

使用量と課金情報

Show child attributes