Usa Suno en Hermes Agent.
Suno genera canciones completas a partir de prompts de texto — letra, melodía, instrumentación y voz — o música instrumental. Hermes Agent lo llama a través del proveedor custom:runapi — la misma clave y URL base configuradas para chat. Disponible en versiones V4.5 a V5.5. Las tareas son asíncronas — consulta el task_id hasta que la canción esté lista.
Usa RunAPI para generar música con Suno a través de Hermes Agent.
Requisitos:
- Usa el proveedor custom:runapi ya configurado en Hermes Agent
- Llama al endpoint music_generation de RunAPI en https://runapi.ai/api/v1/suno/music_generation
- Establece model en "suno-v4.5"
- La variable de entorno RUNAPI_API_KEY proporciona la autorización
- Opcionalmente establece make_instrumental en true para música sin letra
- La respuesta es asíncrona — consulta el task_id devuelto hasta que el estado sea completado
curl -X POST https://runapi.ai/api/v1/suno/music_generation \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v4.5",
"prompt": "Upbeat indie folk song about exploring mountain trails at dawn, acoustic guitar and light percussion"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "suno-v4.5"
}
Usa Suno en Hermes Agent en tres pasos
Configura RunAPI
Establece la variable de entorno RUNAPI_API_KEY. Si ya añadiste RunAPI como proveedor custom:runapi en Hermes Agent para chat, la misma clave y base_url gestionan también las solicitudes de música de Suno.
export RUNAPI_API_KEY=runapi_xxx
Llama a Suno
Envía un POST al endpoint music_generation con model suno-v4.5. Incluye un prompt descriptivo — especifica género, estado de ánimo e instrumentos. Opcionalmente establece make_instrumental en true para música sin letra.
POST /api/v1/suno/music_generation
Obtén el resultado
El endpoint devuelve un task_id con estado pendiente. Consulta el endpoint de estado de la tarea hasta que el estado cambie a completado y luego recupera la URL del archivo de música de la respuesta.
task_id: tsk_abc123
Parámetros de la API de Suno
| Parâmetro | Tipo | Descrição |
|---|---|---|
model |
string |
Obligatorio. suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5 o suno-v5.5. |
prompt |
string |
Descripción de texto de la música a generar — género, estado de ánimo, instrumentos, temática. |
make_instrumental |
boolean |
Opcional. Cuando es true, genera música instrumental sin letra. Por defecto false. |
title |
string |
Opcional. Título de la canción. |
style |
string |
Opcional. Estilo musical, p. ej. indie folk, jazz, electronic. |
callback_url |
string |
Opcional. URL de webhook para notificación de finalización asíncrona. |
O que é Suno no Hermes Agent?
Suno é um gerador de texto para música que produz músicas completas com vocais, instrumentos e produção. Hermes Agent o chama via RunAPI custom provider para etapas de geração musical em pipelines de conteúdo automatizados.
Casos de uso do Suno
Caderno de rascunhos de composição antes da produção em estúdio
Descreva um conceito de música — gênero, clima, andamento, tema — e ouça como uma demo completa.
Covers de IA em novos estilos
Pegue uma faixa existente e reestilize via endpoint cover_audio em um novo gênero ou clima.
Pipelines completos de conteúdo audiovisual
Encadeie Suno com modelos de vídeo em um workflow Hermes Agent — gere música, depois vídeo, depois combine.
Preguntas sobre Suno + Hermes Agent
Sí. Llama al endpoint music_generation con model suno-v4.5 o suno-v5 a través del proveedor custom:runapi. La misma RUNAPI_API_KEY que usas para chat gestiona también las solicitudes de música de Suno.
Suno V4 y V4.5 son los modelos de generación de música de propósito general. V4.5 All y V4.5 Plus ofrecen mayor calidad y duración extendida. V5 y V5.5 son los modelos más recientes con mejor calidad de audio y coherencia musical.
Sí. Establece el parámetro make_instrumental en true en el cuerpo de la solicitud. El modelo generará música instrumental sin letra cantada.
Suno se factura por tarea en RunAPI. El coste varía según la versión del modelo. Consulta la página de precios de RunAPI para las tarifas actuales. Sin suscripción ni gasto mínimo.
La API devuelve un task_id de inmediato. Consulta el endpoint de estado de la tarea a intervalos regulares hasta que el campo status cambie a completado. Luego recupera la URL del archivo de música de la salida de la respuesta.
Configuración general de Hermes Agent
¿Aún no lo has configurado? Empieza con la guía de configuración de RunAPI para Hermes Agent.
Guía de configuración de Hermes Agent →Catálogo de modelos Suno
Ver todas las variantes de Suno, precios y documentación de la API.
Modelos de Suno →Prueba Suno en Hermes Agent hoy.
Obtén una clave RunAPI gratuita, configura el proveedor custom:runapi y empieza a generar música con Suno desde Hermes Agent.