API de generación de efectos de sonido

Actualizado el 2026-09-18 · equipo de Suno-API

Descripción del endpoint

La generación de efectos de sonido crea unos segundos de audio, no una canción. Sirve para sonidos cortos como truenos, gotas de lluvia o un impacto, y también para efectos de transición, ambiente y bucles de batería; la mayoría dura menos de 5 segundos y el más largo ronda los 20 segundos. Admite los modos de una sola vez y en bucle.

Endpoint: POST /api/music/sounds

Facturación: De pago, actualmente 0,6 CNY por llamada por defecto. El importe realmente cobrado sigue la configuración de precios actual del back-office.

Tiempos de espera y timeouts (importante): es un endpoint síncrono — el pedido solo se acepta y se entrega a generación cuando llega la respuesta. Según lo medido, la mayoría de las peticiones responden en 1-3 segundos, alrededor del 10% tardan más de 30 segundos y la más lenta ronda los 230 segundos. Configura el timeout del cliente en 300 segundos o más; no recibir respuesta no significa que no se haya generado nada, y no reintentes justo después de un timeout (eso duplica el pedido y vuelve a cobrar). Si la conexión se cayó, confírmalo más tarde con GET /api/music/songs. Consulta «Tiempos de espera y configuración de timeout» en el Resumen de la nueva API.

Parámetros de la petición

Headers

Parámetro	Tipo	Obligatorio	Notas
Authorization	string	sí	Bearer YOUR_API_KEY
Content-Type	string	sí	application/json

Parámetros del cuerpo

Parámetro	Tipo	Obligatorio	Por defecto	Notas
model	string	no	suno-v6	Nombre de modelo para el cliente: `suno-v6`, `suno-v6-wild` o `suno-v6-mini`
description	string	sí	-	Describe el sonido que quieres; las frases cortas en inglés funcionan de forma más fiable, por ejemplo `cinematic whoosh transition, bright impact`
title	string	no	-	Título; si no se envía, puede generarse a partir de la descripción
type	string	no	one_shot	Tipo: `one_shot` (una sola vez) o `loop` (bucle)
loop	boolean	no	false	Si se reproduce en bucle; equivale a poner `type` en `loop`
bpm	number	no	-	BPM; debe ser un número mayor que 0. Un valor inválido devuelve 400 (`invalid_sound_bpm`) en lugar de ignorarse en silencio
key	string	no	-	Tonalidad, con el formato de nota (C-B) más un `#`/`b` opcional más un `Major`/`Minor` opcional, por ejemplo `C Major`, `C#m`, `Bb`; vacío o `any` significa sin restricción. Un valor inválido devuelve 400 (`invalid_sound_key`)

Ejemplo de petición

curl -X POST https://www.suno-api.io/api/music/sounds \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "description": "cinematic whoosh transition, bright impact",
    "title": "cinematic whoosh",
    "type": "one_shot",
    "loop": false,
    "bpm": 120,
    "key": "C"
  }'

Respuesta

Devuelve un array de canciones; los campos son los mismos que los campos comunes de respuesta de canción del Resumen de la nueva API.

SiguienteAPI de generación de letras

Obtener una clave de API

Crea una clave de API en la consola después de registrarte. Cada generación cuesta 0,6 ¥ y devuelve 2 pistas, las descargas son ilimitadas y no hace falta número de teléfono.

Obtener clave de API Volver al resumen