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 generate musicSuno | Starter | 1per run | $0.005 | - | - |
Guide complet d'utilisation de Suno
Via ApiPass, `suno/generate` transforme une simple description en morceau complet. Chanson avec voix, instrumental, musique publicitaire ou maquette rapide : ApiPass fournit une API de tâches unifiée, la consultation asynchrone et des webhooks stables pour passer facilement du prototype à la production.
Suno Generate est la capacité texte-vers-musique de Suno. À partir d'un prompt, vous pouvez produire un morceau entier en définissant le style, le titre, le mode instrumental et le genre de voix. En mode avancé, vous pouvez aussi contrôler l'intensité du style, le niveau de créativité et les tags à exclure. Avec ApiPass, les développeurs accèdent à Suno V5_5, V4.5PLUS, V4.5ALL, V4.5 et V4 via une seule interface API.
Une phrase décrivant un thème, une ambiance, un tempo ou une scène suffit pour générer une chanson complète. C'est utile pour l'exploration créative, les contenus marketing rapides et les produits qui proposent une expérience de création musicale guidée par prompt.
Quand vous avez besoin de plus de contrôle, activez `customMode` et fournissez `style` et `title`. Cela améliore la cohérence des genres, des noms et des workflows de production en série.
Comme la génération prend généralement plusieurs dizaines de secondes, ApiPass expose Suno via un workflow asynchrone. Vous pouvez interroger `/api/v1/jobs/recordInfo` ou définir `callBackUrl` pour déclencher votre pipeline dès que le résultat est prêt.
Générez des chansons complètes comprenant des voix chantées par l'IA avec des paroles cohérentes qui correspondent à votre prompt. Le modèle Suno V5_5 crée des voix au son naturel dans plusieurs langues et styles.
Créez des pistes purement instrumentales sans voix. Parfait pour la musique de fond, les bandes sonores de jeux, les applications de méditation et tout cas d'utilisation nécessitant de la musique sans paroles.
Prise en charge de centaines de genres musicaux, de la pop, du rock et du hip-hop à la musique classique, électronique et du monde. Combinez plusieurs styles et utilisez des balises négatives pour exclure les éléments indésirables.
Choisissez entre des voix masculines et féminines pour correspondre à votre vision créative. L'IA offre des voix au son naturel qui s'adaptent au style musical.
Affinez vos créations avec les paramètres de poids du style, de contrainte d'étrangeté et de poids audio. Trouvez l'équilibre entre le respect strict des prompts et l'exploration créative.
Ces scénarios s'intègrent particulièrement bien avec `suno/generate`, les tâches asynchrones et les webhooks.
Permettez à l'utilisateur d'obtenir deux variantes musicales à partir d'un prompt court, idéal pour les outils créatifs et les expériences interactives.
Transformez un angle marketing, une fiche produit ou un message publicitaire en musique thématique exploitable à grande échelle.
Retournez immédiatement un `taskId`, puis recevez le webhook et réinjectez les URLs audio, la cover et les métadonnées dans votre application.
Les variantes multiples se prêtent bien aux workflows éditoriaux avec revue humaine, validation interne et publication contrôlée.
Le bon endpoint dépend de votre point de départ et du niveau de contrôle recherché.
Si vous avez d'abord besoin de paroles structurées, `suno/lyrics` est plus adapté. Si vous voulez directement obtenir une chanson complète avec audio et cover, utilisez `suno/generate`.
`suno/generate` sert à créer un morceau depuis zéro. Pour prolonger un morceau Suno existant, utilisez `suno/extend`; pour réinterpréter un audio existant dans un autre style, `suno/cover` est plus pertinent.
Permettez aux utilisateurs de transformer une idée courte en chanson, d'explorer plusieurs styles et d'écouter rapidement des brouillons exploitables.
Générez automatiquement des morceaux à partir d'un angle de campagne, d'un texte publicitaire ou d'une fiche produit pour alimenter vos contenus promotionnels.
Créez rapidement des maquettes musicales pour des scènes, personnages ou événements dans un jeu ou une application interactive.
Intégrez Suno Generate à des files de jobs, à un CMS ou à des automatisations serveur afin de produire les résultats en arrière-plan et de les restituer ensuite aux utilisateurs.
Créez votre clé dans le tableau de bord ApiPass. Elle servira à authentifier toutes les requêtes `suno/generate`.
Envoyez une requête vers `/api/v1/jobs/createTask` avec `model: "suno/generate"` et les paramètres souhaités dans `input`. L'API renvoie immédiatement une `taskId`.
Utilisez `taskId` avec `/api/v1/jobs/recordInfo`, ou définissez `callBackUrl` pour recevoir automatiquement les URLs audio, l'image de couverture et les métadonnées quand la génération est terminée.
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 de génération musicale 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/generate",
9 "callBackUrl": "https://your-domain.com/api/callback",
10 "input": {
11 "prompt": "A catchy pop song about summer love with upbeat tempo and cheerful melody",
12 "customMode": false,
13 "instrumental": false,
14 "vocalGender": "f"
15 }
16});
17
18console.log(task.data.taskId);L’API accepte une charge utile JSON avec la structure suivante :
1{
2 "model": "suno/generate",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 |V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "prompt": "string",
7 "customMode": "boolean",
8 "instrumental": "boolean",
9 "style": "string",
10 "title": "string",
11 "vocalGender": "m | f",
12 "negativeTags": "string",
13 "styleWeight": "number",
14 "weirdnessConstraint": "number",
15 "audioWeight": "number"
16 },
17 "channel": "auto"
18}modelRequisstringIdentifiant du modèle pour la génération musicale Suno V5
"suno/generate"
callBackUrlOptionnelstringURL destinée à recevoir les notifications webhook lorsque la génération 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 fournisseurs :
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 indicateurs 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 la génération musicale :
input.model_versionOptionnelstringVersion du modèle Suno à utiliser. Par défaut : V5.
Options disponibles :
"V5"
input.promptOptionnelstringDescription textuelle de la musique à générer. Requise lorsque customMode est false, ou lorsque customMode est true et instrumental est false.
customMode=false : prompt est requis, 500 caractères maximum. customMode=true + instrumental=false : prompt est requis. customMode=true + instrumental=true : prompt est facultatif. Pour customMode=true : V4 : 3000 caractères maximum ; V5_5, V5, V4_5PLUS, V4_5ALL, V4_5 : 5000 caractères maximum
"Une chanson pop accrocheuse sur un amour d’été avec un tempo entraînant"
input.customModeOptionnelbooleanActiver le mode personnalisé pour plus de contrôle. Lorsque la valeur est true, style et title sont requis.
Lorsque customMode=false, style et title sont ignorés et ne seront pas envoyés au fournisseur.
Modes de paramètres :
customMode=false + instrumental=false
promptcustomMode=false + instrumental=true
promptcustomMode=true + instrumental=false
styletitlepromptcustomMode=true + instrumental=true
styletitlepromptfalse
input.instrumentalOptionnelbooleanGénérer de la musique instrumentale sans voix.
false
input.styleOptionnelstringStyle/genre musical. Requis lorsque customMode est true.
Requis lorsque customMode=true. Ignoré lorsque customMode=false. V4 : 200 caractères maximum ; V5_5, V5, V4_5PLUS, V4_5ALL, V4_5 : 1000 caractères maximum
"Pop, entraînant, ambiance estivale"
input.titleOptionnelstringTitre de la musique générée. Requis lorsque customMode est true.
Longueur maximale : 80 caractères
"Amour d’été"
input.vocalGenderOptionnelstringGenre des voix dans la chanson générée.
Effectif uniquement lorsque customMode=true.
Options disponibles :
"f"
input.personaIdOptionnelstringID de persona pour la chanson générée.
Effectif uniquement lorsque customMode=true.
"1234567890"
input.negativeTagsOptionnelstringStyles ou caractéristiques à exclure de la génération.
Effectif uniquement lorsque customMode=true.
"agressif, heavy metal, cris"
input.styleWeightOptionnelnumberDegré de respect du style. Plage : 0.0-1.0
Effectif uniquement 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
Effectif uniquement 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
Effectif uniquement 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_abc123xyz"
6 }
7}codeCode d’état, 200 en cas de succès
messageMessage de réponse
data.taskIdID de tâche unique pour interroger l’état et les résultats
Lorsque la génération est terminée, une requête POST est envoyée à votre callBackUrl
1{
2 "code": 200,
3 "data": {
4 "taskId": "task_abc123xyz",
5 "state": "success",
6 "completeTime": 1755599644000,
7 "costTime": 45000,
8 "createTime": 1755599599000,
9 "model": "suno/generate",
10 "resultJson": {
11 "data": [
12 {
13 "id": "audio_001",
14 "audio_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_audio.mp3",
15 "image_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_cover.jpeg",
16 "duration": 180.5,
17 "title": "Summer Love",
18 "style": "Pop"
19 },
20 {
21 "id": "audio_002",
22 "audio_url": "https://cdn.apipass.dev/results/task_abc123xyz_1_audio.mp3",
23 "image_url": "https://cdn.apipass.dev/results/task_abc123xyz_1_cover.jpeg",
24 "duration": 175.2,
25 "title": "Summer Love",
26 "style": "Pop"
27 }
28 ]
29 }
30 },
31 "msg": "Task completed successfully."
32}1{
2 "code": 501,
3 "data": {
4 "taskId": "task_abc123xyz",
5 "state": "fail",
6 "failCode": "GENERATION_FAILED",
7 "failMsg": "Music generation failed due to content policy violation"
8 },
9 "msg": "Task failed."
10}client.jobs.recordInfoInterroger l’état d’une tâche et récupérer la musique générée
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_abc123xyz");
8
9console.log(result.data.state);
10console.log(result.data.resultJson);1{
2 "code": 200,
3 "data": {
4 "taskId": "task_abc123xyz",
5 "state": "success",
6 "resultJson": {
7 "data": [
8 {
9 "id": "audio_001",
10 "audio_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_audio.mp3",
11 "image_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_cover.jpeg",
12 "duration": 180.5
13 }
14 ]
15 }
16 }
17}codeCode d’état, 200 en cas de succès
data.taskIdL’ID de la tâche
data.stateÉtat actuel : queuing, generating, success ou fail
data.resultJson.dataTableau des pistes audio générées avec URL et 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 de génération musicale Suno V5
L’API accepte une charge utile JSON avec la structure suivante :
1{
2 "model": "suno/generate",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 |V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "prompt": "string",
7 "customMode": "boolean",
8 "instrumental": "boolean",
9 "style": "string",
10 "title": "string",
11 "vocalGender": "m | f",
12 "negativeTags": "string",
13 "styleWeight": "number",
14 "weirdnessConstraint": "number",
15 "audioWeight": "number"
16 },
17 "channel": "auto"
18}modelRequisstringIdentifiant du modèle pour la génération musicale Suno V5
"suno/generate"
callBackUrlOptionnelstringURL destinée à recevoir les notifications webhook lorsque la génération 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 fournisseurs :
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 indicateurs 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 la génération musicale :
input.model_versionOptionnelstringVersion du modèle Suno à utiliser. Par défaut : V5.
Options disponibles :
"V5"
input.promptOptionnelstringDescription textuelle de la musique à générer. Requise lorsque customMode est false, ou lorsque customMode est true et instrumental est false.
customMode=false : prompt est requis, 500 caractères maximum. customMode=true + instrumental=false : prompt est requis. customMode=true + instrumental=true : prompt est facultatif. Pour customMode=true : V4 : 3000 caractères maximum ; V5_5, V5, V4_5PLUS, V4_5ALL, V4_5 : 5000 caractères maximum
"Une chanson pop accrocheuse sur un amour d’été avec un tempo entraînant"
input.customModeOptionnelbooleanActiver le mode personnalisé pour plus de contrôle. Lorsque la valeur est true, style et title sont requis.
Lorsque customMode=false, style et title sont ignorés et ne seront pas envoyés au fournisseur.
Modes de paramètres :
customMode=false + instrumental=false
promptcustomMode=false + instrumental=true
promptcustomMode=true + instrumental=false
styletitlepromptcustomMode=true + instrumental=true
styletitlepromptfalse
input.instrumentalOptionnelbooleanGénérer de la musique instrumentale sans voix.
false
input.styleOptionnelstringStyle/genre musical. Requis lorsque customMode est true.
Requis lorsque customMode=true. Ignoré lorsque customMode=false. V4 : 200 caractères maximum ; V5_5, V5, V4_5PLUS, V4_5ALL, V4_5 : 1000 caractères maximum
"Pop, entraînant, ambiance estivale"
input.titleOptionnelstringTitre de la musique générée. Requis lorsque customMode est true.
Longueur maximale : 80 caractères
"Amour d’été"
input.vocalGenderOptionnelstringGenre des voix dans la chanson générée.
Effectif uniquement lorsque customMode=true.
Options disponibles :
"f"
input.personaIdOptionnelstringID de persona pour la chanson générée.
Effectif uniquement lorsque customMode=true.
"1234567890"
input.negativeTagsOptionnelstringStyles ou caractéristiques à exclure de la génération.
Effectif uniquement lorsque customMode=true.
"agressif, heavy metal, cris"
input.styleWeightOptionnelnumberDegré de respect du style. Plage : 0.0-1.0
Effectif uniquement 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
Effectif uniquement 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
Effectif uniquement 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/generate",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "prompt": "A catchy pop song about summer love with upbeat tempo and cheerful melody",
9 "customMode": false,
10 "instrumental": false,
11 "vocalGender": "f"
12 }
13 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_abc123xyz"
6 }
7}codeCode d’état, 200 en cas de succès
messageMessage de réponse
data.taskIdID de tâche unique pour interroger l’état et les résultats
