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.
Usa RunAPI para generar una canción con Suno.
Requisitos:
- Lee la clave API de RUNAPI_API_KEY.
- Llama a POST https://runapi.ai/api/v1/suno/text_to_music
- Establece model en "suno-v5.5".
- Establece vocal_mode en "auto_lyrics" para letras generadas por IA a partir de un prompt.
- Establece prompt para describir la canción que deseas.
- La tarea es asíncrona. Consulta el task_id devuelto hasta que el estado sea "completed".
- Al terminar, lee la URL del audio de la salida de la respuesta.
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 en OpenClaw en tres pasos
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.
export RUNAPI_API_KEY=runapi_xxx
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.
POST /api/v1/suno/text_to_music
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.
GET /api/v1/suno/text_to_music/tsk_abc123
Parámetros de la API de Suno text_to_music
| 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. |
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. |
O que é Suno no OpenClaw?
Suno é uma IA de texto para música que gera músicas completas — vocais, instrumentos e produção — a partir de um prompt de texto. Suporta modo de letra exata, geração contínua para músicas mais longas e composição guiada por gênero. Agentes OpenClaw o chamam via RunAPI com a mesma chave de API usada para chat.
Casos de uso do Suno
Música de fundo para YouTube e redes sociais
Gere trilhas de fundo originais para vídeos descrevendo gênero, clima e andamento.
Ouvir letras como uma música completa
Compositores podem colar suas letras no modo exact_lyrics para ouvir como soam como uma música completa.
Vinhetas de abertura e encerramento de podcast
Crie música instrumental de abertura e encerramento combinada com o clima e o formato de um podcast.
Preguntas sobre Suno + OpenClaw
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.
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.
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.
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.
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.
Configuración general de OpenClaw
¿Aún no lo has configurado? Empieza con la guía de configuración de RunAPI para OpenClaw.
Guía de configuración de OpenClaw →Catálogo de modelos Suno
Ver todas las versiones de Suno, precios y endpoints disponibles.
Suno en RunAPI →Prueba Suno en OpenClaw hoy.
Obtén una clave RunAPI gratuita, pega el prompt en OpenClaw y genera canciones completas con vocales, instrumentos y mezcla a partir de una descripción de texto.