curl --request POST \
  --url https://api.evolink.ai/v1/audios/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "suno-v6-beta",
  "prompt": "A cheerful summer pop song about road trips and freedom"
}
'

{
  "created": 1766319090,
  "id": "task-unified-1766319089-oqs9cue4",
  "model": "suno-v6-beta",
  "object": "audio.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "audio",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 10,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: suno-v5-beta",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

{
  "error": {
    "code": "service_unavailable",
    "message": "No available channel for the requested model",
    "type": "api_error"
  }
}

Suno

Suno Music Generation Beta

Modèle de génération musicale Suno AI, prend en charge la génération de musique complète à partir de descriptions textuelles ou de paroles
Prend en charge le mode personnalisé (contrôle précis du style, du titre, des paroles) et le mode simple (génération automatique par l’IA)
Prend en charge la fonctionnalité Persona, permettant de réutiliser des caractéristiques vocales/stylistiques créées précédemment
Mode de traitement asynchrone, utilisez l’ID de tâche retourné pour consulter le statut
Les liens audio générés sont valides pendant 72 heures, veuillez les sauvegarder rapidement
Chaque requête génère plusieurs variations musicales

POST

audios

generations

curl --request POST \
  --url https://api.evolink.ai/v1/audios/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "suno-v6-beta",
  "prompt": "A cheerful summer pop song about road trips and freedom"
}
'

