API de sugerencias de prompt
Descripción del endpoint
El endpoint de sugerencias de prompt devuelve descripciones de canciones, temas de letra y sugerencias de etiquetas de estilo al azar. Sirve para botones de "inspiración aleatoria" y "refrescar etiquetas".
Endpoint: POST /api/prompts/suggestions
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.
Autenticación
| Parámetro | Tipo | Obligatorio | Notas |
|---|---|---|---|
| Authorization | string | sí | Bearer YOUR_API_KEY |
| Content-Type | string | sí | application/json |
Parámetros de la petición
| Parámetro | Tipo | Obligatorio | Por defecto | Notas |
|---|---|---|---|---|
| model | string | sí | - | Nombre de modelo para el cliente: suno-v6, suno-v6-wild o suno-v6-mini |
Ejemplo de petición
curl -X POST https://www.suno-api.io/api/prompts/suggestions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6"
}'
Respuesta
{
"code": 200,
"message": "success",
"data": {
"prompts": ["A dreamy synth-pop track about city lights after rain"],
"lyrics_prompts": ["Escribe una letra en español sobre la noche, el reencuentro y el arrepentimiento"],
"tags": ["dreamy synth-pop", "warm piano", "male vocal"],
"is_pending_personalization": false
}
}
Campos de la respuesta
| Campo | Tipo | Notas |
|---|---|---|
| prompts | string[] | Inspiración para la descripción de la canción |
| lyrics_prompts | string[] | Inspiración para el tema de la letra |
| tags | string[] | Sugerencias de etiquetas de estilo; las tarjetas de estilo de Create deben usar este array |
| is_pending_personalization | boolean | Si las sugerencias personalizadas aún se están generando |
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