API ลบสเต็ม

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

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

การลบสเต็มจะซ่อนแทร็กสเต็มที่สร้างไว้แล้วออกจากรายการ การลบเป็นการลบแบบซอฟต์: ฝั่งเซิร์ฟเวอร์เพียงทำเครื่องหมายแถวสเต็มด้วย stem_hidden ไฟล์เสียง MIDI และทรัพยากรดาวน์โหลดยังคงอยู่ และเพลงเดิมยังแยกสเต็มใหม่ได้ในภายหลัง

เอนด์พอยต์: POST /api/music/stem-delete

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

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

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

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

ต้องส่งอย่างน้อยหนึ่งใน song_id / song_ids / stem_batch_id / stem_mode มิฉะนั้นจะคืน 400

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

curl -X POST https://www.suno-api.io/api/music/stem-delete \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_ids": ["stem_track_id_1", "stem_track_id_2"]
  }'

คำตอบ

{
  "code": 200,
  "message": "success",
  "data": {
    "hidden": 2,
    "affected_sources": 1
  }
}

ข้อควรระวัง

• Idempotent: หากแทร็กถูกซ่อนอยู่แล้วหรือไม่มี ID นี้ จะคืน hidden: 0 โดยไม่แจ้งข้อผิดพลาด จึงเรียกซ้ำได้อย่างปลอดภัย
• การลบมีผลเฉพาะเพลงของคีย์ API ปัจจุบัน แทร็กที่ไม่ใช่ของคุณจะไม่ถูกแก้ไข
• เมื่อสเต็มสุดท้ายที่มองเห็นในรายการถูกซ่อน เครื่องหมาย "แยกแล้ว" ของเพลงต้นทางจะถูกล้างไปด้วย