---
title: "Usa Suno in Hermes Agent tramite RunAPI — Guida API Musica"
url: "https://runapi.ai/it/hermes-suno.md"
canonical: "https://runapi.ai/it/hermes-suno"
locale: "it"
model: "suno"
---

# Usa Suno in Hermes Agent.

Suno genera brani completi — voce, strumenti e mixaggio — da un prompt testuale o testo esatto. Le versioni dalla v4 alla v5.5 sono disponibili tramite RunAPI, che fornisce accesso API poiché Suno non ha una API pubblica ufficiale. Hermes Agent la chiama tramite il provider custom:runapi con la stessa API key usata per la chat.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v5.5",
    "vocal_mode": "auto_lyrics",
    "prompt": "An upbeat indie pop track about coding late at night, warm synths and acoustic guitar",
    "vocal_gender": "female"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "suno-v5.5"
}

```

## How it works

1. **Configura RunAPI** — Imposta RUNAPI_API_KEY nell'ambiente in cui Hermes Agent viene eseguito. Se hai già aggiunto RunAPI come provider custom:runapi, la stessa key e base_url gestiscono le richieste musicali di Suno.
2. **Chiama text_to_music** — Invia una POST all'endpoint text_to_music con il modello e vocal_mode. Usa auto_lyrics con un prompt per testi scritti dall'AI, exact_lyrics con testo/stile/titolo per le tue parole, o instrumental con stile/titolo per brani senza voce.
3. **Ottieni il risultato** — L'endpoint restituisce immediatamente un task_id. La generazione del brano richiede da 30 secondi a diversi minuti a seconda della versione. Esegui il polling dell'endpoint di stato del task finché lo stato non cambia in completed, poi leggi l'URL audio di output.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5 o suno-v5.5. |
| `vocal_mode` | `string` | Obbligatorio. auto_lyrics (AI scrive il testo dal prompt), exact_lyrics (fornisci testo/stile/titolo) o instrumental (senza voce, richiede stile/titolo). |
| `prompt` | `string` | Descrizione del brano per la modalità auto_lyrics. Descrivi genere, atmosfera, ritmo e tema. Non consentito nelle modalità exact_lyrics e instrumental. |
| `lyrics` | `string` | Testo esatto da cantare. Obbligatorio per la modalità exact_lyrics. Non consentito nelle modalità auto_lyrics e instrumental. |
| `style` | `string` | Descrizione dello stile musicale, ad es. lo-fi hip hop, synthwave anni '80. Obbligatorio per le modalità exact_lyrics e instrumental. |
| `title` | `string` | Titolo del brano. Obbligatorio per le modalità exact_lyrics e instrumental. |
| `vocal_gender` | `string` | Facoltativo. male o female. |
| `negative_tags` | `string` | Facoltativo. Stili da evitare, ad es. heavy metal, screaming. |
| `duration_seconds` | `integer` | Facoltativo. Durata target in secondi. |
| `persona_id` | `string` | Facoltativo. ID persona per profili vocali o di stile personalizzati. |
| `persona_type` | `string` | Facoltativo. style o voice. Seleziona la categoria della persona. |
| `callback_url` | `string` | Facoltativo. URL webhook che riceve una POST quando il task è completato. |

## FAQ

### Qual è la differenza tra auto_lyrics, exact_lyrics e instrumental?

auto_lyrics genera il testo dalla tua descrizione — descrivi il brano e Suno scrive le parole. exact_lyrics usa il testo che fornisci letteralmente, e richiede i campi style e title. instrumental produce un brano senza voce, usando solo style e title.

### Come configuro RunAPI come provider personalizzato in Hermes Agent per Suno?

Aggiungi un provider custom:runapi nella configurazione di Hermes Agent con base_url impostato su https://runapi.ai/v1 e api_key che legge da RUNAPI_API_KEY. Lo stesso provider gestisce chat, immagini, video ed endpoint musicali — nessuna configurazione separata per Suno.

### RunAPI fornisce una API ufficiale Suno?

Suno non offre una API pubblica. RunAPI fornisce accesso programmatico a Suno dalla v4 alla v5.5 tramite la stessa API key e lo stesso ciclo di vita dei task usati per tutti gli altri modelli RunAPI. Non è necessario un account Suno o credenziali separate.

### Posso generare brani strumentali senza voce?

Sì. Imposta vocal_mode su instrumental e fornisci i campi style e title. I campi prompt e lyrics devono essere omessi nella modalità instrumental. L'API applica queste regole sui campi incrociati e restituisce un errore di validazione se vengono inviati campi in conflitto.

### Quali altri endpoint Suno sono disponibili oltre a text_to_music?

RunAPI espone cover_audio (reinterpreta una traccia esistente), extend_music (continua un brano da un timestamp), create_mashup (combina elementi da più tracce), text_to_sound (effetti sonori) e endpoint utility come generate_lyrics, generate_persona e separate_audio_stems. Tutti condividono la stessa API key e lo stesso ciclo di vita dei task.


## Links

- [Guida di configurazione di Hermes Agent →](https://runapi.ai/it/hermes-agent)
- [Suno su RunAPI →](https://runapi.ai/it/models/suno)
- [Model catalog](https://runapi.ai/it/models)
- [API docs](https://runapi.ai/it/docs)