{
  "created": 1766319090,
  "id": "task-unified-1766319089-oqs9cue4",
  "model": "suno-v6-beta",
  "object": "audio.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "audio",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 10,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: suno-v5-beta",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

{
  "error": {
    "code": "service_unavailable",
    "message": "No available channel for the requested model",
    "type": "api_error"
  }
}

Autorisations

Authorization

string

header

requis

##Toutes les API nécessitent une authentification Bearer Token##

Obtenir une clé API :

Visitez la Page de gestion des clés API pour obtenir votre clé API

Ajouter à l'en-tête de requête :

Authorization: Bearer YOUR_API_KEY

Corps

application/json

model

enum<string>

requis

Nom du modèle

Compatibilité ascendante : Les noms de modèles précédemment intégrés (ex: suno-v5, suno-v4.5, suno-v4.5plus, suno-v4.5all, suno-v4) restent utilisables et sont automatiquement mappés vers les versions -beta correspondantes

Options disponibles :

suno-v6-beta : V6 (recommandé par défaut), voix plus naturelles, détails plus riches et expression musicale renforcée ; prend en charge Persona et la durée personnalisée, prompt max 5000 caractères, style max 1000 caractères ; nom de modèle compatible : suno-v6
suno-v6-mini-beta : V6 Mini, version légère et rapide équilibrant qualité et vitesse ; prend en charge Persona, prompt max 5000 caractères, style max 1000 caractères ; nom de modèle compatible : suno-v6-mini
suno-v6-wild-beta : V6 Wild, dépasse les conventions avec des styles plus audacieux et distinctifs ; prend en charge Persona et la durée personnalisée, prompt max 5000 caractères, style max 1000 caractères ; nom de modèle compatible : suno-v6-wild
suno-v5.5-beta : V5.5 avec des modèles adaptés à vos préférences, prompt max 5000 caractères, style max 1000 caractères ; nom de modèle compatible : suno-v5.5
suno-v5-beta : Version V5, prend en charge Voice Persona, expression musicale supérieure, génération plus rapide, prompt max 5000 caractères, style max 1000 caractères
suno-v4.5plus-beta : Version améliorée V4.5+, tonalités plus riches, nouvelles méthodes créatives, jusqu'à 8 minutes, prompt max 5000 caractères, style max 1000 caractères
suno-v4.5all-beta : Version complète V4.5, prompts plus intelligents, génération plus rapide, jusqu'à 8 minutes, prompt max 5000 caractères, style max 1000 caractères
suno-v4.5-beta : Version V4.5, prompts plus intelligents, génération plus rapide, jusqu'à 8 minutes, prompt max 5000 caractères, style max 1000 caractères
suno-v4-beta : Version V4, qualité vocale améliorée, jusqu'à 4 minutes, prompt max 3000 caractères, style max 200 caractères

Options disponibles:

suno-v6-beta,

suno-v6-mini-beta,

suno-v6-wild-beta,

suno-v5.5-beta,

suno-v5-beta,

suno-v4.5plus-beta,

suno-v4.5all-beta,

suno-v4.5-beta,

suno-v4-beta

Exemple:

"suno-v6-beta"

custom_mode

boolean

défaut:false

Activer le mode personnalisé

Description :

false : Mode simple, fournissez uniquement le prompt, l'IA génère automatiquement les paroles et le style
true : Mode personnalisé, permet un contrôle précis du style, du title, des paroles, etc.

Paramètres requis en mode personnalisé :

style : Requis
title : Requis
prompt : Requis lorsque instrumental=false (utilisé comme paroles)

En mode simple (custom_mode=false), seul prompt est pris en charge : style, title, negative_tags, vocal_gender, style_weight, weirdness_constraint, audio_weight, persona_id, persona_model, duration ne sont pas pris en charge dans ce mode. L’API ne garantit pas de les rejeter, mais ces paramètres n’ont aucun effet sur le résultat généré — pour un contrôle précis, utilisez custom_mode=true

Exemple:

false

instrumental

boolean

défaut:false

Générer de la musique instrumentale (sans voix)

Description :

false : Générer de la musique avec voix
true : Générer de la musique instrumentale/d'ambiance sans voix

Remarque :

En mode non personnalisé, ce paramètre n'affecte pas les champs requis
En mode personnalisé, lorsqu'il est défini sur true, le prompt devient optionnel

Exemple:

false

prompt

string

Prompt décrivant le contenu musical souhaité

Mode non personnalisé (custom_mode=false) :

Requis, sert de description musicale, l'IA génère automatiquement les paroles et le style
Longueur maximale : 3000 caractères

Mode personnalisé (custom_mode=true) :

Requis lorsque instrumental=false, utilisé comme paroles exactes
Optionnel lorsque instrumental=true
Longueur maximale : 3000 caractères pour V4, 5000 caractères pour V4.5 et versions ultérieures (y compris la famille V6)

Suggestions de format des paroles :

Utilisez des balises comme [Verse], [Chorus], [Bridge] pour organiser la structure des paroles

Exemple:

"A cheerful summer pop song about road trips and freedom"

style

string

Spécification du style musical

Description :

Requis en mode personnalisé (custom_mode=true)
Définit le genre, l'ambiance ou la direction artistique de la musique
Il est recommandé d'utiliser des balises séparées par des virgules en anglais

Limites de caractères :

V4 : Max 200 caractères
V4.5 et versions ultérieures (y compris la famille V6) : Max 1000 caractères

Balises de style courantes :

Genres : pop, rock, jazz, classical, electronic, hip-hop, r&b, country, folk
Ambiances : happy, sad, energetic, calm, romantic, dark, uplifting
Instruments : piano, guitar, drums, bass, violin, saxophone, synthesizer
Voix : male vocals, female vocals, choir, harmonies
Tempo : slow, fast, upbeat, groovy, 120bpm

Non pris en charge en mode simple (custom_mode=false) : dans ce mode, le style est généré automatiquement par l’IA à partir du prompt, transmettre ce paramètre n’a donc aucun effet.

Exemple:

"pop, electronic, upbeat, female vocals"

title

string

Titre de la chanson

Description :

Requis en mode personnalisé (custom_mode=true)
Sera affiché dans l'interface du lecteur et le nom du fichier
Longueur maximale : 80 caractères

Non pris en charge en mode simple (custom_mode=false) : dans ce mode, le titre est généré automatiquement par l’IA, transmettre ce paramètre n’a donc aucun effet.

Maximum string length: 80

Exemple:

"Summer Dreams"

negative_tags

string

Styles exclus, spécifiez les styles musicaux ou caractéristiques à éviter

Description :

Longueur maximale : 200 caractères (identique pour tous les modèles)

Exemples :

heavy metal, screaming, sad
rap, fast tempo

Pris en charge uniquement lorsque custom_mode=true ; en mode simple, sa transmission n’a aucun effet.

Maximum string length: 200

Exemple:

"heavy metal, screaming"

vocal_gender

enum<string>

Préférence de genre vocal

Options :

m : Voix masculine
f : Voix féminine

Remarque :

Effectif uniquement lorsque custom_mode=true
Ce paramètre augmente seulement la probabilité, il ne peut pas garantir que le genre spécifié sera respecté
Non pris en charge en mode simple (custom_mode=false), sa transmission n’a aucun effet

Options disponibles:

m,

f

Exemple:

"f"

style_weight

number

Poids du style, contrôle le respect du style spécifié

Plage : 0.0 ~ 1.0, jusqu’à deux décimales et multiple de 0.01

Description :

Des valeurs plus élevées renforcent le respect du style spécifié
0 est une valeur valide, signifie aucune adhérence au style spécifié et est transmis au modèle

Pris en charge uniquement lorsque custom_mode=true ; en mode simple, sa transmission n’a aucun effet.

Plage requise: 0 <= x <= 1Doit être un multiple de 0.01

Exemple:

0.7

weirdness_constraint

number

Contrainte d’originalité, contrôle le degré de créativité/d’expérimentation de la sortie

Plage : 0.0 ~ 1.0, jusqu’à deux décimales et multiple de 0.01

Description :

Des valeurs plus élevées produisent une sortie plus créative et expérimentale
Des valeurs plus basses produisent une sortie plus traditionnelle et conservatrice
0 est une valeur valide et est transmis au modèle

Pris en charge uniquement lorsque custom_mode=true ; en mode simple, sa transmission n’a aucun effet.

Plage requise: 0 <= x <= 1Doit être un multiple de 0.01

Exemple:

0.3

audio_weight

number

Poids audio, contrôle le poids des caractéristiques audio

Plage : 0.0 ~ 1.0, jusqu’à deux décimales et multiple de 0.01

Description :

0 est une valeur valide et est transmis au modèle

Pris en charge uniquement lorsque custom_mode=true ; en mode simple, sa transmission n’a aucun effet.

Plage requise: 0 <= x <= 1Doit être un multiple de 0.01

Exemple:

0.5

persona_id

string

Persona ID, applique un Persona précédemment créé à cette génération musicale

Disponible uniquement lorsque custom_mode=true. Obtenu via l'API Création de Persona Suno, permet de maintenir des caractéristiques vocales et stylistiques cohérentes

Comment l'obtenir : Après l'achèvement de la tâche de création de Persona, récupérez-le depuis result_data.persona_id

Non pris en charge en mode simple (custom_mode=false).

Pris en charge uniquement par les modèles des familles V5 et V6 (suno-v5-beta / suno-v5.5-beta / suno-v6-beta / suno-v6-mini-beta / suno-v6-wild-beta, y compris leurs noms compatibles sans -beta) ; avec tout autre modèle, sa transmission renvoie une erreur de paramètre.

Exemple:

"5c57d49ef834110496fae5aa14fec441"

persona_model

enum<string>

Mode d’application du Persona

Options :

style_persona : Orienté style, privilégie l’arrangement, le rythme et le timbre
voice_persona : Orienté voix, privilégie le timbre, la technique vocale et la tessiture

Les deux modes sont disponibles uniquement avec les modèles des familles V5 et V6 (suno-v5-beta / suno-v5.5-beta / suno-v6-beta / suno-v6-mini-beta / suno-v6-wild-beta, y compris leurs noms compatibles sans -beta) et nécessitent custom_mode=true. Ils doivent être utilisés avec persona_id : transmettre persona_model seul, sans persona_id, n’a aucun effet (persona_id peut être utilisé seul).

Options disponibles:

style_persona,

voice_persona

Exemple:

"style_persona"

duration

integer

Durée audio souhaitée en secondes

Disponible uniquement lorsque custom_mode=true et que le modèle est suno-v5.5-beta, suno-v6-beta, suno-v6-mini-beta ou suno-v6-wild-beta (ou le nom compatible correspondant sans -beta). La valeur doit être un entier de 10 à 360. Les autres modèles et le mode simple ne prennent pas en charge ce paramètre ; sa transmission renvoie une erreur de paramètre.

Le contrôle de la durée varie selon le modèle (au mieux, sans garantie de durée exacte) :

suno-v6-wild-beta, suno-v5.5-beta : Respectent généralement la durée indiquée
suno-v6-beta : Il est recommandé de définir au moins 60 secondes ; les valeurs inférieures à 60 secondes produisent généralement tout de même environ 60 secondes d’audio
suno-v6-mini-beta : Le paramètre de durée n’a actuellement aucun effet ; génère généralement environ 3 minutes de musique

Certaines pistes renvoyées par une même requête peuvent différer de la durée indiquée. Si le paramètre est omis, le modèle détermine la durée (généralement 3 à 6 minutes). La facturation se fait par requête et le coût ne dépend pas de la durée réelle.

Plage requise: 10 <= x <= 360

Exemple:

120

callback_url

string<uri>

URL de rappel HTTPS pour l’état terminal de la tâche

Moment du rappel :

GroAPI envoie un seul rappel lorsque la tâche atteint un état terminal : completed, failed ou cancelled
Les étapes intermédiaires en amont telles que text et first ne sont pas transmises
Le corps du rappel correspond à la structure de détail renvoyée par GET /v1/tasks/{id}

Restrictions de sécurité :

HTTPS uniquement
Les rappels vers les adresses IP internes sont interdits
URL limitée à 2048 caractères

Mécanisme de rappel :

Délai par tentative : 10 secondes
Jusqu’à 3 nouvelles tentatives après l’échec initial
Une réponse 2xx est considérée comme réussie

Exemple:

"https://your-domain.com/webhooks/suno-callback"

Réponse

Tâche musicale créée avec succès

created

integer

Horodatage de création de la tâche

Exemple:

1766319090

string

ID de tâche, utilisé pour interroger le statut et les résultats de la tâche

Exemple:

"task-unified-1766319089-oqs9cue4"

model

string

Nom du modèle réellement utilisé

Exemple:

"suno-v6-beta"

object

enum<string>

Type de tâche

Options disponibles:

audio.generation.task

progress

integer

Pourcentage de progression de la tâche (0-100)

Plage requise: 0 <= x <= 100

Exemple:

0

status

enum<string>

Statut de la tâche

Options disponibles:

pending,

processing,

completed,

failed,

cancelled

Exemple:

"pending"

task_info

object

Détails de la tâche audio

Show child attributes

type

enum<string>

Type de sortie de la tâche

Options disponibles:

audio

Exemple:

"audio"

usage

object

Informations d'utilisation et de facturation

Show child attributes

Série Image

Série Vidéo

Série Audio

Série Texte

Gestion du compte

Gestion des tâches

Gestion des fichiers

Suno Music Generation Beta

Autorisations

Corps

Réponse