
Tutoriel
Comment utiliser l'API Suno avec Python : Tutoriel étape par étape

EvoLink Team
Product Team
28 mars 2026
4 min de lecture
Comment utiliser l'API Suno avec Python : Tutoriel étape par étape
Meta Description : Un tutoriel Python pratique sur l'utilisation de l'API Suno pour la génération musicale. Apprenez à soumettre des tâches asynchrones, interroger les résultats et implémenter des paroles personnalisées dans votre application.
En bref
- Objectif : Générer des morceaux de musique IA (voix + instrumentaux) avec Python.
- Modèle : API de tâches asynchrones (Soumettre → Interroger → Obtenir le résultat).
- Prérequis : Clé API EvoLink, Python 3.x, bibliothèque
requests. - Modèles clés :
suno-v5-beta,suno-v4.5-beta. - Tutoriel : Passez directement à l'Étape 1.
Étape 1 : Installation
Vous avez besoin de la bibliothèque
requests pour la communication HTTP.pip install requestsÉtape 2 : Le flux principal (modèle asynchrone)
Contrairement aux modèles de texte standard, la génération musicale Suno prend 20 à 45 secondes. Nous utilisons un modèle de tâches asynchrones :
- Soumettre la tâche : Requête POST vers
/v1/audios/generations. - Obtenir l'identifiant de tâche : L'API retourne un
idimmédiatement. - Interroger le statut : Requête GET vers
/v1/tasks/{task_id}jusqu'à ce que le statut soitcompleted. - Télécharger le résultat : Récupérer l'URL audio générée depuis
result_data[0].audio_url.

Étape 3 : Implémentation Python
1. Initialiser le client
import requests
import time
API_KEY = "sk-your-evolink-key"
BASE_URL = "https://api.evolink.ai/v1"
headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
}2. Soumettre la tâche de génération
def submit_suno_task(prompt, model="suno-v5-beta"):
url = f"{BASE_URL}/audios/generations"
payload = {
"model": model,
"prompt": prompt
}
response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
# Returns the 'id' field
return response.json()["id"]
task_id = submit_suno_task("Upbeat pop song for Instagram Reels, energetic vocals")
print(f"Task submitted: {task_id}")3. Interroger 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()
status = data["status"]
if status == "completed":
# Access result from result_data list
return data["result_data"][0]["audio_url"]
elif status == "failed":
raise Exception(f"Task failed: {data.get('error')}")
print("Still generating...")
time.sleep(5) # Poll every 5 seconds
song_url = get_song_result(task_id)
print(f"Song ready: {song_url}")Étape 4 : Fonctionnalités avancées
Utiliser des paroles personnalisées
Structurez vos paroles avec des balises standard pour un meilleur contrôle de la structure du morceau.
lyrics_prompt = """
[Verse 1]
Walking down the street, feeling the beat
City lights are shining, life is so sweet
[Chorus]
We're alive tonight, dancing in the moonlight
Everything's alright, we're shining so bright
"""
task_id = submit_suno_task(lyrics_prompt)Appliquer des Personas
Utilisez le paramètre
persona_id pour maintenir un style vocal cohérent entre les générations (nécessite v4+). Définissez custom_mode=True pour activer la structure personnalisée.payload = {
"model": "suno-v5-beta",
"prompt": "Pop song",
"persona_id": "your-persona-id",
"custom_mode": True
}Dépannage et FAQ
Q : Pourquoi est-ce que j'obtiens une erreur « Task failed » ?
R : Assurez-vous que la longueur de votre prompt et les paramètres de style respectent les normes de la documentation actuelle. Vérifiez que votre compte dispose de suffisamment de crédits.
Q : Comment gérer les timeouts ?
R : N'utilisez jamais de code bloquant synchrone. Implémentez toujours une boucle de polling ou utilisez un callback webhook (recommandé pour les applications à fort volume).
Q : Puis-je changer de modèle ?
R : Oui, utilisez
suno-v4.5-beta pour des générations plus rapides et moins chères ou suno-v5-beta pour un audio de qualité studio.Commencez à générer
Prêt à coder ?
- Obtenez votre clé API.
- Copiez l'extrait Python de l'Étape 3.
- Exécutez-le et commencez à générer de la musique IA.
Mots-clés SEO : how to use suno api, suno api tutorial, suno api python, ai music generation python
Liens internes :


