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 upload-extend musicSuno | Starter | 1per run | $0.005 | - | - |
Guide complet d'utilisation de Suno
Téléversez n’importe quel fichier audio et prolongez-le avec une continuation générée par IA qui s’harmonise parfaitement avec votre source.
L’API Upload & Extend vous permet de téléverser n’importe quel fichier audio et de laisser l’IA générer une continuation qui prolonge la musique. Contrairement à l’API d’extension standard (qui fonctionne avec des pistes générées par Suno), cette API fonctionne avec n’importe quelle source audio : vos propres enregistrements, de la musique provenant d’autres outils ou tout fichier audio. L’IA analyse l’audio téléversé pour en comprendre le style, le tempo, la tonalité et l’ambiance, puis génère un nouveau contenu qui reprend naturellement là où l’audio source s’arrête, ou à partir de tout point spécifié.
Laissez l’IA analyser votre audio et générer automatiquement une continuation cohérente. L’IA déduit le style, le tempo et l’ambiance à partir de l’audio source pour une extension fluide.
Gardez le contrôle en spécifiant le point de départ, le style, le titre et le prompt. Orientez l’IA pour prolonger votre audio dans une direction précise tout en conservant la cohérence avec la source.
Fonctionne avec n’importe quelle source audio : vos propres enregistrements, exports DAW, samples ou musique générée par des tiers. L’audio n’a pas besoin d’avoir été généré par Suno.
L’IA analyse automatiquement votre audio pour comprendre le tempo, la tonalité, le style et l’instrumentation, afin de produire des extensions au rendu naturel.
Prolongez votre audio à partir de n’importe quel point. Ajoutez de nouvelles sections au milieu d’un morceau, étendez l’outro ou continuez à partir d’un moment précis.
Utilisez des prompts et des paramètres de style pour orienter le développement de l’extension. Conservez l’ambiance originale ou faites évoluer le morceau vers quelque chose de nouveau.
Prolongez vos propres fichiers audio en quelques étapes seulement
Téléversez le fichier audio que vous souhaitez prolonger. Prend en charge les formats MP3, WAV, OGG, M4A et FLAC jusqu’à 50MB.
Utilisez le mode automatique pour des extensions rapides ou le mode personnalisé pour contrôler précisément la continuation.
En mode personnalisé, spécifiez le point continueAt, le style, le titre et, éventuellement, un prompt décrivant l’extension.
Soumettez la requête. L’IA analyse votre audio et génère une continuation cohérente.
Récupérez la piste étendue, qui inclut votre audio original ainsi que la nouvelle continuation générée par IA.
Suivez ces recommandations pour obtenir des résultats optimaux
Des fichiers source de meilleure qualité avec un son clair donnent de meilleures extensions. Évitez les enregistrements fortement compressés ou bruités.
Définissez continueAt sur des points de transition musicale naturels : fin de phrases, après une section ou pendant des notes tenues pour obtenir les résultats les plus fluides.
Dans les prompts, décrivez comment la musique doit évoluer : monter en énergie, passer à un bridge, créer une outro ou ajouter des éléments spécifiques.
Téléversez vos enregistrements en cours et laissez l’IA vous aider à les finaliser avec des continuations au rendu naturel.
Prenez de l’audio depuis n’importe quelle source et prolongez-le : samples, musique sous licence ou sortie générée par d’autres outils d’IA.
Partez d’un morceau existant et prolongez-le dans de nouvelles directions pour créer des variations et des versions alternatives.
Téléversez de courtes boucles ou segments et prolongez-les en compositions complètes.
Non limité au contenu généré par Suno. Prolongez n’importe quel fichier audio provenant de n’importe quelle source avec une continuation IA de haute qualité.
Une IA avancée comprend les caractéristiques musicales de votre audio source pour créer des extensions naturelles et cohérentes.
API de téléversement de fichiers simple, compatible avec tous les principaux formats audio. Téléversez, prolongez et téléchargez dans un flux de travail 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éez une nouvelle tâche pour étendre un fichier audio importé
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/upload-extend",
9 "callBackUrl": "https://your-domain.com/api/callback",
10 "input": {
11 "audioUrl": "https://your-storage.com/audio/my-song.mp3",
12 "continueAt": 60,
13 "prompt": "Build into an epic chorus with full instrumentation",
14 "style": "Pop Rock, Anthemic",
15 "title": "My Song (Extended)"
16 }
17});
18
19console.log(task.data.taskId);L’API accepte une charge utile JSON avec la structure suivante :
1{
2 "model": "suno/upload-extend",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 |V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "audioUrl": "string (required)",
7 "instrumental": "boolean",
8 "continueAt": "integer",
9 "prompt": "string",
10 "style": "string",
11 "title": "string",
12 "vocalGender": "m | f",
13 "personaId": "string",
14 "negativeTags": "string",
15 "styleWeight": "number",
16 "weirdnessConstraint": "number",
17 "audioWeight": "number"
18 },
19 "channel": "auto"
20}modelRequisstringIdentifiant du modèle pour Suno V5 upload & extend
"suno/upload-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 exécutent 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’il est activé, APIPASS répartit automatiquement les tâches entre les fournisseurs disponibles en fonction des prix 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 exigences de routage personnalisées.
Options disponibles :
auto
Paramètres pour l’importation et l’extension :
input.model_versionOptionnelstringVersion du modèle Suno à utiliser. Par défaut : V5.
Options disponibles :
"V5"
input.audioUrlRequisstringURL du fichier audio à étendre. Doit être une URL accessible publiquement.
"https://your-storage.com/audio/my-song.mp3"
input.instrumentalOptionnelbooleanGénérer une extension instrumentale sans voix.
Facultatif. Par défaut : false. S’il est fourni, doit être un booléen.
false
input.continueAtRequisintegerTemps en secondes auquel démarrer l’extension. Obligatoire. Doit être > 0.
Doit être > 0 lors de l’utilisation de paramètres personnalisés
60
input.promptOptionnelstringDescription de la section étendue.
Obligatoire lorsque instrumental=false. Facultatif lorsque instrumental=true. V4 : max 3000 caractères V5_5, V5, V4_5PLUS, V4_5ALL, V4_5 : max 5000 caractères
"Build to an epic chorus with harmonies"
input.styleRequisstringStyle musical pour 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.titleRequisstringTitre du morceau étendu. Obligatoire
Longueur maximale : 80 caractères
"My Song (Extended)"
personaIdOptionnelinputID de persona. Chaîne facultative. Uniquement effectif lorsque customMode=true.
vocalGenderOptionnelradioChoisissez le genre des voix pour l’extension.
negativeTagsOptionnelinputStyles ou caractéristiques à exclure de l’extension.
styleWeightOptionnelsliderPoids du guidage stylistique pour l’extension.
weirdnessConstraintOptionnelsliderContrôle le niveau de créativité pour l’extension.
audioWeightOptionnelsliderPoids de l’influence audio pour l’extension.
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_upload_ext_xyz789"
6 }
7}codeCode d’état, 200 en cas de succès
messageMessage de réponse
data.taskIdID de tâche pour interroger l’état de l’extension
Lorsque l’extension est terminée, une requête POST est envoyée à votre callBackUrl
1{
2 "code": 200,
3 "data": {
4 "taskId": "task_upload_ext_xyz789",
5 "state": "success",
6 "completeTime": 1755599800000,
7 "costTime": 75000,
8 "model": "suno/upload-extend",
9 "resultJson": {
10 "data": [
11 {
12 "id": "ext_001",
13 "audio_url": "https://cdn.apipass.dev/results/task_upload_ext_xyz789_0_audio.mp3",
14 "image_url": "https://cdn.apipass.dev/results/task_upload_ext_xyz789_0_cover.jpeg",
15 "duration": 180.5
16 }
17 ]
18 }
19 },
20 "msg": "Extension completed successfully."
21}1{
2 "code": 501,
3 "data": {
4 "taskId": "task_upload_ext_xyz789",
5 "state": "fail",
6 "failCode": "INVALID_AUDIO_URL",
7 "failMsg": "Unable to download audio from provided URL"
8 },
9 "msg": "Extension failed."
10}client.jobs.recordInfoInterrogez l’état de la tâche d’extension et récupérez 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_upload_ext_xyz789");
8
9console.log(result.data.state);
10console.log(result.data.resultJson);1{
2 "code": 200,
3 "data": {
4 "taskId": "task_upload_ext_xyz789",
5 "state": "success",
6 "resultJson": {
7 "data": [
8 {
9 "id": "ext_001",
10 "audio_url": "https://cdn.apipass.dev/results/task_upload_ext_xyz789_0_audio.mp3",
11 "image_url": "https://cdn.apipass.dev/results/task_upload_ext_xyz789_0_cover.jpeg",
12 "duration": 180.5
13 }
14 ]
15 }
16 }
17}data.stateÉtat actuel : queuing, generating, success ou fail
data.resultJson.dataTableau contenant la piste audio étendue 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éez une nouvelle tâche pour étendre un fichier audio importé
L’API accepte une charge utile JSON avec la structure suivante :
1{
2 "model": "suno/upload-extend",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 |V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "audioUrl": "string (required)",
7 "instrumental": "boolean",
8 "continueAt": "integer",
9 "prompt": "string",
10 "style": "string",
11 "title": "string",
12 "vocalGender": "m | f",
13 "personaId": "string",
14 "negativeTags": "string",
15 "styleWeight": "number",
16 "weirdnessConstraint": "number",
17 "audioWeight": "number"
18 },
19 "channel": "auto"
20}modelRequisstringIdentifiant du modèle pour Suno V5 upload & extend
"suno/upload-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 exécutent 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’il est activé, APIPASS répartit automatiquement les tâches entre les fournisseurs disponibles en fonction des prix 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 exigences de routage personnalisées.
Options disponibles :
auto
Paramètres pour l’importation et l’extension :
input.model_versionOptionnelstringVersion du modèle Suno à utiliser. Par défaut : V5.
Options disponibles :
"V5"
input.audioUrlRequisstringURL du fichier audio à étendre. Doit être une URL accessible publiquement.
"https://your-storage.com/audio/my-song.mp3"
input.instrumentalOptionnelbooleanGénérer une extension instrumentale sans voix.
Facultatif. Par défaut : false. S’il est fourni, doit être un booléen.
false
input.continueAtRequisintegerTemps en secondes auquel démarrer l’extension. Obligatoire. Doit être > 0.
Doit être > 0 lors de l’utilisation de paramètres personnalisés
60
input.promptOptionnelstringDescription de la section étendue.
Obligatoire lorsque instrumental=false. Facultatif lorsque instrumental=true. V4 : max 3000 caractères V5_5, V5, V4_5PLUS, V4_5ALL, V4_5 : max 5000 caractères
"Build to an epic chorus with harmonies"
input.styleRequisstringStyle musical pour 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.titleRequisstringTitre du morceau étendu. Obligatoire
Longueur maximale : 80 caractères
"My Song (Extended)"
personaIdOptionnelinputID de persona. Chaîne facultative. Uniquement effectif lorsque customMode=true.
vocalGenderOptionnelradioChoisissez le genre des voix pour l’extension.
negativeTagsOptionnelinputStyles ou caractéristiques à exclure de l’extension.
styleWeightOptionnelsliderPoids du guidage stylistique pour l’extension.
weirdnessConstraintOptionnelsliderContrôle le niveau de créativité pour l’extension.
audioWeightOptionnelsliderPoids de l’influence audio pour l’extension.
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/upload-extend",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "audioUrl": "https://your-storage.com/audio/my-song.mp3",
9 "continueAt": 60,
10 "prompt": "Build into an epic chorus with full instrumentation",
11 "style": "Pop Rock, Anthemic",
12 "title": "My Song (Extended)"
13 }
14 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_upload_ext_xyz789"
6 }
7}codeCode d’état, 200 en cas de succès
messageMessage de réponse
data.taskIdID de tâche pour interroger l’état de l’extension
