> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Instructions d'intégration de l'API Suno Style

> Suno Music Generation 集成指南 - XHuoAPI

SUNO nous permet d'entrer des mots-clés pour générer un style de chanson amélioré. Ce document explique comment intégrer l'API concernée.

Cette API n'a qu'un seul paramètre d'entrée, qui est `prompt`, c'est-à-dire le mot-clé de style à optimiser.

Ici, le `prompt` que nous entrons est `A song for Christmas`.

```python theme={null}
import requests

url = "https://api.xhuoapi.ai/v1/suno/style"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "prompt": "A song for Christmas"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)
```

Le résultat est le suivant :

```json theme={null}
{
  "success": true,
  "task_id": "8e887548-7185-48a9-b7cb-e51754f7b87b",
  "trace_id": "ac4ec363-4245-400b-9643-0b6fed8c6b20",
  "data": {
    "upsampled_tags": "Des cloches festives brillantes et une guitare acoustique claire s'ouvrent, avec des grelots et un piano droit chaleureux remplissant le couplet. Des cordes luxuriantes entrent pour le pré-refrain, menant à un refrain plein de groupe rehaussé par des accents de cuivres. Le pont s'adoucit avec un glockenspiel, puis revient à une finale jubilante."
  }
}
```

On peut voir que le champ `upsampled_tags` de `data` est le paramètre de style optimisé en fonction du mot-clé.