API cadangan prompt

Dikemas kini 2026-09-18 · pasukan Suno-API

Penerangan endpoint

Endpoint cadangan prompt memulangkan penerangan lagu, tema lirik dan cadangan tag gaya secara rawak. Sesuai untuk butang "inspirasi rawak" dan "segarkan tag".

Endpoint: POST /api/prompts/suggestions

Pengebilan: Percuma dalam kuota (maksimum 10 panggilan seminit dan 300 sehari bagi setiap pengguna); melebihi kuota percuma dikenakan 0.1 ¥ setiap panggilan.

Mengesan melebihi had: apabila kuota percuma dilangkaui, permintaan tetap berjalan seperti biasa, dan pengepala respons membawa X-Suno-Helper-Free: false serta X-Suno-Helper-Over-Limit: minute (atau day), jadi klien boleh memberitahu bahawa panggilan ini telah dibilkan.

Model yang disyorkan: suno-v6. Tersedia suno-v6, suno-v6-wild dan suno-v6-mini.

Pengesahan

Parameter permintaan

Contoh permintaan

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

Respons

{
  "code": 200,
  "message": "success",
  "data": {
    "prompts": ["A dreamy synth-pop track about city lights after rain"],
    "lyrics_prompts": ["Tulis lirik bahasa Melayu tentang malam, pertemuan semula dan penyesalan"],
    "tags": ["dreamy synth-pop", "warm piano", "male vocal"],
    "is_pending_personalization": false
  }
}

Keterangan medan