API ต่อเพลงเต็ม (Get Full Song)

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

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

การต่อเพลงเต็มใช้รวม «เพลงต้นฉบับ + ท่อนที่สร้างใหม่» ให้เป็นเพลงที่สมบูรณ์หนึ่งเพลง: หลัง Extend จะต่อท่อนถัดไป หลัง Replace Section จะเย็บท่อนใหม่กลับเข้าไปในเพลงต้นฉบับ หน้าเว็บทางการเรียกความสามารถนี้ว่า Get Full Song

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

ค่าบริการ: มีค่าใช้จ่าย คงที่ 0.05 หยวนต่อครั้ง การต่อเพลงแยกจากราคาการสร้าง และไม่เข้าร่วม Max Mode หรือตัวคูณโปรไฟล์เสียง จำนวนที่หักจริงเป็นไปตามการตั้งราคาในระบบหลังบ้าน

ระยะเวลารอและ 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/concat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_id": "extended_or_replaced_clip_id",
    "is_infill": false
  }'

หากต้องการต่อหลังจากแทนที่ท่อน ให้ตั้ง is_infill เป็น true:

{ "song_id": "infilled_clip_id", "is_infill": true }

คำตอบ

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "concat_clip_id",
        "song_title": "ชื่อเพลงต้นทาง",
        "status": "queued"
      }
    ]
  }
}

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

ความยาวของผลลัพธ์มาจากไหน

การต่อไม่ได้นำสองไฟล์มาต่อกันตรง ๆ แต่ตัดเพลงต้นทางตามจุดเวลาที่บันทึกไว้ในประวัติของท่อน:

ดังนั้นเสียงต้นฉบับหลังจากจุดต่อจะถูกทิ้งไป จึงไม่เกิดการซ้ำทั้งท่อน

ข้อควรระวัง

• ต่อได้เฉพาะท่อนที่เสร็จสมบูรณ์แล้ว ถ้าท่อนยังสร้างอยู่ให้รอให้เสร็จก่อน
• ผลลัพธ์เป็นเรกคอร์ดใหม่ ท่อนเดิมยังคงอยู่และใช้ต่อได้
• หากต้องการรวมสองเพลงที่ต่างกันเป็นเพลงเดียว ให้ใช้ API มาชอัป; หากต้องการเก็บไว้เพียงท่อนเดียว ให้ใช้ API ตัดเพลง