API รีมาสเตอร์ (Remaster)

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

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

รีมาสเตอร์ใช้สร้าง «เวอร์ชันรีมาสเตอร์» ที่มีคุณภาพเสียงดีขึ้นจากเพลงที่เสร็จแล้ว โดยคืน 2 เวอร์ชันในครั้งเดียว และชื่อเพลงจะมี (Remastered) ต่อท้ายโดยระบบอัตโนมัติ

เอนด์พอยต์: POST /api/music/remaster

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

เกี่ยวกับโมเดล: รีมาสเตอร์ใช้เอนด์พอยต์และโมเดลรีมาสเตอร์เฉพาะของฝั่งต้นทาง ซึ่งแพลตฟอร์มกำหนดไว้ตายตัวและไม่เปลี่ยนตาม model; ค่า model ในคำขอใช้เพียงคิดราคาและเลือกช่องทาง แนะนำให้ส่ง suno-v6 อย่างชัดเจน

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

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

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

audio_id, source_clip_id, sourceClipId เป็นวิธีเขียนที่เทียบเท่า song_id ใช้อย่างใดอย่างหนึ่ง

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

curl -X POST https://www.suno-api.io/api/music/remaster \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "song_id": "source_song_id",
    "variation_category": "high",
    "style_profile": "clarity"
  }'

หากใช้ค่าตั้งต้นก็เพียงพอ ส่งเฉพาะเพลงต้นทางก็ได้ เทียบเท่า variation_category: normal + style_profile: boost:

{ "model": "suno-v6", "song_id": "source_song_id" }

คำตอบ

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "remastered_clip_id_1",
        "song_title": "ชื่อเพลงต้นทาง (Remastered)",
        "status": "processing"
      },
      {
        "song_id": "remastered_clip_id_2",
        "song_title": "ชื่อเพลงต้นทาง (Remastered)",
        "status": "processing"
      }
    ]
  }
}

หนึ่งครั้งคืน 2 เวอร์ชันรีมาสเตอร์ บันทึก clips[].song_id ทั้งสองรายการ แล้วใช้ API สอบถามเพลงและประวัติ สอบถามจนกว่าจะเป็น complete ก่อนดึงไฟล์เสียง

ข้อควรระวัง

• เพลงต้นทางต้องเสร็จสมบูรณ์และอยู่ในขอบเขตที่คีย์ API ปัจจุบันเข้าถึงได้ วัสดุจากภายนอกจะถูกซิงค์เข้าบัญชีที่เรียกใช้โดยอัตโนมัติ
• รีมาสเตอร์ทำเฉพาะคุณภาพเสียง หากต้องการเปลี่ยนสไตล์ การเรียบเรียง หรือการร้อง ให้ใช้ เสริมสไตล์, อัปโหลดแล้วคัฟเวอร์ หรือ เอนด์พอยต์กลุ่ม Remix
• ยิ่ง variation_category สูง เวอร์ชันรีมาสเตอร์จะต่างจากเพลงต้นทางมากขึ้น ก่อนส่งงานจริงแนะนำให้ลอง normal ก่อนแล้วค่อยเพิ่ม