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

# Usa Suno in OpenClaw.

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. Gli agenti OpenClaw la chiamano con la stessa RUNAPI_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 nel tuo ambiente. Se hai già configurato RunAPI in OpenClaw per la chat, la stessa key funziona per la generazione musicale con Suno — nessuna configurazione aggiuntiva del provider necessaria.
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.

### Quale versione di Suno dovrei usare?

suno-v5.5 è l'ultima versione e produce l'output di qualità più alta con maggiore chiarezza vocale e mixaggio. suno-v4 e suno-v4.5 sono più economici e veloci per le iterazioni di bozza. Tutte le versioni usano lo stesso endpoint text_to_music e gli stessi parametri.

### Quanto tempo richiede la generazione con Suno?

Il tempo di generazione varia in base alla versione e alla durata del brano. Il tempo tipico è da 30 secondi a 2 minuti. L'API restituisce immediatamente un task_id — esegui il polling dell'endpoint di stato o imposta un callback_url per evitare di bloccare il tuo agente.

### 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 controllare il genere vocale e il peso dello stile?

Sì. Imposta vocal_gender su male o female. Usa negative_tags per escludere stili indesiderati. Per un controllo più fine, crea una persona tramite l'endpoint generate_persona e passa il persona_id restituito con persona_type impostato su voice o style.


## Links

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