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.
Usa RunAPI per generare un brano con Suno.
Requisiti:
- Leggi la API key da RUNAPI_API_KEY.
- Usa il provider custom:runapi con base_url https://runapi.ai/v1.
- Chiama POST https://runapi.ai/api/v1/suno/text_to_music
- Imposta model su "suno-v5.5".
- Imposta vocal_mode su "auto_lyrics" per testi generati dall'AI da un prompt.
- Imposta prompt per descrivere il brano che vuoi.
- Il task è asincrono. Esegui il polling del task_id restituito finché lo status non è "completed".
- Al termine, leggi l'URL audio dall'output della risposta.
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"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "suno-v5.5"
}
Usa Suno in Hermes Agent in tre passaggi
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.
export RUNAPI_API_KEY=runapi_xxx
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.
POST /api/v1/suno/text_to_music
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.
GET /api/v1/suno/text_to_music/tsk_abc123
Parametri API Suno text_to_music
| Parametro | Tipo | Descrizione |
|---|---|---|
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. |
Cos'è Suno su Hermes Agent?
Suno è un generatore testo-a-musica che produce canzoni complete con voce, strumenti e mixaggio da una descrizione testuale o dalle tue stesse parole. Hermes Agent lo chiama tramite il provider custom:runapi, utile per workflow di contenuto multi-step -- generare un video con Kling, poi creare una colonna sonora abbinata con Suno, tutto in un'unica esecuzione dell'agente. Le versioni da v4 a v5.5 sono disponibili poiché Suno non ha API pubblica ufficiale.
Casi d'uso di Suno
Blocco note per la composizione prima della produzione in studio
Descrivere un concept di canzone -- genere, umore, tempo, argomento -- e ricevere una traccia demo completa. Iterare rapidamente sulle idee prima di impegnarsi con il tempo in studio, ascoltando come suonano stili e arrangiamenti diversi.
Cover IA in nuovi stili
Prendere una traccia esistente e ri-stilizzarla tramite l'endpoint cover_audio. Cambiare il genere, cambiare la strumentazione o cambiare l'umore mantenendo la melodia e la struttura di base.
Pipeline di contenuto audiovisivo completo
Concatenare Suno con modelli video in un workflow Hermes Agent -- generare filmati video, poi creare una colonna sonora originale abbinata, producendo contenuto pronto per la pubblicazione senza licenza musicale separata.
Domande su Suno + Hermes Agent
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.
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.
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.
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.
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.
Configurazione generale di Hermes Agent
Non ancora configurato? Inizia con la guida di configurazione RunAPI per Hermes Agent.
Guida di configurazione di Hermes Agent →Catalogo modelli Suno
Vedi tutte le versioni di Suno, i prezzi e gli endpoint disponibili.
Suno su RunAPI →Prova Suno in Hermes Agent oggi.
Ottieni una API key RunAPI gratuita, configura il provider custom:runapi e genera brani completi con voce, strumenti e mixaggio da una descrizione testuale.