Audio

Suno V5

L'API Suno génère de la musique de qualité studio à partir de prompts, de styles et de paroles, renvoyant deux pistes par exécution avec une livraison asynchrone adaptée à la production.

$0.12 / use

2 pistes par exécutionWorkflow asynchroneContrôle du prompt et des parolesMP3 + pochette

Paramètres

Model Version*

Custom Mode*

Activé

Title*

Style of Music*

Lyrics (optional but recommended)

Instrumental Only*

Désactivé

Vocal Gender Preference

Sortie

Le contenu généré apparaîtra ici

Points de terminaison

POSThttps://api.apixo.ai/api/v1/generateTask/sunoCréer une tâche

GEThttps://api.apixo.ai/api/v1/statusTask/suno?taskId={taskId}Statut du sondage

Authentification

Vérification de l'accès API...

Connectez-vous pour réclamer vos crédits gratuits, tester le Playground et passer à l'intégration API.

Corps de la requête

request_type

async

Utilisez callback avec callback_url pour les webhooks.

provider

official

Correspond au manuel de Seedance 2.0.

input

objet

Mode, prompt, références, taille, durée et paramètres audio.

Paramètres

request_typerequis

Typeselect

Use async to poll or callback to receive a webhook when ready.async · callback

callback_urlconditionnel

Typetext

Publicly accessible URL for callback mode.Uniquement en request_type=callback

moderequis

Typeselect

Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS

customModerequis

Typeboolean

Enable to control title/style/lyrics. When off, prompt-only mode is used.

titlerequis

Typetext

Appears in metadata and can steer theme. Required when Custom Mode is on.Uniquement en customMode=

stylerequis

Typestring

Describe genre/mood/instrumentation. Required in Custom Mode.Uniquement en customMode=

promptconditionnel

Typestring

Provide full lyrics for sung output. Required when Instrumental is off.Uniquement en customMode=

songDescriptionrequis

Typestring

Simple mode: one field to steer both style and topic when Custom Mode is off.Uniquement en customMode=

instrumentalrequis

Typeboolean

Turn on to generate backing track without vocals.

negativeTagsconditionnel

Typestring

Negative TagsUniquement en customMode=

styleWeightconditionnel

Typeslider

How strongly to follow the Style description.Uniquement en customMode=

weirdnessConstraintconditionnel

Typeslider

Push creativity/experimentation. Higher = wilder.Uniquement en customMode=

audioWeightconditionnel

Typeslider

Balance audio vs lyrical fidelity. Higher favors audio fidelity.Uniquement en customMode=

vocalGenderconditionnel

Typeselect

Best-effort vocal timbre preference (custom mode only).f · mUniquement en customMode=

Paramètre	Type	Requis	Description
`request_type`	select	requis	Use async to poll or callback to receive a webhook when ready.async · callback
`callback_url`	text	conditionnel	Publicly accessible URL for callback mode.Uniquement en request_type=callback
`mode`	select	requis	Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS
`customMode`	boolean	requis	Enable to control title/style/lyrics. When off, prompt-only mode is used.
`title`	text	requis	Appears in metadata and can steer theme. Required when Custom Mode is on.Uniquement en customMode=
`style`	string	requis	Describe genre/mood/instrumentation. Required in Custom Mode.Uniquement en customMode=
`prompt`	string	conditionnel	Provide full lyrics for sung output. Required when Instrumental is off.Uniquement en customMode=
`songDescription`	string	requis	Simple mode: one field to steer both style and topic when Custom Mode is off.Uniquement en customMode=
`instrumental`	boolean	requis	Turn on to generate backing track without vocals.
`negativeTags`	string	conditionnel	Negative TagsUniquement en customMode=
`styleWeight`	slider	conditionnel	How strongly to follow the Style description.Uniquement en customMode=
`weirdnessConstraint`	slider	conditionnel	Push creativity/experimentation. Higher = wilder.Uniquement en customMode=
`audioWeight`	slider	conditionnel	Balance audio vs lyrical fidelity. Higher favors audio fidelity.Uniquement en customMode=
`vocalGender`	select	conditionnel	Best-effort vocal timbre preference (custom mode only).f · mUniquement en customMode=

Exemple (cURL)

