API คำแนะนำพรอมป์ต์

อัปเดต 2026-09-18 · ทีม Suno-API

คำอธิบายเอนด์พอยต์

เอนด์พอยต์คำแนะนำพรอมป์ต์คืนคำอธิบายเพลง หัวข้อเนื้อเพลง และคำแนะนำแท็กสไตล์แบบสุ่ม เหมาะกับปุ่ม "แรงบันดาลใจสุ่ม" และ "รีเฟรชแท็ก"

เอนด์พอยต์: POST /api/prompts/suggestions

ค่าบริการ: ฟรีภายในโควตา (ผู้ใช้แต่ละรายไม่เกิน 10 ครั้งต่อนาที และ 300 ครั้งต่อวัน) เกินโควตาฟรีคิด 0.1 หยวนต่อครั้ง

การตรวจจับการเกินโควตา: เมื่อเกินโควตาฟรี คำขอจะยังทำงานตามปกติ และเฮดเดอร์คำตอบจะมี X-Suno-Helper-Free: false กับ X-Suno-Helper-Over-Limit: minute (หรือ day) ไคลเอนต์จึงแจ้งได้ว่าครั้งนี้คิดค่าบริการแล้ว

โมเดลที่แนะนำ: suno-v6 ใช้ได้ทั้ง suno-v6, suno-v6-wild และ suno-v6-mini

การยืนยันตัวตน

พารามิเตอร์คำขอ

ตัวอย่างคำขอ

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

คำตอบ

{
  "code": 200,
  "message": "success",
  "data": {
    "prompts": ["A dreamy synth-pop track about city lights after rain"],
    "lyrics_prompts": ["เขียนเนื้อเพลงภาษาไทยเกี่ยวกับกลางคืน การกลับมาพบกัน และความเสียใจ"],
    "tags": ["dreamy synth-pop", "warm piano", "male vocal"],
    "is_pending_personalization": false
  }
}

คำอธิบายฟิลด์