Musique
Créer de la musique
Crée une tâche de génération de musique à l'aide de Suno
Générez de la musique et des paroles à l'aide de l'IA. Il s'agit d'une API asynchrone. La réponse de création renvoie un identifiant de tâche et peut, lorsqu'il est disponible, inclure un poll_url à utiliser en priorité.
Corps de la requête
suno_musicIdentifiant du modèle musical, par exemple suno-music. Pour les paroles seules, choisissez un modèle dont les opérations publiques actuelles incluent lyrics.
Description musicale ou texte de remplacement. Obligatoire pour musique, paroles, upload-cover, upload-extend et replace-section ; facultatif pour add-instrumental et la séparation de pistes.
Titre de la chanson générée.
Tags de style (ex : "pop, upbeat, electronic").
Styles à éviter. Obligatoire lorsque audio_operation vaut add-instrumental.
Valeur facultative MUSIC ou LYRICS. Choisissez un modèle compatible avec l’opération publique correspondante ; ce champ n’ajoute pas la génération de paroles à un modèle limité à la musique.
Sélecteur de version Suno. Obligatoire pour la génération, upload-cover, upload-extend, add-instrumental et le remplacement depuis audio_url. À omettre pour les paroles, le remplacement depuis task_id + audio_id et la séparation de pistes. Valeurs acceptées : chirp-v3-5, chirp-v4, chirp-v4-5, chirp-v4.5, chirp-v4-5plus, chirp-v4.5plus, chirp-v4-5all, chirp-v4.5all, chirp-v5, chirp-v5-5, chirp-v5.5.
Définissez sur true pour générer une sortie instrumentale sans voix.
URL audio de référence ou téléversée accessible publiquement. Si audio_operation est omis, TokenLab utilise le flux upload-cover.
Opération audio : upload-cover, upload-extend, add-instrumental, replace-section, vocal-separate, multi-stem-separation, advanced-split.
vocal-separate, multi-stem-separation et advanced-split nécessitent task_id + audio_id ; advanced-split exige aussi stem_name. upload-extend exige continue_at supérieur à 0. add-instrumental exige audio_url, title, tags et negative_tags.
replace-section nécessite prompt, tags, title, infill_start_s, infill_end_s et full_lyrics. Choisissez une seule source : task_id + audio_id, ou audio_url + mv. L’intervalle remplacé doit durer de 6 à 60 secondes.
Identifiant d’une tâche source appartenant à votre organisation, pour remplacer un audio généré ou séparer les pistes.
Identifiant audio renvoyé dans le résultat de la tâche source. Obligatoire avec task_id pour remplacer un audio généré ou séparer les pistes.
Début du remplacement en secondes, au moins 0. Obligatoire pour replace-section.
Fin du remplacement en secondes. Obligatoire pour replace-section, de 6 à 60 secondes après infill_start_s.
Paroles complètes de la chanson résultante. Obligatoire pour replace-section.
Nom de la piste. Obligatoire pour advanced-split.
ID d'un clip précédent à partir duquel continuer.
Position de reprise en secondes. Obligatoire et supérieure à 0 pour upload-extend.
prompt accepte jusqu’à 5000 caractères ; tags et negative_tags, jusqu’à 1000 chacun. Les opérations et paramètres acceptés dépendent des détails actuels du modèle.
Réponse
ID de la tâche pour interroger le statut.
Alias du même identifiant de tâche asynchrone, lorsqu’il est renvoyé.
URL de polling prioritaire lorsqu'elle est disponible.
Statut de la tâche : pending, processing, completed ou failed.
Horodatage Unix de création de la tâche, lorsqu’il est renvoyé.
Requête
curl -X POST "https://api.tokenlab.sh/v1/music/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-music",
"mv": "chirp-v4",
"prompt": "An upbeat electronic dance track with heavy bass",
"title": "Night Drive",
"tags": "electronic, EDM, energetic"
}'Réponse
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"model": "suno-music"
}Autorisation
BearerAuth Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.
Emplacement: header
En-têtes
Politique de livraison par requête. Remplace les valeurs par défaut de la clé API et de l'espace de travail. Tente automatiquement TokenLab Verified en premier et peut basculer une fois vers Official uniquement avant la sortie, l'acceptation de la requête ou la création de ressource persistante.
Valeurs possibles
- "auto"
- "verified"
- "official"
Corps de la requête
application/json
Réponse
application/json
application/json