curl -X POST "https://api.apixo.ai/api/v1/generateTask/suno" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "mode": "V5",
    "title": "Neon Freeway Nights",
    "style": "Synthwave, dreamy pop",
    "prompt": "Two verses about cruising the city at midnight under neon rain, feeling hopeful.",
    "songDescription": "A dreamy synthwave song about neon city nights and freedom.",
    "customMode": true,
    "instrumental": false,
    "negativeTags": "off-key vocals, muddy mix",
    "styleWeight": 0.7,
    "weirdnessConstraint": 0.25,
    "audioWeight": 0.6,
    "vocalGender": "f"
  }'

Documentation API complète

Exemples de sorties

Généré avec l'API Suno V5 sur APIXO

2 Pistes

Neon Freeway Nights

Voir

Guide complet

Qu'est-ce que l'API Suno ?

L'API Suno est une interface de génération de texte vers musique conçue pour les flux de production rapides. Elle peut transformer des prompts, des balises de style et des paroles personnalisées en deux chansons complètes avec leurs images de couverture associées.

Cela le rend idéal pour les outils de création, la génération de contenu de marque et la production musicale automatisée, où l'itération rapide prime sur la composition manuelle.

Fonctionnement du flux de génération

Soumettez une requête de génération avec des paramètres de prompt uniquement ou en mode paroles personnalisées.
Recevez le statut de la tâche de manière asynchrone via polling ou un point de terminaison de callback.
En cas de succès, consomme deux pistes générées plus les métadonnées de l'illustration correspondante.

Spécifications techniques de l'API Suno

Caractéristiques opérationnelles pertinentes pour l'intégration du produit et du backend.

Sorties

2 pistes par génération

Surface de contrôle

Style, originalité, poids de l'audio

Modes de génération

Mode prompt uniquement et paroles personnalisées

Livraison

Polling asynchrone ou callback

Capacités clés

Sortie double piste

Chaque génération renvoie deux variantes de chanson, accélérant la sélection A/B et l'itération créative pour les équipes de production.

Curseurs de contrôle créatif

Ajustez le poids du style, l'originalité (weirdness) et le poids audio pour passer de pistes commerciales classiques à des textures expérimentales.

Flux de travail pour paroles et voix

Prend en charge la génération par prompt uniquement et le mode paroles personnalisées avec des préférences optionnelles pour l'instrumental et le genre vocal.

Prêt pour l'intégration asynchrone

Fonctionne avec des stratégies de polling ou de callback, facilitant l'intégration dans les workflows backend basés sur des files d'attente.

Que pouvez-vous construire ?

Génération de musique intégrée

Générez des extraits musicaux de marque et des pistes adaptées aux créateurs pour l'UGC, les vidéos courtes et les outils de création sociale.

Branding de Podcast et Vidéo

Produisez des pistes d'intro et d'outro, des jingles et des motifs thématiques récurrents avec un contrôle de l'ambiance et du rythme.

Bandes sonores pour contenus courts

Créez des musiques de fond personnalisées pour TikTok, Shorts et Reels avec une itération rapide sur le style et les refrains.

Audio pour jeux et interactif

Prototypez des boucles d'ambiance, des thèmes de menu et des idées de partitions légères pour les jeux et les expériences interactives.

Notes et limitations

Chaque génération renvoie exactement deux pistes ; le nombre de sorties ne peut pas être personnalisé.
Le flux de travail du Playground est async-first ; l'orchestration des callbacks est disponible au niveau de l'API.
La longueur du prompt/paroles en mode personnalisé est limitée à 5 000 caractères dans les versions prises en charge.
Le genre et les caractéristiques vocales sont des contrôles basés sur le meilleur effort, pas des garanties strictes.

Questions fréquemment posées

Commencer à intégrer

Essayez le playground ci-dessus, puis consultez la documentation API quand vous serez prêt pour l'intégration.

Essayer le playground Voir la documentation API

Suno V5

Exemples de sorties

Qu'est-ce que l'API Suno ?

Fonctionnement du flux de génération

Spécifications techniques de l'API Suno

Sorties

Surface de contrôle

Modes de génération

Livraison

Capacités clés

Sortie double piste

Curseurs de contrôle créatif

Flux de travail pour paroles et voix

Prêt pour l'intégration asynchrone

Que pouvez-vous construire ?

Génération de musique intégrée

Branding de Podcast et Vidéo

Bandes sonores pour contenus courts

Audio pour jeux et interactif

Notes et limitations

Questions fréquemment posées

Puis-je générer une seule piste au lieu de deux ?

Puis-je forcer un rendu exact des paroles ?

Cette API est-elle synchrone ?

Quel type de fichier est retourné ?

Commencer à intégrer