Guide de l'API Suno Persona : Obtenir un style vocal cohérent

En bref

• Objectif : Maintenir une cohérence vocale et stylistique entre différentes générations musicales.
• Paramètres clés : persona_id et custom_mode=True.
• Flux de travail : Créer un Persona à partir d'un morceau existant → Récupérer le persona_id → Utiliser dans les générations suivantes.
• Intégration : Passer le persona_id lors de la soumission de tâche à /v1/audios/generations.

Qu'est-ce que l'API Suno Persona ?

Pourquoi utiliser l'API Persona ?

• Image de marque : Maintenir une « voix de marque » cohérente pour les intros de podcasts ou les jingles publicitaires.
• Cohérence : Conserver le même chanteur pour des séries épisodiques ou des chansons narratives en plusieurs parties.
• Conception de personnages : Attribuer des « personas » vocales spécifiques à des personnages dans un jeu ou un projet vidéo.

Comment démarrer avec l'API Persona

1. Générer un morceau de référence : Créez un morceau Suno via l'API de génération standard.
2. Créer le Persona : Appelez l'endpoint de création de Persona en utilisant l'id de votre morceau généré avec succès.
3. Récupérer l'identifiant : L'API retournera un persona_id unique.
4. Réutiliser : Passez ce persona_id dans les futures requêtes de génération pour appliquer le style vocal.

Implémentation technique

Soumettre une tâche de génération avec 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}")

Récupérer les résultats

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)

Bonnes pratiques

• Style vs. Contenu : Le persona_id fige les caractéristiques vocales. Assurez-vous que le style de votre prompt est compatible avec la référence du persona.
• Mode personnalisé : Définissez toujours custom_mode=True lorsque vous utilisez les paramètres persona, car c'est une exigence documentée pour que l'API les traite correctement.

Dépannage et FAQ

Ressources

• Présentation de l'API Suno
• Tutoriel API Suno
• Documentation de génération musicale
• Documentation de la fonctionnalité Persona