Skip to main content
GET
Règles générales Suno V6 et consultation des tâches
Toutes les API Suno de génération, d’édition et d’outils utilisent des tâches asynchrones : soumettez l’opération, récupérez task_id, puis consultez le résultat avec l’API de cette page.

Authentification

string
requis
Authentification Bearer Token : Authorization: Bearer <YOUR_API_KEY>.
Rendez-vous sur la page de gestion des clés API pour obtenir votre clé API.

Version V6 et sélection du modèle

Les modèles publics prennent en charge les versions suivantes :
  • v6
  • v6-wild
  • v6-mini
L’endpoint principal exige soit version, soit la custom_model_id renvoyée par une tâche de création. Les opérations d’édition compatibles utilisent v6 par défaut si version est omise. version publique et custom_model_id ne peuvent pas être envoyées ensemble.
custom: true sélectionne le mode paroles personnalisées, tandis que custom_model_id sélectionne un modèle entraîné. Ce sont deux notions distinctes ; le mode paroles ne passe pas automatiquement à la tarification du modèle personnalisé.

Options générales de génération V6

N’envoyez les champs suivants que s’ils sont indiqués pour l’endpoint concerné : Omettez les champs non pris en charge et n’envoyez pas max_mode: false partout. variety et le mode Max sont indépendants : variety: "max" n’active pas la facturation Max.

Limites de texte et de pondération

Les nouvelles requêtes d’opération utilisent weirdness ; weirdness_constraint est un alias de compatibilité. La génération principale utilise encore weirdness_constraint. La longueur est comptée en caractères Unicode.

Piste source de référence

À partir d’œuvres existantes :
  • task_id : ID de tâche API Mart de la piste audio produite.
  • audio_index : position d’origine dans data.result.music[] de la tâche source, à partir de 1 ; valeur par défaut 1.
Affichez le nombre réel d’éléments du tableau sans le fixer à 2. Même si l’ordre d’affichage change, les opérations suivantes doivent utiliser l’index dans le résultat d’origine.
Les nouvelles requêtes référencent la piste source avec task_id + audio_index ; audio_id, music_id ou audio_url ne peuvent pas les remplacer. Une source introuvable ou un index hors limites renvoie 400.

Réponse de soumission

Lisez l’ID de tâche dans data[0].task_id. submitted indique seulement que la tâche a été acceptée, pas que l’audio final ou d’autres livrables sont déjà disponibles.

Interroger la tâche

GET /v1/music/tasks/{task_id} Ajoutez ?language=zh pour obtenir les traductions disponibles des messages d’échec. Ce paramètre ne change pas la langue du morceau ou des paroles.
string
requis
ID de tâche renvoyée par l’API de soumission.
Attendez environ 3 secondes, puis interrogez toutes les 5 à 10 secondes jusqu’à ce que data.status soit completed ou failed. La même ID de tâche reste utilisable après actualisation. Ne renvoyez pas automatiquement une requête POST payante après un délai réseau.

Réponse de la requête

integer
Code d’état de la réponse.
object
Informations sur la tâche.

Traitement du résultat

  • Les résultats musicaux se trouvent généralement dans data.result.music[], mais les téléchargements, paroles, MIDI, Persona et modèles personnalisés ont leurs propres structures.
  • duration est la durée réelle et peut être décimale ; la durée cible ne correspond pas forcément exactement au résultat final.
  • La valeur de pondération 0 est valide et ne doit pas être masquée par un test falsy JavaScript.
  • audio_url ne se termine pas forcément par .mp3. Utilisez l’URL réellement renvoyée pour la lecture ou le téléchargement.
  • Avec status="unknown", conservez l’ID de tâche et autorisez l’actualisation manuelle sans créer automatiquement une nouvelle tâche.
AbortController peut arrêter les requêtes du navigateur et le polling, mais pas la tâche côté serveur. Aucun endpoint ne permet actuellement d’annuler une tâche Suno soumise.