API หนังสือรับรองสิทธิ์ใช้งานเพลงเชิงพาณิชย์

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

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

เอนด์พอยต์หนังสือรับรองสิทธิ์ใช้งานเพลงเชิงพาณิชย์ใช้สำหรับดูรายการเพลงที่ผู้ใช้ของ API Key ปัจจุบันมีสิทธิ์ออกหนังสือรับรอง สร้างหนังสือรับรองเป็น PDF ดูประวัติหนังสือรับรอง และดาวน์โหลดไฟล์ที่ออกให้แล้ว

ทุกเอนด์พอยต์ใช้ New API Key เหมือนกันทั้งหมด:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

ที่อยู่พื้นฐาน:

https://www.suno-api.io

ข้อกำหนดเบื้องต้น

• API Key ต้องใช้ได้ และต้องเป็นของผู้ใช้ที่ต้องการหนังสือรับรอง
• ผู้ใช้ต้องผูกตัวตนสำหรับการรับรองให้เสร็จก่อน (ดู «0. คุณสมบัติและตัวตนสำหรับการรับรอง») เมื่อยืนยันแล้ว ตัวตนจะถูกล็อกตามกฎของผลิตภัณฑ์
• ผู้ใช้ต้องผ่านเงื่อนไขยอดเติมสะสมสำหรับบุคคลธรรมดาหรือนิติบุคคล
• เอนด์พอยต์ทั่วไปคืนเฉพาะข้อมูลตัวตนที่ปิดบังไว้ ไม่คืนเลขบัตร เลขโทรศัพท์ หรือรหัสเครดิตสังคมแบบรวมเป็นข้อความธรรมดา
• เพลงแต่ละเพลงออกหนังสือรับรองได้สำเร็จเพียงฉบับเดียว หนังสือรับรองที่สร้างไม่สำเร็จจะไม่กินสิทธิ์ของเพลงนั้น
• ปัจจุบันรองรับประเภทการสร้างที่กำหนดไว้ ซึ่งสร้างเสร็จแล้ว มีเสียง และมี Suno Song ID จริง ว่าเลือกได้หรือไม่ดูจาก authorization.selectable ในรายการเพลง

0. คุณสมบัติและตัวตนสำหรับการรับรอง

ก่อนออกหนังสือรับรอง ต้องตรวจสอบคุณสมบัติและผูกตัวตนก่อน เอนด์พอยต์ทั้งสองนี้ฟรี

0.1 ตรวจสอบคุณสมบัติและสถานะตัวตน

เอนด์พอยต์: GET /api/music/authorization/context

{
  "code": 200,
  "message": "success",
  "data": {
    "identity": {
      "exists": false
    },
    "eligibility": {
      "current_amount": 216.3,
      "personal_required_amount": 200,
      "company_required_amount": 500,
      "personal_eligible": true,
      "company_eligible": false
    },
    "stats": {
      "authorized_song_count": 0,
      "certificate_count": 0
    }
  }
}

0.2 ผูกตัวตนสำหรับการรับรอง

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

{
  "identity_type": "personal",
  "legal_name": "สมชาย ใจดี",
  "id_number": "110101199001010000",
  "contact_name": "สมชาย ใจดี",
  "phone": "13800000000",
  "email": "user@example.com",
  "address": "12 ถนนสุขุมวิท กรุงเทพฯ",
  "confirm_locked": true
}

คำตอบจะคืนข้อมูลตัวตนที่ปิดบังไว้: {"identity": {...}} หลังผูกสำเร็จ กรุณาใช้เอนด์พอยต์ context ยืนยันว่า identity.exists กลายเป็น true แล้วจึงเรียกรายการเพลงและเอนด์พอยต์ออกหนังสือรับรอง หากต้องแก้ไขข้อมูลตัวตน กรุณาติดต่อฝ่ายบริการลูกค้า

1. ดูรายการเพลงที่รับรองได้

เอนด์พอยต์: GET /api/music/authorization/songs

พารามิเตอร์คำค้น

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

curl "https://www.suno-api.io/api/music/authorization/songs?p=1&page_size=20&status=selectable" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

{
  "success": true,
  "message": "",
  "data": {
    "page": 1,
    "page_size": 20,
    "total": 1,
    "items": [
      {
        "task_id": 10001,
        "suno_song_id": "suno-song-id-1",
        "title": "เพลงตัวอย่าง",
        "generation_type": "generate",
        "completed_at": 1784000000,
        "created_at": 1783999000,
        "audio_url": "https://example.com/audio.mp3",
        "model_name": "suno-v6",
        "authorization": {
          "selectable": true
        }
      }
    ]
  }
}

