API เสริมสไตล์

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

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

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

เอนด์พอยต์: POST /api/music/boost-style

ค่าบริการ: ฟรีภายในโควตา (ผู้ใช้แต่ละรายไม่เกิน 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

ผลลัพธ์ภาษาไทย/จีน: เมื่อเนื้อหาคำขอ (originalTags/lyrics/user_guidance) มีภาษาจีนและไม่ได้ระบุภาษาไว้ ระบบจะเติม （请用中文描述） ต่อท้าย original_tags โดยอัตโนมัติ และเพิ่ม user_guidance=语言：简体中文；乐器名也用中文 เพื่อให้คำอธิบายสไตล์ภาษาจีนตรงเป้ามากขึ้น ค่าที่ส่งจริงจะคืนมาใน appliedOriginalTags และ appliedUserGuidance ของคำตอบ หากเนื้อหาที่ส่งระบุภาษาไว้ชัดเจนแล้ว (เช่น "อธิบายเป็นภาษาจีนตัวย่อ") ระบบจะไม่แก้ไขใด ๆ

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

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

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

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]\nค่ำคืนทอดลงนอกหน้าต่าง\n[Chorus]\nเราเดินไปสู่แสงสว่าง",
    "user_guidance": "เพิ่มซัวนาและเอ้อหู เสียงชาย จังหวะเร็วขึ้น",
    "instrumental": false
  }'

คำตอบ

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

upsampledStyle คือคำอธิบายสไตล์ฉบับเต็มที่ควรเขียนกลับลงในช่อง Style