API เพิ่มดนตรีประกอบ

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

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

การเพิ่มดนตรีประกอบใช้เรียบเรียงเพลงที่มีอยู่ใหม่ เพิ่มเครื่องดนตรี หรือสร้างโครงสร้างดนตรีประกอบชุดใหม่ให้

เอนด์พอยต์: POST /api/music/add-instrumental

ค่าบริการ: มีค่าใช้จ่าย คิดตามโมเดลที่ร้องขอ จำนวนที่หักจริงเป็นไปตามการตั้งราคาในระบบหลังบ้าน

Max Mode / Variety: เอนด์พอยต์นี้รองรับพารามิเตอร์ทางเลือก max_mode และ variety (0-4) เมื่อเปิด max_mode ครั้งนี้จะคิดค่าบริการเป็น 2 เท่า ส่วน variety ไม่มีค่าใช้จ่ายเพิ่ม ความหมายและวิธีส่งดูได้ในหัวข้อ "พารามิเตอร์ขั้นสูง" ของ ภาพรวม API ใหม่

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

ระยะเวลารอและ timeout (สำคัญ): เอนด์พอยต์นี้เป็นแบบซิงโครนัส — คำสั่งจะถูกรับและส่งเข้าสู่การสร้างเมื่อคำตอบกลับมาเท่านั้น จากการวัด ส่วนใหญ่ตอบกลับภายใน 1-3 วินาที ประมาณ 10% เกิน 30 วินาที และนานที่สุดประมาณ 230 วินาที กรุณาตั้ง timeout ฝั่งไคลเอนต์ไว้ที่ 300 วินาทีขึ้นไป การไม่ได้รับคำตอบไม่ได้หมายความว่าไม่ได้สร้าง และอย่าลองซ้ำทันทีหลัง timeout (จะซ้ำคำสั่งและถูกหักเงินซ้ำ) หากการเชื่อมต่อขาด ให้ตรวจสอบภายหลังด้วย GET /api/music/songs ดูหัวข้อ "ระยะเวลารอและการตั้งค่า timeout" ใน ภาพรวม API ใหม่

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

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

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

curl -X POST https://www.suno-api.io/api/music/add-instrumental \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "lyrics": "",
    "style_tags": "cinematic, strings, acoustic guitar",
    "song_title": "เวอร์ชันเสริมดนตรีประกอบ",
    "audio_weight": 1,
    "wait_completion": false
  }'

คำตอบ

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "เวอร์ชันเสริมดนตรีประกอบ",
        "status": "pending"
      },
      {
        "song_id": "result_song_id_2",
        "song_title": "เวอร์ชันเสริมดนตรีประกอบ",
        "status": "pending"
      }
    ]
  }
}

หนึ่งครั้งคืน 2 ผลลัพธ์ (คิดค่าบริการเป็น 2 เพลง) ตัวอย่างแสดง 2 รายการ ให้ยึดตามจำนวนสมาชิกของอาร์เรย์ clips และอย่าเขียนลูปด้วยจำนวนคงที่ บันทึก clips[].song_id แล้วใช้ API สอบถามเพลงและประวัติ สอบถามจนกว่าจะเป็น completed จากนั้นเล่นหรือดาวน์โหลดผ่าน audio_url ได้ ดู API สร้างและรับไฟล์ WAV และเอนด์พอยต์ดาวน์โหลดอื่น ๆ

ข้อควรระวัง

• source_clip_id ต้องเป็น ID เพลงจริงที่เสร็จสมบูรณ์และคีย์ API ปัจจุบันเข้าถึงได้ จะใช้ ID แทนอย่าง pending: ไม่ได้
• การเพิ่มดนตรีประกอบไม่ใช่การคัฟเวอร์ หากต้องการคัฟเวอร์ให้ใช้ API คัฟเวอร์จากคลิปต้นทาง
• หากต้องการเพิ่มเครื่องดนตรีหรือแทร็กที่ระบุให้เพลงที่มีอยู่ ให้ใช้ API เพิ่มแทร็ก