API ลบเสียงร้อง

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

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

การลบเสียงร้องใช้แยกเพลงที่มีอยู่ออกเป็นสองแทร็ก คือเสียงร้องและดนตรีประกอบ เป็นรูปแบบลัดของการแยกแทร็ก: ผู้เรียกเพียงส่ง ID เพลงต้นทาง ไม่ต้องเลือกโหมดการแยก และเซิร์ฟเวอร์ประมวลผลเป็นสองแทร็ก (two) เสมอ

เอนด์พอยต์: POST /api/music/vocal-removal

ค่าบริการ: ฟรี เอนด์พอยต์นี้แยกแทร็กเท่านั้น ไม่มีค่าใช้จ่ายในการสร้าง และไม่บันทึกรายการหักเงิน

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

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

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

ชื่อแทนที่ใช้ได้: sourceClipId, audio_id, audioId, song_id ใช้แทน source_clip_id ได้ทั้งหมด

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

curl -X POST https://www.suno-api.io/api/music/vocal-removal \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "song_title": "ลบเสียงร้อง"
  }'

คำตอบ

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "vocals_clip_id",
        "song_title": "ลบเสียงร้อง (Vocals)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      },
      {
        "song_id": "instrumental_clip_id",
        "song_title": "ลบเสียงร้อง (Instrumental)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      }
    ]
  }
}

หนึ่งครั้งที่ส่งจะคืน 2 เวอร์ชัน × {Vocals, Instrumental} จึงมักมี 4 รายการใน clips ให้จัดกลุ่มตาม stem_from_id และแยกเสียงร้องกับดนตรีประกอบจากคำต่อท้ายของ song_title

ข้อควรระวัง

• ให้ใช้ API สอบถามเพลงและประวัติ (POST /api/music/query) สอบถามจนกว่าจะเป็น completed ก่อนใช้งาน ส่วน GET /api/music/songs/:song_id และรายการประวัติ ยังไม่รวม แทร็กที่เกิดจากการลบเสียงร้อง — นี่คือความแตกต่างที่ทราบอยู่
• หากต้องการเลือกโหมดสองแทร็กหรือหลายแทร็ก หรือแยกตามชื่อแทร็ก ให้ใช้ API แยกแทร็ก (เสียงร้องและดนตรีประกอบ)
• แทร็กที่ไม่ต้องการซ่อนได้ด้วย API ลบแทร็ก อย่าส่งคำขอลบซ้ำ