Guía de la Suno Persona API: cómo lograr un estilo vocal consistente

Resumen

• Objetivo: Mantener la consistencia vocal y de estilo en diferentes generaciones musicales.
• Parámetros clave: persona_id y custom_mode=True.
• Flujo de trabajo: Crear una Persona a partir de una pista existente → Obtener el persona_id → Usarlo en generaciones posteriores.
• Integración: Pasar persona_id durante el envío de la tarea a /v1/audios/generations.

¿Qué es la Suno Persona API?

¿Por qué usar la Persona API?

• Marca: Mantén una "voz de marca" consistente para intros de podcasts o jingles publicitarios.
• Consistencia: Conserva el mismo vocalista para series episódicas o canciones narrativas de varias partes.
• Diseño de personajes: Asigna "personas" vocales específicas a personajes de un videojuego o proyecto de vídeo.

Cómo empezar con la Persona API

1. Genera una pista base: Crea una pista de Suno usando la API de generación estándar.
2. Crea la Persona: Llama al endpoint de creación de Persona usando el id de tu pista generada con éxito.
3. Obtén el ID: La API devolverá un persona_id único.
4. Reutiliza: Pasa este persona_id en futuras solicitudes de generación para aplicar el estilo vocal.

Implementación técnica

Enviar tarea de generación con Persona

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}")

Obtención de resultados

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)

Mejores prácticas

• Estilo vs. Contenido: persona_id fija las características vocales. Asegúrate de que el estilo de tu prompt sea compatible con la línea base de la persona.
• Modo personalizado: Establece siempre custom_mode=True al usar parámetros de persona, ya que es un requisito documentado para que la API los procese correctamente.

Solución de problemas y preguntas frecuentes

Recursos

• Visión general de la Suno API
• Tutorial de la Suno API
• Documentación de generación musical
• Documentación de la función Persona