Prompt suggestions API

Updated 2026-09-18 · Suno-API team

Endpoint description

The prompt suggestions endpoint returns random song descriptions, lyric themes and style tag suggestions. It suits "random inspiration" and "refresh tags" buttons.

Endpoint: POST /api/prompts/suggestions

Billing: Free within the quota (at most 10 calls per minute and 300 per day for each user); beyond the free quota it is charged at 0.1 ¥ per call.

Detecting over-limit: when the free quota is exceeded the request still runs normally, and the response headers carry X-Suno-Helper-Free: false and X-Suno-Helper-Over-Limit: minute (or day), so the client can tell the user this call was billed.

Recommended model: suno-v6. suno-v6, suno-v6-wild and suno-v6-mini are available.

Authentication

Request parameters

Request example

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"
  }'

Response

{
  "code": 200,
  "message": "success",
  "data": {
    "prompts": ["A dreamy synth-pop track about city lights after rain"],
    "lyrics_prompts": ["Write an English lyric about night, reunion and regret"],
    "tags": ["dreamy synth-pop", "warm piano", "male vocal"],
    "is_pending_personalization": false
  }
}

Field notes