---
title: "Usa Suno en Hermes Agent con RunAPI — Guía de API de generación de música"
url: "https://runapi.ai/es/hermes-suno.md"
canonical: "https://runapi.ai/es/hermes-suno"
locale: "es"
model: "suno"
---

# 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.

## API example

```bash
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"
  }'

```

### Response

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

```

## How it works

1. **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.
2. **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.
3. **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.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `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. |

## FAQ

### ¿Puedo generar música con Suno desde 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.

### ¿Cuáles son las diferencias entre las versiones 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.

### ¿Suno puede generar música instrumental sin letra?

Sí. Establece el parámetro make_instrumental en true en el cuerpo de la solicitud. El modelo generará música instrumental sin letra cantada.

### ¿Cómo se factura Suno en RunAPI?

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.

### ¿Cómo funciona el polling de tareas para Suno en Hermes Agent?

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.


## Links

- [Guía de configuración de Hermes Agent →](https://runapi.ai/es/hermes-agent)
- [Modelos de Suno →](https://runapi.ai/es/models/suno)
- [Model catalog](https://runapi.ai/es/models)
- [API docs](https://runapi.ai/es/docs)