guide

Suno Persona APIガイド：一貫したボーカルスタイルの実現

Q: persona_id は古いモデルでも使えますか？

いいえ。Persona機能には suno-v4 以上が必要です。

Q: Persona IDの有効期限はどのくらいですか？

Persona IDのライフサイクルと利用可能性の詳細については、現在のプロバイダードキュメントをご確認ください。 ---

EvoLink Team

Product Team

2026年3月28日

4 分

Suno Persona APIガイド：一貫したボーカルスタイルの実現

メタディスクリプション： Suno Persona APIとpersona_idを使って、複数の音楽生成で一貫したボーカルスタイルを維持する方法を解説。開発者向け技術ガイド。

まとめ

目標：異なる音楽生成間でボーカルとスタイルの一貫性を維持
主要パラメータ：persona_id と custom_mode=True
ワークフロー：既存トラックからPersonaを作成 → persona_id を取得 → 以降の生成で使用
統合：/v1/audios/generations タスク送信時に persona_id を渡す

Suno Persona APIとは？

Suno Persona APIを使うと、開発者は特定のボーカルとスタイルの特徴を固定できます。特定の persona_id を再利用することで、異なる歌詞やセグメントでもボーカリストの音色、スタイル、エネルギーの一貫性を確保できます。

Persona APIを使う理由

ブランディング：ポッドキャストのイントロや広告ジングルで一貫した「ブランドボイス」を維持
一貫性：エピソードシリーズや複数パートのナラティブソングで同じボーカリストを維持
キャラクターデザイン：ゲームや動画プロジェクトのキャラクターに特定のボーカル「ペルソナ」を割り当て

Persona APIの始め方

persona_id はゼロから生成されるものではなく、既存の音楽から派生します。一般的なワークフローは以下の通りです：

ベースライントラックの生成：標準の生成APIを使ってSunoトラックを作成
Personaの作成：正常に生成されたトラックの id を使ってPersona作成エンドポイントを呼び出す
IDの取得：APIが一意の persona_id を返却
再利用：今後の生成リクエストでこの persona_id を渡してボーカルスタイルを適用

技術的な実装

Persona付きで生成タスクを送信

Personaを適用するには、/v1/audios/generations へのPOSTリクエストに persona_id を含めます。公開ドキュメントによると、persona_id と persona_model パラメータは custom_mode が True に設定されている場合にのみ有効です。

import requests

API_KEY = "sk-your-evolink-key"
BASE_URL = "https://api.evolink.ai/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

def submit_persona_task(prompt, persona_id):
    url = f"{BASE_URL}/audios/generations"
    payload = {
        "model": "suno-v5-beta",
        "prompt": prompt,
        "persona_id": persona_id,
        "custom_mode": True
    }
    response = requests.post(url, headers=headers, json=payload)
    response.raise_for_status()
    # Returns 'id' as the task identifier
    return response.json()["id"]

task_id = submit_persona_task(
    prompt="Upbeat pop chorus about city lights",
    persona_id="your-unique-persona-id"
)
print(f"Task submitted with id: {task_id}")

結果の取得

GET /v1/tasks/{task_id} エンドポイントを使って完了をポーリングします。オーディオURLは result_data 配列内にあります。

def get_song_result(task_id):
    url = f"{BASE_URL}/tasks/{task_id}"
    while True:
        response = requests.get(url, headers=headers)
        data = response.json()

        if data["status"] == "completed":
            # Access result from result_data array
            return data["result_data"][0]["audio_url"]
        elif data["status"] == "failed":
            raise Exception(f"Task failed: {data.get('error')}")

        time.sleep(5)

ベストプラクティス

スタイル vs コンテンツ：persona_id はボーカルの特徴を固定します。プロンプトのスタイルがPersonaのベースラインと互換性があることを確認してください。
カスタムモード：Personaパラメータを使用する際は必ず custom_mode=True を設定してください。これはAPIが正しく処理するためのドキュメント化された要件です。