Suno API

RouteAPI fournit une API REST unifiée pour la génération de musique IA Suno. Générez de la musique à partir de texte, prolongez des chansons, clonez des voix, séparez des pistes et plus encore.

Base URL: https://api.routeapi.ai
Authentification: Authorization: Bearer sk-xxxx

Aperçu du workflow

Modèle asynchrone

Toutes les opérations de génération suivent le même modèle : soumettre une tâche → interroger le résultat

La génération musicale Suno est asynchrone. Flux typique :

1. Soumettre une tâche à /suno/audios → recevoir un task_id
2. Attendre 2-3 secondes avant de commencer l’interrogation
3. Interroger toutes les 3-5 secondes via /suno/tasks avec action: "retrieve"
4. Quand status devient success → récupérer l’audio_url

Statuts de tâche

Statut	Signification	Prochaine étape
submitted	Soumis, en attente	Continuer l’interrogation
queued	En file d’attente	Continuer l’interrogation
in_progress	En cours de génération	Continuer l’interrogation
success	✅ Terminé	Récupérer data.audio_url
failed	❌ Échec	Vérifier le champ error

Démarrage rapide

Étape 1 : Soumettre une tâche

curl -X POST "https://api.routeapi.ai/suno/audios" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "chirp-v5-5",
    "prompt": "A cheerful summer pop song with piano and guitar",
    "async": true
  }'

Étape 2 : Interroger le résultat

curl -X POST "https://api.routeapi.ai/suno/tasks" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{ "action": "retrieve", "id": "task_xxxxx" }'

Étape 3 : Obtenir l’audio

{
  "id": "task_xxxxx",
  "status": "success",
  "data": {
    "audio_url": "https://cdn.suno.ai/xxx.mp3",
    "duration": 183.5
  }
}

Modèles supportés

ID de modèle	Durée max	Limite lyric	Limite style
chirp-v5-5	8 minutes	5000 caractères	1000 caractères
chirp-v5	8 minutes	5000 caractères	1000 caractères
chirp-v4	150 secondes	3000 caractères	200 caractères

Astuce

En cas de doute, utilisez chirp-v5-5 (le plus récent et le plus performant).

POST /suno/audios

Point d’accès principal supportant les 18 opérations audio.

Paramètres principaux

Champ	Type	Défaut	Description
model	string	chirp-v4	Modèle de génération, chirp-v5-5 recommandé
action	string	generate	Type d’opération
async	boolean	false	true fortement recommandé

Types d’action

Action	Description	Champs requis
generate	Générer une nouvelle musique à partir d’un prompt	prompt
extend	Prolonger un audio existant	audio_id + continue_at
cover	Réinterpréter une chanson existante	audio_id
stems	Séparer en voix + instrumental	audio_id
remaster	Remaster l’audio pour améliorer la qualité	audio_id

Pour les types d’action complets, consultez la documentation en anglais ou chinois.

POST /suno/tasks

Interroger le statut et les résultats de la tâche.

curl -X POST "https://api.routeapi.ai/suno/tasks" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{ "action": "retrieve", "id": "task_xxxxx" }'

Autres points d’accès

Point d’accès	Méthode	Description
/suno/lyrics	POST	Générer des paroles
/suno/upload	POST	Télécharger un fichier audio externe
/suno/persona	GET/POST	Gérer les personas vocales
/suno/wav	POST	Exporter au format WAV

Pour la référence API complète, consultez la documentation en anglais ou chinois.

FAQ

Q : Quel modèle utiliser ?
Utilisez chirp-v5-5 (le plus récent et le plus performant).

Q : Combien de temps prend la génération ?
generate prend généralement 15-40 secondes.

Q : Puis-je utiliser audio_url directement ?
Oui, le lien CDN est prêt pour la lecture ou le téléchargement.