---
title: "Usa Suno en OpenClaw con RunAPI — Guía de API de música"
url: "https://runapi.ai/es/openclaw-suno.md"
canonical: "https://runapi.ai/es/openclaw-suno"
locale: "es"
model: "suno"
---

# Usa Suno en OpenClaw.

Suno genera canciones completas — vocales, instrumentos y mezcla — a partir de un prompt de texto o letras exactas. Las versiones v4 a v5.5 están disponibles a través de RunAPI, que proporciona acceso API ya que Suno no tiene una API pública oficial. Los agentes de OpenClaw lo llaman con la misma RUNAPI_API_KEY usada para 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** — Establece la variable de entorno RUNAPI_API_KEY. Si ya configuraste RunAPI en OpenClaw para chat, la misma clave funciona para la generación de música con Suno — sin configuración adicional de proveedor.
2. **Llama a text_to_music** — Envía un POST al endpoint text_to_music con el model y vocal_mode. Usa auto_lyrics con un prompt para letras escritas por IA, exact_lyrics con lyrics/style/title para tus propias palabras, o instrumental con style/title para sin vocales.
3. **Consulta el resultado** — El endpoint devuelve un task_id de inmediato. La generación de canciones toma de 30 segundos a varios minutos dependiendo de la versión. Consulta el endpoint de estado de la tarea hasta que el estado sea completado y luego lee la URL del audio de salida.

## 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. |
| `vocal_mode` | `string` | Obligatorio. auto_lyrics (la IA escribe letras a partir del prompt), exact_lyrics (tú proporcionas letras/estilo/título) o instrumental (sin vocales, requiere estilo/título). |
| `prompt` | `string` | Descripción de la canción para el modo auto_lyrics. Describe género, ambiente, tempo y tema. Prohibido en los modos exact_lyrics e instrumental. |
| `lyrics` | `string` | Letras exactas para cantar. Obligatorio para el modo exact_lyrics. Prohibido en los modos auto_lyrics e instrumental. |
| `style` | `string` | Descripción del estilo musical, p. ej. lo-fi hip hop, 80s synthwave. Obligatorio para los modos exact_lyrics e instrumental. |
| `title` | `string` | Título de la canción. Obligatorio para los modos exact_lyrics e instrumental. |
| `vocal_gender` | `string` | Opcional. male o female. |
| `negative_tags` | `string` | Opcional. Estilos a evitar, p. ej. heavy metal, screaming. |
| `duration_seconds` | `integer` | Opcional. Duración objetivo en segundos. |
| `persona_id` | `string` | Opcional. ID de persona para perfiles personalizados de voz o estilo. |
| `persona_type` | `string` | Opcional. style o voice. Selecciona la categoría de persona. |
| `callback_url` | `string` | Opcional. URL de webhook que recibe un POST cuando la tarea se completa. |

## FAQ

### ¿Cuál es la diferencia entre auto_lyrics, exact_lyrics e instrumental?

auto_lyrics genera letras a partir de tu prompt — describes la canción y Suno escribe las palabras. exact_lyrics usa las letras que proporcionas tal cual, y requiere los campos style y title. instrumental produce una pista sin vocales, usando solo style y title.

### ¿Qué versión de Suno debería usar?

suno-v5.5 es la última versión y produce la mayor calidad con mejor claridad vocal y mezcla. suno-v4 y suno-v4.5 son más baratas y rápidas para iteraciones de borrador. Todas las versiones usan el mismo endpoint text_to_music y los mismos parámetros.

### ¿Cuánto tarda la generación con Suno?

El tiempo de generación varía según la versión y la duración de la canción. El tiempo típico es de 30 segundos a 2 minutos. La API devuelve un task_id de inmediato — consulta el endpoint de estado o establece un callback_url para evitar bloquear tu agente.

### ¿RunAPI proporciona una API oficial de Suno?

Suno no ofrece una API pública. RunAPI proporciona acceso programático a Suno v4 a v5.5 a través de la misma clave API y ciclo de vida de tareas usado para todos los demás modelos de RunAPI. No se necesita cuenta de Suno ni credenciales separadas.

### ¿Puedo controlar el género de voz y el peso del estilo?

Sí. Establece vocal_gender en male o female. Usa negative_tags para excluir estilos no deseados. Para mayor control, crea una persona a través del endpoint generate_persona y pasa el persona_id devuelto con persona_type establecido en voice o style.


## Links

- [Guía de configuración de OpenClaw →](https://runapi.ai/es/openclaw)
- [Suno en RunAPI →](https://runapi.ai/es/models/suno)
- [Model catalog](https://runapi.ai/es/models)
- [API docs](https://runapi.ai/es/docs)