API de refuerzo de estilo

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

Descripción del endpoint

El refuerzo de estilo expande una etiqueta de estilo corta en una descripción de estilo más completa y más adecuada para la generación de Suno, y también puede generar un pasaje de estilo a partir de la letra completa.

Endpoint: POST /api/music/boost-style

Facturación: Gratis dentro de la cuota (como máximo 10 llamadas por minuto y 300 al día por usuario); por encima de la cuota gratuita se cobra 0,1 ¥ por llamada.

Detectar el exceso: cuando se supera la cuota gratuita la petición sigue funcionando con normalidad, y las cabeceras de respuesta incluyen X-Suno-Helper-Free: false y X-Suno-Helper-Over-Limit: minute (o day), de modo que el cliente puede avisar de que esta llamada se ha facturado.

Modelo recomendado: suno-v6. Se pueden usar suno-v6, suno-v6-wild y suno-v6-mini.

Salida en chino: cuando el contenido de la petición (originalTags/lyrics/user_guidance) contiene chino y no se declara idioma, el servicio añade automáticamente （请用中文描述） después de original_tags y agrega user_guidance=语言：简体中文；乐器名也用中文, para elevar la tasa de acierto de las descripciones de estilo en chino. Los valores realmente enviados se devuelven en appliedOriginalTags y appliedUserGuidance de la respuesta. Si el contenido que envías ya indica un idioma (por ejemplo «describe en chino simplificado»), el servicio no modifica nada.

Autenticación

Parámetros de la petición

Ejemplo de petición

curl -X POST https://www.suno-api.io/api/music/boost-style \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "originalTags": "pop, piano, male vocal",
    "lyrics": "[Verse]\nLa noche cae tras la ventana\n[Chorus]\nCaminamos hacia la luz",
    "user_guidance": "añade suona y erhu, voz masculina, ritmo más rápido",
    "instrumental": false
  }'

Respuesta

{
  "code": 200,
  "message": "success",
  "data": {
    "originalTags": "pop, piano, male vocal",
    "instrumental": false,
    "upsampledStyle": "Mandopop, expressive male vocal, warm piano ballad...",
    "requestId": "request_id"
  }
}

upsampledStyle es la descripción de estilo completa que debe escribirse de vuelta en el campo Style.