guide

Suno Persona API 가이드: 일관된 보컬 스타일 구현하기

Q: 이전 버전 모델에서 persona_id를 사용할 수 있나요?

아니요. Persona 기능은 suno-v4 이상이 필요합니다.

Q: Persona ID는 얼마나 오래 유지되나요?

Persona ID의 생명주기 및 사용 가능 여부에 관한 세부 사항은 현재 프로바이더 문서를 확인하세요. ---

EvoLink Team

Product Team

2026년 3월 28일

6분 소요

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()
    # 작업 식별자로 'id'를 반환합니다
    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":
            # result_data 배열에서 결과 접근
            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가 해당 매개변수를 올바르게 처리하기 위한 문서화된 요구 사항입니다.