Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
Aucun audio pour le moment. Envoyez le formulaire pour générer de l'audio.
Explorez différents cas d'utilisation et configurations de paramètres
Tarifs transparents sans frais cachés. Payez à l'utilisation.
| Règle & Modalité | Channel | Crédits | Prix (USD) | Prix officiel / référence | Économie quotidienne |
|---|---|---|---|---|---|
Suno extend musicSuno | Starter | 1per run | $0.005 | - | - |
Guide complet d'utilisation de Suno
Prolongez des morceaux existants générés par IA avec une continuité fluide, en ajoutant de nouvelles sections tout en préservant la cohérence musicale.
L’API d’extension Suno V5_5 vous permet de prolonger des morceaux précédemment générés avec Suno V5_5. Cette fonctionnalité vous permet de créer des compositions plus longues en ajoutant de nouvelles sections qui poursuivent naturellement la piste originale depuis n’importe quel point. Que vous souhaitiez ajouter un autre couplet, prolonger l’outro ou construire une fin culminante, l’API d’extension conserve le style musical, la tonalité, le tempo et l’ambiance de l’original tout en générant du nouveau contenu.
Laissez l’IA poursuivre automatiquement le morceau en utilisant les paramètres d’origine. Idéal pour des extensions rapides qui conservent une parfaite cohérence avec la piste source.
Gardez le contrôle en définissant le point de départ, le nouveau prompt, le style et le titre. Parfait pour maîtriser de manière créative la façon dont le morceau se développe et évolue.
Les extensions se fondent naturellement dans la piste originale, en respectant le tempo, la tonalité et le style pour produire des compositions plus longues au rendu professionnel.
Choisissez précisément où démarrer l’extension. Continuez depuis la fin, chevauchez l’outro ou créez une ramification à partir de n’importe quel moment du morceau.
Conservez le style original ou faites-le évoluer avec des paramètres personnalisés. Faites monter l’énergie, passez à une ambiance différente ou ajoutez de nouveaux éléments musicaux.
Prolongez les morceaux plusieurs fois pour créer des pistes de longueur épique. Chaque extension peut à son tour être prolongée, ce qui permet de créer des structures de chanson complexes.
Prolongez vos morceaux générés par IA en quelques étapes simples
Commencez par créer un morceau à l’aide de l’API suno/generate. Notez l’ID audio renvoyé dans la réponse pour la piste que vous souhaitez prolonger.
Choisissez entre l’extension automatique (avec les paramètres d’origine) et l’extension personnalisée (avec vos propres paramètres).
Pour les extensions personnalisées, indiquez le temps continueAt en secondes à partir duquel l’extension doit commencer.
Appelez l’API avec l’ID audio et les paramètres que vous avez choisis. L’extension sera générée de manière fluide à partir du point spécifié.
Récupérez le fichier audio prolongé. Le résultat inclut le contenu original ainsi que la nouvelle extension sous forme de piste complète.
Suivez ces recommandations pour obtenir des extensions de morceaux fluides
Pour obtenir les résultats les plus fluides, démarrez l’extension à partir de points de transition naturels, comme la fin d’une phrase, après un refrain ou pendant un break instrumental.
En mode personnalisé, décrivez comment la musique doit évoluer : faire monter l’énergie, ajouter des instruments, passer à un pont ou ralentir progressivement pour l’outro.
Lorsque vous utilisez des paramètres personnalisés, conservez un style proche de l’original pour obtenir un résultat cohérent, ou créez volontairement un contraste pour des transitions dynamiques.
Créez des morceaux complets de 4 à 5 minutes en prolongeant les générations initiales, idéal pour la production musicale commerciale.
Prolongez les pistes avec des variations parfaites pour le mix DJ, les performances live et les versions dance étendues.
Créez des morceaux de musique de fond plus longs pour des vidéos, des jeux et des projets multimédias en chaînant les extensions.
Créez des versions alternatives de morceaux en les prolongeant depuis différents points avec différents styles.
Fonctionne parfaitement avec les pistes générées par suno/generate. Utilisez la même clé API et le même flux de travail pour la génération originale et les extensions.
Créez des compositions plus longues sans régénérer des morceaux entiers. Les extensions sont facturées équitablement en fonction du nouveau contenu généré.
Les extensions conservent la même haute qualité que les générations Suno V5_5 originales, avec une continuité audio fluide.
Toutes les API nécessitent une authentification via un token Bearer.
Authorization: Bearer
Utilisez le SDK pour créer des tâches, conserver la taskId renvoyée et récupérer les résultats de Suno.
Installez @apipass-dev/apipass-sdk avant d'exécuter ces exemples SDK.
1npm install @apipass-dev/apipass-sdk
2# or
3pnpm add @apipass-dev/apipass-sdk
4# or
5yarn add @apipass-dev/apipass-sdkConservez votre clé API dans des variables d'environnement côté serveur. Le SDK l'envoie automatiquement comme token Bearer et ajoute les en-têtes JSON.
client.jobs.createTaskCréer une nouvelle tâche pour prolonger un morceau existant généré avec Suno V5
Utilisez cet exemple pour démarrer rapidement avec le SDK sélectionné.
1import { Apipass } from "@apipass-dev/apipass-sdk";
2
3const client = new Apipass({
4 apiKey: process.env.APIPASS_API_KEY!,
5});
6
7const task = await client.jobs.createTask({
8 "model": "suno/extend",
9 "callBackUrl": "https://your-domain.com/api/callback",
10 "input": {
11 "audioId": "abc123-def456-ghi789",
12 "continueAt": 120,
13 "prompt": "Build up to a powerful chorus with harmonies and drums",
14 "style": "Pop Rock, Uplifting, Anthemic",
15 "title": "Rise Again (Extended)"
16 }
17});
18
19console.log(task.data.taskId);L’API accepte une charge utile JSON avec la structure suivante :
1{
2 "model": "suno/extend",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 | V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "audioId": "string (required)",
7 "instrumental": "boolean",
8 "continueAt": "integer",
9 "prompt": "string",
10 "style": "string",
11 "title": "string",
12 "personaId": "string",
13 "negativeTags": "string",
14 "styleWeight": "number",
15 "weirdnessConstraint": "number",
16 "audioWeight": "number"
17 },
18 "channel": "auto"
19}modelRequisstringIdentifiant du modèle pour l’extension Suno V5
"suno/extend"
callBackUrlOptionnelstringURL destinée à recevoir les notifications webhook lorsque l’extension est terminée
"https://your-domain.com/api/callback"
channelOptionnelstringVous pouvez spécifier le fournisseur correspondant au sein d’APIPASS via le paramètre channel ; ces fournisseurs prennent en charge les tâches réelles de génération d’images et de vidéos. APIPASS propose actuellement trois options de fournisseur :
La valeur par défaut du paramètre channel est auto. Lorsqu’elle est activée, APIPASS répartit automatiquement les tâches entre les fournisseurs disponibles en fonction des tarifs en temps réel et des métriques de stabilité, afin d’équilibrer coût minimal et performances fiables. Conservez la valeur par défaut auto, sauf si vous avez des besoins de routage personnalisés.
Options disponibles :
auto
Paramètres pour prolonger un morceau existant :
input.model_versionOptionnelstringVersion du modèle Suno à utiliser. Par défaut : V5 (dernière version).
Options disponibles :
"V5"
input.audioIdRequisstringID de la piste audio source à prolonger. Obtenu à partir du résultat d’une génération suno/v5 précédente.
"abc123-def456-ghi789"
input.instrumentalOptionnelbooleanGénérer une extension instrumentale sans voix.
false
input.continueAtRequisintegerPoint temporel en secondes auquel démarrer l’extension. Obligatoire
Doit être > 0
120
input.promptRequisstringDescription de la section prolongée.
V4 : max. 3000 caractères V5_5, V5, V4_5PLUS, V4_5ALL, V4_5 : max. 5000 caractères
"Build up to a powerful chorus with harmonies"
input.styleRequisstringStyle musical de l’extension. Obligatoire
V4 : max. 200 caractères V5_5, V5, V4_5PLUS, V4_5ALL, V4_5 : max. 1000 caractères
"Pop Rock, Uplifting"
input.titleOptionnelstringTitre de la piste prolongée. Obligatoire
Longueur maximale : 80 caractères
"Rise Again (Extended)"
input.vocalGenderOptionnelstringGenre vocal pour l’extension.
Options disponibles :
"f"
input.personaIdOptionnelstringID de persona pour le morceau généré.
N’est effectif que lorsque customMode=true.
"1234567890"
input.negativeTagsOptionnelstringStyles ou caractéristiques à exclure de la génération.
N’est effectif que lorsque customMode=true.
"aggressive, heavy metal, screaming"
input.styleWeightOptionnelnumberDegré de strict respect du style. Plage : 0.0-1.0
N’est effectif que lorsque customMode=true. Ignoré lorsque customMode=false. Nombre compris entre 0.00 et 1.00. Doit utiliser des incréments de 0.01. Les valeurs booléennes ne sont pas acceptées.
0.5
input.weirdnessConstraintOptionnelnumberContrôle le niveau de créativité. Des valeurs plus élevées produisent des résultats plus expérimentaux. Plage : 0.0-1.0
N’est effectif que lorsque customMode=true. Ignoré lorsque customMode=false. Nombre compris entre 0.00 et 1.00. Doit utiliser des incréments de 0.01. Les valeurs booléennes ne sont pas acceptées.
0.3
input.audioWeightOptionnelnumberPoids de l’influence audio pour la génération. Plage : 0.0-1.0
N’est effectif que lorsque customMode=true. Ignoré lorsque customMode=false. Nombre compris entre 0.00 et 1.00. Doit utiliser des incréments de 0.01. Les valeurs booléennes ne sont pas acceptées.
0.5
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_extend_xyz789"
6 }
7}codeCode d’état, 200 en cas de réussite
messageMessage de réponse
data.taskIdID de tâche pour consulter l’état de l’extension
Lorsqu’une extension est terminée, une requête POST est envoyée à votre callBackUrl
1{
2 "code": 200,
3 "data": {
4 "taskId": "task_extend_xyz789",
5 "state": "success",
6 "completeTime": 1755599700000,
7 "costTime": 50000,
8 "model": "suno/extend",
9 "resultJson": {
10 "data": [
11 {
12 "id": "audio_ext_001",
13 "audio_url": "https://cdn.apipass.dev/results/task_extend_xyz789_0_audio.mp3",
14 "image_url": "https://cdn.apipass.dev/results/task_extend_xyz789_0_cover.jpeg",
15 "duration": 240.5
16 }
17 ]
18 }
19 },
20 "msg": "Extension completed successfully."
21}1{
2 "code": 501,
3 "data": {
4 "taskId": "task_extend_xyz789",
5 "state": "fail",
6 "failCode": "INVALID_AUDIO_ID",
7 "failMsg": "Source audio ID not found or expired"
8 },
9 "msg": "Extension failed."
10}client.jobs.recordInfoConsulter l’état d’une tâche d’extension et récupérer les résultats
Utilisez cet exemple pour démarrer rapidement avec le SDK sélectionné.
1import { Apipass } from "@apipass-dev/apipass-sdk";
2
3const client = new Apipass({
4 apiKey: process.env.APIPASS_API_KEY!,
5});
6
7const result = await client.jobs.recordInfo("task_extend_xyz789");
8
9console.log(result.data.state);
10console.log(result.data.resultJson);1{
2 "code": 200,
3 "data": {
4 "taskId": "task_extend_xyz789",
5 "state": "success",
6 "resultJson": {
7 "data": [
8 {
9 "id": "audio_ext_001",
10 "audio_url": "https://cdn.apipass.dev/results/task_extend_xyz789_0_audio.mp3",
11 "image_url": "https://cdn.apipass.dev/results/task_extend_xyz789_0_cover.jpeg",
12 "duration": 240.5
13 }
14 ]
15 }
16 }
17}data.stateÉtat actuel : queuing, generating, success ou fail
data.resultJson.dataTableau contenant la piste audio prolongée avec son URL et ses métadonnées
La page API montre le schéma des paramètres, mais Suno a également plusieurs combinaisons de modes spécifiques aux entreprises et des règles de rappel qui sont faciles à manquer.
Toutes les API nécessitent une authentification via un token Bearer.
Authorization: Bearer
Créer une nouvelle tâche pour prolonger un morceau existant généré avec Suno V5
L’API accepte une charge utile JSON avec la structure suivante :
1{
2 "model": "suno/extend",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 | V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "audioId": "string (required)",
7 "instrumental": "boolean",
8 "continueAt": "integer",
9 "prompt": "string",
10 "style": "string",
11 "title": "string",
12 "personaId": "string",
13 "negativeTags": "string",
14 "styleWeight": "number",
15 "weirdnessConstraint": "number",
16 "audioWeight": "number"
17 },
18 "channel": "auto"
19}modelRequisstringIdentifiant du modèle pour l’extension Suno V5
"suno/extend"
callBackUrlOptionnelstringURL destinée à recevoir les notifications webhook lorsque l’extension est terminée
"https://your-domain.com/api/callback"
channelOptionnelstringVous pouvez spécifier le fournisseur correspondant au sein d’APIPASS via le paramètre channel ; ces fournisseurs prennent en charge les tâches réelles de génération d’images et de vidéos. APIPASS propose actuellement trois options de fournisseur :
La valeur par défaut du paramètre channel est auto. Lorsqu’elle est activée, APIPASS répartit automatiquement les tâches entre les fournisseurs disponibles en fonction des tarifs en temps réel et des métriques de stabilité, afin d’équilibrer coût minimal et performances fiables. Conservez la valeur par défaut auto, sauf si vous avez des besoins de routage personnalisés.
Options disponibles :
auto
Paramètres pour prolonger un morceau existant :
input.model_versionOptionnelstringVersion du modèle Suno à utiliser. Par défaut : V5 (dernière version).
Options disponibles :
"V5"
input.audioIdRequisstringID de la piste audio source à prolonger. Obtenu à partir du résultat d’une génération suno/v5 précédente.
"abc123-def456-ghi789"
input.instrumentalOptionnelbooleanGénérer une extension instrumentale sans voix.
false
input.continueAtRequisintegerPoint temporel en secondes auquel démarrer l’extension. Obligatoire
Doit être > 0
120
input.promptRequisstringDescription de la section prolongée.
V4 : max. 3000 caractères V5_5, V5, V4_5PLUS, V4_5ALL, V4_5 : max. 5000 caractères
"Build up to a powerful chorus with harmonies"
input.styleRequisstringStyle musical de l’extension. Obligatoire
V4 : max. 200 caractères V5_5, V5, V4_5PLUS, V4_5ALL, V4_5 : max. 1000 caractères
"Pop Rock, Uplifting"
input.titleOptionnelstringTitre de la piste prolongée. Obligatoire
Longueur maximale : 80 caractères
"Rise Again (Extended)"
input.vocalGenderOptionnelstringGenre vocal pour l’extension.
Options disponibles :
"f"
input.personaIdOptionnelstringID de persona pour le morceau généré.
N’est effectif que lorsque customMode=true.
"1234567890"
input.negativeTagsOptionnelstringStyles ou caractéristiques à exclure de la génération.
N’est effectif que lorsque customMode=true.
"aggressive, heavy metal, screaming"
input.styleWeightOptionnelnumberDegré de strict respect du style. Plage : 0.0-1.0
N’est effectif que lorsque customMode=true. Ignoré lorsque customMode=false. Nombre compris entre 0.00 et 1.00. Doit utiliser des incréments de 0.01. Les valeurs booléennes ne sont pas acceptées.
0.5
input.weirdnessConstraintOptionnelnumberContrôle le niveau de créativité. Des valeurs plus élevées produisent des résultats plus expérimentaux. Plage : 0.0-1.0
N’est effectif que lorsque customMode=true. Ignoré lorsque customMode=false. Nombre compris entre 0.00 et 1.00. Doit utiliser des incréments de 0.01. Les valeurs booléennes ne sont pas acceptées.
0.3
input.audioWeightOptionnelnumberPoids de l’influence audio pour la génération. Plage : 0.0-1.0
N’est effectif que lorsque customMode=true. Ignoré lorsque customMode=false. Nombre compris entre 0.00 et 1.00. Doit utiliser des incréments de 0.01. Les valeurs booléennes ne sont pas acceptées.
0.5
1curl -X POST "https://api.apipass.dev/api/v1/jobs/createTask" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "suno/extend",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "audioId": "abc123-def456-ghi789",
9 "continueAt": 120,
10 "prompt": "Build up to a powerful chorus with harmonies and drums",
11 "style": "Pop Rock, Uplifting, Anthemic",
12 "title": "Rise Again (Extended)"
13 }
14 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_extend_xyz789"
6 }
7}codeCode d’état, 200 en cas de réussite
messageMessage de réponse
data.taskIdID de tâche pour consulter l’état de l’extension
