API สร้างเนื้อเพลง

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

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

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

เอนด์พอยต์: POST /api/lyrics/generate

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

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

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

instruction รองรับฟิลด์เดิม theme และ prompt ด้วย metadata.lyrics_model ค่าเริ่มต้นคือ default และ metadata.enable_thinking ค่าเริ่มต้นคือ false

การควบคุมภาษา

เอนด์พอยต์นี้ไม่มีฟิลด์คำขอ language แยกต่างหาก ภาษาของเนื้อเพลงขึ้นอยู่กับเนื้อหาของ instruction โดย style ทำได้เพียงบทบาทเสริม

หากต้องการเนื้อเพลงภาษาจีน ให้ระบุภาษาปลายทางอย่างชัดเจนใน instruction เช่น:

{
  "model": "suno-v6",
  "instruction": "请用中文写歌词，主题是夏夜海边重逢",
  "style": "Mandopop, 中文流行"
}

หรือเขียนว่า "Write the lyrics in Chinese about ..." ก็ได้ หากต้องการเนื้อเพลงภาษาอังกฤษ ให้เขียน "请用英文写歌词" หรือ "Write the lyrics in English" หากส่งเฉพาะหัวข้อภาษาอังกฤษโดยไม่ระบุภาษาปลายทาง ผลลัพธ์อาจเป็นภาษาอังกฤษ

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

curl -X POST https://www.suno-api.io/api/lyrics/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "instruction": "เนื้อเพลงภาษาไทยเกี่ยวกับช่วงจบการศึกษาและการเริ่มต้นใหม่",
    "style": "ป็อป ร็อก จริงใจ ท่อนฮุกจำง่าย",
    "title": "เริ่มต้นใหม่",
    "metadata": {
      "lyrics_model": "default",
      "enable_thinking": false
    }
  }'

คำตอบ

{
  "code": 200,
  "message": "success",
  "data": {
    "lyrics": "[Verse]\nลมผ่านสนามเรียน\nเราส่งมือลาความเมื่อวาน",
    "edited_lyrics": "[Verse]\nลมผ่านสนามเรียน\nเราส่งมือลาความเมื่อวาน",
    "lyrics_id": "lyrics_id",
    "lyrics_request_id": "lyrics_request_id"
  }
}

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

คำอธิบายความเข้ากันได้

• ฟิลด์เดิม theme และ prompt ยังใช้ได้ และจะถูกแมปเป็น instruction
• ซีรีส์เอนด์พอยต์ "โครงการเนื้อเพลง / นักเขียนเนื้อเพลง" ปิดให้บริการแล้ว: หากต้องการเก็บผลลัพธ์ที่สร้างขึ้น โปรดบันทึก edited_lyrics ที่เอนด์พอยต์คืนค่าไว้เอง