musicland/plans/fix-suno-api.md

Plan de correction de l'API Suno

Problème identifié

• ❌ L'API Suno retournait une erreur 404 à cause d'une URL incorrecte
• ❌ Les paramètres de la requête n'étaient pas conformes à la documentation officielle
• ❌ L'authentification utilisait un mauvais format de header

Solutions appliquées

1. Correction de l'URL de l'API

• ✅ Changé https://api.sunoaiapi.com vers https://api.sunoapi.org
• ✅ Changé l'endpoint /api/custom_generate vers /api/v1/generate

2. Correction des paramètres de la requête

• ✅ Changé custom_mode vers customMode (camelCase)
• ✅ Changé tags vers style selon la documentation
• ✅ Changé callback_url vers callBackUrl (camelCase)

3. Correction de l'authentification

• ✅ Changé X-API-Key vers Authorization: Bearer selon la documentation

4. Ajustement du modèle

• ✅ Changé V4_5PLUS vers V4_5 (modèle supporté)

Tests à effectuer

• 🧪 Tester la génération de musique avec paroles
• 🧪 Tester la génération de musique instrumentale
• 🧪 Vérifier la réponse de l'API et le format des données retournées
• 🧪 Tester avec différents styles musicaux

Documentation de référence

• 📚 Documentation officielle Suno API
• 📚 URL de l'API: https://api.sunoapi.org/api/v1/generate
• 📚 Authentification: Authorization: Bearer <token>

Fichiers modifiés

• ✏️ /functions/src/music.js - Correction de l'URL, des paramètres et de l'authentification

Notes importantes

• ⚠️ L'API Suno a une limite de concurrence: 20 requêtes toutes les 10 secondes
• ⚠️ Chaque requête génère exactement 2 chansons
• ⚠️ URL de streaming disponible en 30-40 secondes
• ⚠️ URL de téléchargement prête en 2-3 minutes