Musique
Créer de la musique
Crée une tâche de génération de musique, de paroles ou de son
Utilisez GET /v1/models?recommended_for=music pour obtenir les modèles de musique actuels.
Générez de la musique, des paroles et du son avec l'IA. Il s'agit d'une API asynchrone. Les réponses de création renvoient une identité de tâche. Interrogez GET /v1/tasks/{id} avec celle-ci pour obtenir le statut.
Les modèles diffèrent selon les champs qu'ils acceptent. Vérifiez GET /v1/models/{model} avant d'envoyer des champs optionnels ; un champ non listé par le modèle peut renvoyer 400 unsupported_parameter. Les champs Suno (mv, title, tags, negative_tags, audio_operation et les champs associés) s'appliquent aux modèles Suno. user n'est pas pris en charge et renvoie 400.
Corps de la requête
suno-musicID du modèle de musique, tel que suno-music ou stable-audio-3. Envoyez-le explicitement. Pour les paroles uniquement, choisissez un modèle dont les opérations publiques actuelles incluent lyrics.
Description de la musique ou texte de remplacement. Requis pour la musique, les paroles, upload-cover, upload-extend et replace-section ; optionnel pour add-instrumental et la séparation de pistes (stems).
Titre de la chanson générée.
Tags de style (par ex. "pop, upbeat, electronic").
Styles à éviter. Requis lorsque audio_operation est add-instrumental.
Valeur optionnelle MUSIC ou LYRICS. Choisissez un modèle qui prend en charge l'opération publique correspondante ; ce champ n'ajoute pas la prise en charge des paroles à un modèle uniquement musical.
Sélecteur de version Suno. Requis pour la génération, upload-cover, upload-extend, add-instrumental et le remplacement à partir de audio_url. Omettez-le pour les paroles, le remplacement à partir de task_id + audio_id et la séparation de pistes. Valeurs acceptées : chirp-v6, chirp-v6-mini, chirp-v6-wild.
Définissez sur true pour générer une sortie instrumentale sans voix.
Référence accessible publiquement ou URL audio téléchargée. Lorsqu'il est fourni sans audio_operation, 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 nécessite également stem_name. upload-extend nécessite continue_at supérieur à 0. add-instrumental nécessite audio_url, title, tags et negative_tags.
Pour replace-section, envoyez prompt, tags, title, infill_start_s, infill_end_s et full_lyrics. Choisissez exactement une source : task_id + audio_id ou audio_url + mv. L'intervalle de remplacement doit être compris entre 6 et 60 secondes.
ID de la tâche source appartenant à votre organisation, pour le remplacement d'audio généré ou la séparation de pistes.
ID de l'audio source renvoyé dans le résultat de la tâche source. Requis avec task_id pour le remplacement d'audio généré et la séparation de pistes.
Heure de début du remplacement en secondes, au moins 0. Requis pour replace-section.
Heure de fin du remplacement en secondes. Requis pour replace-section ; elle doit être comprise entre 6 et 60 secondes après infill_start_s.
Paroles complètes de la chanson résultante. Requis pour replace-section.
Nom de la piste (stem). Requis pour advanced-split.
ID d'un clip précédent à partir duquel continuer.
Temps en secondes à partir duquel continuer. Requis et supérieur à 0 pour upload-extend.
Durée de l'audio généré en secondes, de 1 à 380. Uniquement pour les modèles qui le listent, comme stable-audio-3 ; les détails du modèle indiquent sa propre limite.
Format de fichier audio listé par le modèle, par exemple mp3, wav ou flac. Uniquement pour les modèles qui le listent.
Graine (seed) pour une sortie reproductible, de 0 à 4294967294. Uniquement pour les modèles qui le listent.
Nombre d'étapes de génération. La plage dépend du modèle (par exemple, de 4 à 8 pour stable-audio-3). Uniquement pour les modèles qui l'indiquent.
Certains modèles listent des champs supplémentaires, tels que negative_prompt, n, seconds et guidance_scale. Ne les envoyez que lorsque les détails du modèle les mentionnent ; un champ non pris en charge par le modèle sélectionné renverra une erreur 400.
Force de guidage du prompt, de 1 à 25. Uniquement pour les modèles qui le listent.
prompt accepte jusqu'à 5000 caractères ; tags et negative_tags acceptent jusqu'à 1000 caractères chacun. Les opérations et paramètres pris en charge dépendent des détails actuels du modèle sélectionné.
Réponse
ID de la tâche pour interroger le statut.
Alias du même ID de tâche asynchrone, lorsqu'il est renvoyé.
URL de statut pour cette tâche. Interrogez GET /v1/tasks/{id} avec id.
Statut de la tâche : pending, processing, completed ou failed.
Heure de création de la tâche sous forme de timestamp Unix, 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-v6",
"prompt": "An upbeat electronic dance track with heavy bass",
"title": "Night Drive",
"tags": "electronic, EDM, energetic"
}'Exemple de génération de son pour un modèle qui prend duration et output_format au lieu des champs Suno :
{
"model": "stable-audio-3",
"prompt": "Warm lo-fi beat with soft vinyl crackle",
"duration": 30,
"output_format": "mp3"
}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"
Clé optionnelle qui permet de réessayer une requête de création en toute sécurité. Envoyez une nouvelle valeur unique, telle qu'un UUID, pour chaque tâche. Une tentative avec la même clé et le même corps renvoie le résultat de la requête de création initiale, généralement la tâche d'origine, et ne crée, ne distribue ni ne facture une seconde tâche. Un corps différent avec une clé déjà acceptée est rejeté avec 409. Une clé de plus de 255 caractères est ignorée, et la requête ne bénéficie alors d'aucune protection d'idempotence. Voir Réessayer en toute sécurité avec une clé d'idempotence.
1 <= length <= 255Corps de la requête
application/json
Réponse
application/json
application/json
application/json
application/json
application/json
application/json