API สร้าง/รับไฟล์ WAV

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

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

เอนด์พอยต์ WAV ใช้สร้างหรือรับที่อยู่ไฟล์เสียง WAV แบบไม่สูญเสียคุณภาพของเพลงที่มีอยู่

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

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

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

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

Headers

พารามิเตอร์บอดี

maxAttempts และ intervalSeconds เป็นตัวเลข JSON ทั้งคู่ โดย intervalSeconds มีหน่วยเป็นวินาที ไม่ใช่มิลลิวินาที ปกติใช้ค่าเริ่มต้นก็เพียงพอ ค่าเหล่านี้ควบคุมเพียงจำนวนครั้งและช่วงห่างที่เอนด์พอยต์นี้รอให้ WAV พร้อมภายในเท่านั้น ไม่เปลี่ยนสถานะของงานสร้างเพลงเอง

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

curl -X POST https://www.suno-api.io/api/music/wav \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "maxAttempts": 24,
    "intervalSeconds": 5
  }'

คำตอบ

{
  "code": 200,
  "message": "success",
  "data": {
    "audioId": "clip_id",
    "status": "complete",
    "wavUrl": "https://media.code-go.com/assets/example.wav"
  }
}

ข้อควรระวัง

การสร้างและตรวจสอบ WAV เซิร์ฟเวอร์จะเลือกทรัพยากรที่ใช้ได้โดยอัตโนมัติจากบันทึกเพลง ลูกค้าไม่ต้องให้ข้อมูลบัญชีใด ๆ

เพลงทั่วไปและแทร็กที่แยกแล้วใช้เส้นทางการส่งมอบสื่อแบบควบคุมเดียวกัน WAV จะถูกดาวน์โหลดและบันทึกลงดิสก์โดย CN2 ก่อน และ data.wavUrl ในคำตอบที่สำเร็จจะคืนเฉพาะที่อยู่ CDN แบบควบคุม ไม่คืนที่อยู่ต้นทางชั่วคราวของ Suno หรือ S3

หากมี WAV ที่สถานะ ready อยู่แล้ว จะนำกลับมาใช้ซ้ำ ไม่ร้องขอ Suno ใหม่และไม่ย้ายไฟล์ซ้ำ ส่วน WAV ที่ยังไม่ถูกเตรียมจะไม่ถูกเปิดเผยเป็นที่อยู่ Suno/S3 ผ่าน /api/music/query จะเตรียมตามความต้องการหลังจากเรียกเอนด์พอยต์นี้หรือเอนด์พอยต์ดาวน์โหลดแบบรวมเท่านั้น

⚠️ อายุของที่อยู่ WAV: 7 วัน กรุณาโอนย้ายเก็บไว้ทันที data.wavUrl ที่คืนมานั้นให้บริการโดยที่เก็บออบเจ็กต์ของแพลตฟอร์ม และหมดอายุภายใน 7 วันโดยค่าเริ่มต้น (ไฟล์จะถูกเรียกคืน และที่อยู่เดิมจะคืน 404) กรุณาโอนย้าย WAV ไปเก็บในที่จัดเก็บของคุณภายในระยะเวลานั้น หลังจากหมดอายุ ให้เรียกเอนด์พอยต์นี้ใหม่เพื่อรับที่อยู่ที่ใช้งานได้ใหม่

หากทรัพยากรเพลงใช้งานไม่ได้ชั่วคราว เอนด์พอยต์จะคืน 409 กรุณาลองใหม่ภายหลัง เซิร์ฟเวอร์จะไม่คืนที่อยู่ชั่วคราวที่ไม่เสถียร