เมื่อ authorization.selectable=false คำตอบจะอธิบายเหตุผลผ่าน reason_code และ reason เพลงที่ออกหนังสือรับรองแล้วจะคืน certificate_id และ certificate_no เพิ่มด้วย

2. สร้างหนังสือรับรอง

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

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

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

curl -X POST https://www.suno-api.io/api/music/authorization/certificates \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_ids": ["suno-song-id-1", "suno-song-id-2"],
    "confirm_risk_terms": true
  }'

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

{
  "success": true,
  "message": "",
  "data": {
    "certificate": {
      "id": 101,
      "certificate_no": "CERTIFICATE-NO",
      "verification_code": "VERIFY-CODE",
      "status": "issued",
      "song_count": 2,
      "identity_type_snapshot": "personal",
      "licensee_name_masked": "ส*",
      "document_no_masked_snapshot": "11**************34",
      "phone_masked_snapshot": "138****0000",
      "pdf_sha256": "PDF_SHA256",
      "issued_at": 1784000100,
      "created_at": 1784000000,
      "updated_at": 1784000100,
      "download_url": "/api/music/authorization/certificates/101/download",
      "songs": []
    }
  }
}

ในคำตอบที่สำเร็จ status จะเป็น issued หากสร้าง PDF ไม่สำเร็จ หนังสือรับรองจะถูกทำเครื่องหมายเป็น failed และเพลงที่เกี่ยวข้องยังส่งใหม่ได้หลังแก้ปัญหาแล้ว

3. ดูประวัติหนังสือรับรอง

เอนด์พอยต์: GET /api/music/authorization/certificates

พารามิเตอร์คำค้น

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

curl "https://www.suno-api.io/api/music/authorization/certificates?p=1&page_size=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

โครงสร้างคำตอบ

data ของคำตอบเป็นออบเจ็กต์แบ่งหน้า ประกอบด้วย page, page_size, total และ items แต่ละรายการใน items เป็นสรุปหนังสือรับรอง และมีสแนปช็อตเพลงของหนังสือรับรองนั้น

4. ดูรายละเอียดหนังสือรับรอง

เอนด์พอยต์: GET /api/music/authorization/certificates/:id

พารามิเตอร์ในเส้นทาง id คือ ID ตัวเลขของหนังสือรับรอง เอนด์พอยต์นี้อนุญาตให้เข้าถึงเฉพาะหนังสือรับรองของผู้ใช้ที่เป็นเจ้าของ API Key ปัจจุบันเท่านั้น

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

curl https://www.suno-api.io/api/music/authorization/certificates/101 \
  -H "Authorization: Bearer YOUR_API_KEY"

โครงสร้างคำตอบ

เมื่อสำเร็จจะคืน data.certificate โดยฟิลด์ประกอบด้วยเลขที่หนังสือรับรอง สถานะ ข้อมูลผู้รับรองที่ปิดบังไว้ เวลาที่ออก ค่าตรวจสอบของ PDF ที่อยู่ดาวน์โหลด และสแนปช็อตเพลงที่รับรอง

5. ดาวน์โหลด PDF หนังสือรับรอง

เอนด์พอยต์: GET /api/music/authorization/certificates/:id/download

ดาวน์โหลดได้เฉพาะหนังสือรับรองที่มีสถานะ issued เท่านั้น คำขอดาวน์โหลดยังต้องมี API Key ที่ใช้ได้ และดาวน์โหลดได้เฉพาะหนังสือรับรองของตัวเอง

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

curl https://www.suno-api.io/api/music/authorization/certificates/101/download \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --output authorization-certificate.pdf

คำตอบที่สำเร็จเป็นสตรีมไฟล์ application/pdf โดยชื่อไฟล์เป็นไปตาม Content-Disposition ของแบ็กเอนด์

สาเหตุความล้มเหลวที่พบบ่อย

ข้อควรระวัง

• ใช้ suno_song_id ที่รายการเพลงคืนมา อย่าใช้ ID ชั่วคราว pending:* หรือ ID ของตารางงาน
• ที่อยู่ดาวน์โหลดไม่ใช่ลิงก์สาธารณะ อย่าถอดการยืนยันตัวตนด้วย API Key ออก
• บันทึกหนังสือรับรองเป็นของผู้ใช้ที่ตรงกับ API Key ไม่สามารถข้ามผู้ใช้เพื่อดูหรือดาวน์โหลดได้
• ขอบเขตการรับรอง ข้อจำกัด และเนื้อหา PDF ขั้นสุดท้ายให้ยึดตามหนังสือรับรองที่ออกจริง