API โคลนเสียงและสร้างเพลงด้วยเสียงที่ระบุ (ไม่แนะนำ)

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

⛔ เส้นทางเดิม ไม่แนะนำสำหรับการเชื่อมต่อใหม่ หน้านี้อธิบายเส้นทาง persona รุ่นแรก (voice_task_id / generate-with-voice) ซึ่งยังใช้ได้ แต่ไม่แนะนำให้ลูกค้าใช้อีกต่อไป เมนูด้านซ้ายกำกับว่า "ไม่แนะนำ"

สำหรับการเชื่อมต่อใหม่ ให้ใช้ 【แนะนำ】 API โปรไฟล์เสียง: สร้างโปรไฟล์เสียงจากตัวอย่างเสียงหนึ่งชิ้น (POST /api/music/voice-profile/create) แล้วใช้มันคัฟเวอร์เพลงที่ระบุหรือร้องเพลงใหม่ โปรไฟล์เสียงเป็นทรัพยากรระดับแรก จัดการได้ทั้งการดูรายการ ดูรายละเอียด และลบ และไฟล์เสียงต้นฉบับจะถูกเก็บไว้อย่างถาวร

หากผลิตภัณฑ์ของคุณต้องใช้วงจรครบ "สร้างเสียง → ใช้ซ้ำระยะยาว → คัฟเวอร์" ให้เลือกใช้เส้นทางใหม่

ข้อควรทราบสำคัญ: เสียงที่โคลนแล้วอาจหมดอายุ

voice_id / voice_task_id ที่ได้จากการโคลนเสียงไม่ใช่ทรัพยากรที่ใช้ได้ตลอดไป อาจใช้งานไม่ได้เพราะอายุความใช้ได้ สถานะบัญชี หรือการเปลี่ยนแปลงสถานะของเสียง ผู้ที่เชื่อมต่อไม่ควรโคลนครั้งเดียวแล้วใช้ ID เสียงที่แคชไว้ในเครื่องซ้ำไปตลอด

แนวปฏิบัติที่แนะนำ:

• เก็บ voice_task_id, voice_id, is_available, updated_at และเวลาที่สร้างสำเร็จครั้งล่าสุด
• ก่อนสร้างเพลงด้วยเสียงที่โคลนไว้ทุกครั้ง ให้เรียก GET /api/voice/clone/tasks/{voice_task_id} หรือ POST /api/voice/clone/tasks/{voice_task_id}/check เพื่อยืนยันว่า is_available=true
• หากเอนด์พอยต์ตอบว่าเสียงใช้ไม่ได้ งานไม่มีอยู่ หรือคืนค่า selected voice is not ready ให้แจ้งผู้ใช้ให้โคลนใหม่หรือเลือกเสียงอื่นที่ใช้ได้
• ไม่ควรสัญญากับผู้ใช้ปลายทางว่าเสียงที่โคลนแล้วเป็น "ทรัพย์สินถาวร" ควรแจ้งในหน้าจอผลิตภัณฑ์ว่า "เสียงอาจหมดอายุและต้องตรวจสอบหรือโคลนใหม่"

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

กลุ่มเอนด์พอยต์นี้ใช้สร้างเสียงที่นำกลับมาใช้ซ้ำได้ และสร้างเพลงด้วยเสียงนั้น ผู้เรียกใช้เพียงใช้ API Key ที่แพลตฟอร์มออกให้ ฝั่งเซิร์ฟเวอร์จะจัดการส่งงาน ซิงค์สถานะ คิดค่าบริการ และดาวน์โหลดให้ทั้งหมด

การยืนยันตัวตน: Authorization: Bearer YOUR_API_KEY

ค่าบริการ:

• การตรวจสอบเสียง โคลนเสียง ตรวจสอบสถานะ ลบ และดาวน์โหลด: ฟรี
• ทางเข้าโคลนแบบขั้นตอนเดียวในเวิร์กสเปซ: 5 หยวนคงที่ต่อครั้ง ดำเนินการตรวจสอบเสียงต้นทางและไฟล์เสียงยืนยันรอบที่สองให้อัตโนมัติ และคืนเงินหากล้มเหลว
• สร้างไฟล์เสียงยืนยันต่อโดยอัตโนมัติหลังโคลนแบบปกติ: 5 หยวนคงที่ต่อครั้ง หากล้มเหลวจะคืนเงินตามขั้นตอนเดิม
• สร้างเพลงด้วยเสียงที่โคลนไว้: มีค่าใช้จ่าย 1.2 หยวนคงที่ต่อครั้ง ปกติแต่ละครั้งจะคืนงานตัวแทนชั่วคราว 2 รายการ
• เมื่อเปิด Max Mode (max_mode: true ใน POST /api/music/generate-with-voice) ค่าบริการ 1.2 หยวนต่อครั้งจะคิดเป็น 2 เท่า คือ 2.4 หยวนต่อครั้ง และการสร้างเพลงด้วยเสียงก็รองรับ variety (0-4 ไม่คิดเพิ่ม) หลักเกณฑ์ค่าต่าง ๆ อยู่ในหัวข้อ "พารามิเตอร์ขั้นสูง" ของภาพรวม API ใหม่

ลำดับการเรียกใช้งาน

1. เรียก POST /api/voice/clone/validate เพื่ออัปโหลดเสียงต้นทางและรับ voice_task_id
2. รอหรือโพล GET /api/voice/clone/tasks/{voice_task_id} จนได้ validate_info
3. ผู้ใช้อ่านข้อความนั้นออกเสียงและบันทึกไฟล์เสียงยืนยัน
4. เรียก POST /api/voice/clone/tasks/{voice_task_id}/generate เพื่อส่งไฟล์เสียงยืนยัน
5. เรียก POST /api/voice/clone/tasks/{voice_task_id}/check หรือสอบถามงานต่อจนกว่า is_available=true
6. เรียก POST /api/music/generate-with-voice เพื่อสร้างเพลงด้วยเสียงนั้น
7. เอนด์พอยต์สร้างเพลงจะคืนงานตัวแทนชั่วคราวก่อน เมื่อสร้างเสร็จและได้ song_id จริงแล้ว จึงใช้เอนด์พอยต์ดาวน์โหลดเพื่อรับไฟล์เดียวหรือไฟล์รวม
8. (ทางเลือก) เมื่อไม่ต้องการเสียงนี้แล้ว ให้เรียก DELETE /api/voice/clone/voices/{voice_task_id} เพื่อลบ ความหมายอยู่ในหัวข้อ 6

นอกจากนี้ยังมี การโคลนแบบขั้นตอนเดียว ในหน้าแรกของการบันทึก/อัปโหลดเสียงต้นทางในเวิร์กสเปซ เลือกทำให้เสร็จในครั้งเดียวได้ ระบบจะตรวจสอบและสร้างเสียงให้พร้อมกัน จึงไม่ต้องบันทึกไฟล์เสียงยืนยันรอบที่สอง คิด 5 หยวนต่อครั้ง และคืนเงินหากล้มเหลว

ฟิลด์ของงานเสียง

1. ส่งเสียงต้นทางเพื่อตรวจสอบ

เอนด์พอยต์: POST /api/voice/clone/validate

พารามิเตอร์ body

vocal_end_s - vocal_start_s ต้องผ่านข้อกำหนดช่วงเสียงขั้นต่ำ ควรอัปโหลดบันทึกเสียงร้องที่ชัดเจน ไม่มีดนตรีประกอบหรือเสียงรบกวนชัดเจน

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

curl -X POST https://www.suno-api.io/api/voice/clone/validate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voice_url": "https://example.com/source-voice.wav",
    "voice_name": "เสียงผู้หญิงจีนของฉัน",
    "description": "เสียงผู้หญิงจีนใสและเป็นธรรมชาติ",
    "style": "Mandopop",
    "singer_skill_level": "intermediate",
    "language": "zh",
    "vocal_start_s": 1.2,
    "vocal_end_s": 18.5,
    "source_duration_seconds": 20
  }'

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

{
  "success": true,
  "message": "",
  "data": {
    "voice": {
      "voice_task_id": 123,
      "voice_name": "เสียงผู้หญิงจีนของฉัน",
      "language": "zh",
      "validate_status": "submitted",
      "is_available": false,
      "status": "validate_submitted",
      "stage": "validate_submitted",
      "created_at": 1780480000,
      "updated_at": 1780480000
    }
  }
}

2. สอบถามงานเสียง

เอนด์พอยต์: GET /api/voice/clone/tasks/{voice_task_id}

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

curl https://www.suno-api.io/api/voice/clone/tasks/123 \
  -H "Authorization: Bearer YOUR_API_KEY"

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

{
  "success": true,
  "message": "",
  "data": {
    "voice": {
      "voice_task_id": 123,
      "voice_name": "เสียงผู้หญิงจีนของฉัน",
      "validate_info": "โปรดอ่านข้อความยืนยันที่คืนกลับมาที่นี่ออกเสียง",
      "validate_status": "success",
      "is_available": false,
      "status": "validate_ready",
      "stage": "validate_callback"
    }
  }
}

3. สร้างข้อความยืนยันใหม่

เอนด์พอยต์: POST /api/voice/clone/tasks/{voice_task_id}/regenerate

เรียกเมื่อข้อความยืนยันไม่เหมาะกับการอ่านออกเสียง หรือต้องตรวจสอบใหม่

curl -X POST https://www.suno-api.io/api/voice/clone/tasks/123/regenerate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

4. ส่งไฟล์เสียงยืนยันและสร้างเสียง

เอนด์พอยต์: POST /api/voice/clone/tasks/{voice_task_id}/generate

พารามิเตอร์ body

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

curl -X POST https://www.suno-api.io/api/voice/clone/tasks/123/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "verify_url": "https://example.com/verify-voice.wav",
    "voice_name": "เสียงผู้หญิงจีนของฉัน"
  }'

5. ตรวจสอบว่าเสียงใช้งานได้หรือไม่

เอนด์พอยต์: POST /api/voice/clone/tasks/{voice_task_id}/check

curl -X POST https://www.suno-api.io/api/voice/clone/tasks/123/check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

เมื่องานใช้งานได้ is_available ในคำตอบจะเป็น true และคืน voice_id กลับมา

6. ลบเสียง

เอนด์พอยต์: DELETE /api/voice/clone/voices/{voice_task_id}

ค่าบริการ: ฟรี

curl -X DELETE https://www.suno-api.io/api/voice/clone/voices/123 \
  -H "Authorization: Bearer YOUR_API_KEY"

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

{
  "success": true,
  "message": "",
  "data": {
    "voice_task_id": 123,
    "deleted": true
  }
}

หลังลบแล้วจะเป็นอย่างไร

• ใช้สร้างเพลงใหม่ไม่ได้อีก: การเรียก POST /api/music/generate-with-voice ด้วย voice_task_id นี้ (หรือ voice_id ของมัน) จะถูกปฏิเสธ ข้อความผิดพลาดคือ selected voice is not ready และไม่คิดค่าบริการ
• เพลงที่สร้างไว้แล้วด้วยเสียงนี้ไม่ได้รับผลกระทบเลย: เล่น ดาวน์โหลด ต่อเพลง แทนช่วง และแยกแทร็กยังทำงานตามเดิม
• งานเสียงนี้จะหายไปจากการสอบถาม: GET /api/voice/clone/tasks/{voice_task_id} จะคืน record not found
• ไฟล์เสียงต้นทางยังถูกเก็บตามนโยบายเก็บถาวรของแพลตฟอร์ม (ตั้งแต่ 2026-09-23 การลบไม่ล้างตัวอย่างเสียงที่อัปโหลดอีกต่อไป) แต่ไม่ได้หมายความว่ากู้คืนได้: งานเดิมสิ้นสุดแล้ว หากต้องการใช้เสียงเดิมต่อต้องทำขั้นตอนโคลนใหม่ทั้งหมด และจะได้ voice_task_id ใหม่
• ลบซ้ำ: การลบงานเดิมอีกครั้งจะคืน record not found (อยู่ในสถานะลบแล้วและหาไม่เจอ)

7. สร้างเพลงด้วยเสียงที่โคลนไว้

เอนด์พอยต์: POST /api/music/generate-with-voice

ค่าบริการ: 1.2 หยวนต่อครั้ง

พารามิเตอร์ body

รองรับ suno-v6, suno-v6-wild และ suno-v6-mini หากโมเดลว่างจะถือเป็น suno-v6 โมเดล V5/V5.5 เดิมเลิกให้บริการแล้ว แต่งานย้อนหลังอาจยังแสดงชื่อโมเดลเก่า

โครงสร้างคำขอที่ใช้ร่วมกันยังตีความฟิลด์เพื่อความเข้ากันได้กับ Create UI เช่น task, soundType, soundLoop, soundBpm, soundKey, voiceTaskId, voiceId แต่ไม่ใช่พารามิเตอร์ลูกค้าที่ใช้ได้ของเอนด์พอยต์นี้ งานเสียงต้องส่งผ่าน voice_task_id การตรวจสอบเสียงเพิ่มเติมต้องส่งผ่าน voice_id และการสร้างเพลงด้วยเสียงจะไม่อ่านฟิลด์ sound เลย

วิธีกรอกพารามิเตอร์การสร้างเพลง

• เมื่อ customMode=false ให้ prompt เก็บคำอธิบายเพลง เมื่อ customMode=true ให้ prompt เก็บเนื้อเพลงเต็ม และต้องกรอก style กับ title ด้วย อย่าส่งเนื้อเพลงไปยังฟิลด์คำอธิบายของโหมดแรงบันดาลใจ และอย่าถือคำอธิบายเพลงเป็นเนื้อเพลงของโหมดขั้นสูง
• weirdnessConstraint และ styleWeight เป็นทศนิยมสัดส่วนตั้งแต่ 0.0 ถึง 1.0 ส่ง 50 หรือ 50% ไม่ได้ ค่า 0.5 ใช้เป็นค่าที่สมดุลได้ การไม่ส่งหมายถึง "ไม่ระบุ" ส่วน 0 เป็นค่าที่ระบุชัดเจนและใช้ได้
• vocalGender ใช้ได้เฉพาะ m, male, f หรือ female เท่านั้น instrumental ในเอนด์พอยต์นี้เป็นเพียงฟิลด์เพื่อความเข้ากันได้ การสร้างด้วยเสียงที่โคลนจะถือเป็นเพลงมีเสียงร้องเสมอ
• waitAudio ไม่เปลี่ยนพฤติกรรมในเอนด์พอยต์นี้ เอนด์พอยต์จะคืนงานตัวแทนชั่วคราวแบบไม่รอผลเสมอ audio_url ว่างในผลลัพธ์แรกเป็นเรื่องปกติ ให้สอบถามด้วย client_request_id และอ่านที่อยู่ไฟล์เสียงเมื่อผลลัพธ์เสร็จแล้วเท่านั้น

พารามิเตอร์ header

พฤติกรรมของ Idempotency-Key:

• คำขอแรกระบบจะบันทึกเรกคอร์ดกันซ้ำแบบถาวรก่อนคิดค่าบริการ
• หากคีย์เดียวกันกับคำขอเดียวกันเสร็จแล้ว จะเล่นคำตอบรับแรกซ้ำ ไม่คิดเงินซ้ำและไม่สร้างงานซ้ำ
• คีย์เดียวกันแต่บอดี้คำขอต่างกันจะถูกปฏิเสธ
• คีย์เดียวกันที่ยังประมวลผลอยู่จะคืนข้อผิดพลาด "กำลังประมวลผล" ที่แน่นอน และจะคืน client_request_id ที่ปลอดภัยเมื่อสร้างแล้วเท่านั้น
• หากคำขอแรกด้วยคีย์หนึ่งล้มเหลว สถานะล้มเหลวจะคงอยู่ การลองใหม่ต้องใช้คีย์ใหม่

เงื่อนไขการคัฟเวอร์ด้วย sourceClipId

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

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

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

curl -X POST https://www.suno-api.io/api/music/generate-with-voice \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voice_task_id": 123,
    "customMode": true,
    "prompt": "เขียนเพลงป๊อปจีนเกี่ยวกับชายทะเลในคืนฤดูร้อน",
    "style": "Mandopop, warm piano, emotional",
    "title": "ลมทะเลคืนฤดูร้อน",
    "negativeTags": "noise, low quality",
    "instrumental": false,
    "model": "suno-v6"
  }'

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

{
  "success": true,
  "message": "",
  "data": {
    "client_request_id": "cu_1780480000_abcd1234",
    "items": [
      {
        "placeholder_id": "pending:cu_1780480000_abcd1234:0",
        "client_request_id": "cu_1780480000_abcd1234",
        "client_request_index": 0,
        "status": "submitted",
        "type": "voice_generate",
        "title": "ลมทะเลคืนฤดูร้อน",
        "prompt": "เขียนเพลงป๊อปจีนเกี่ยวกับชายทะเลในคืนฤดูร้อน"
      },
      {
        "placeholder_id": "pending:cu_1780480000_abcd1234:1",
        "client_request_id": "cu_1780480000_abcd1234",
        "client_request_index": 1,
        "status": "submitted",
        "type": "voice_generate",
        "title": "ลมทะเลคืนฤดูร้อน",
        "prompt": "เขียนเพลงป๊อปจีนเกี่ยวกับชายทะเลในคืนฤดูร้อน"
      }
    ],
    "pre_consumed_quota": 600000,
    "billing_source": "wallet"
  }
}

เกี่ยวกับงานตัวแทนชั่วคราวและ song_id สุดท้าย

generate-with-voice เป็นเอนด์พอยต์สร้างเพลงแบบไม่รอผล คำตอบสำเร็จหมายความเพียงว่างานสร้างเพลงถูกส่งแล้ว ไม่ได้หมายความว่าเพลงเสร็จแล้ว

ความหมายของฟิลด์สำคัญในคำตอบ:

ข้อควรระวัง: placeholder_id ที่ขึ้นต้นด้วย pending: ใช้เป็น song_id สุดท้ายไม่ได้ และส่งเข้า /api/music/query หรือเอนด์พอยต์ดาวน์โหลดโดยตรงก็ไม่ได้ หากเรียก /api/music/query ด้วยค่า pending:* เท่านั้น อาจได้อาร์เรย์ว่าง [] เนื่องจากเพลงจริงยังไม่เสร็จ หรืองานตัวแทนยังไม่ถูกแทนด้วย ID เพลงสุดท้าย

ตัวอย่างที่ผิด:

{
  "song_ids": "pending:cu_1780480000_abcd1234:0"
}

ลำดับที่ถูกต้อง:

1. เรียก POST /api/music/generate-with-voice เพื่อส่งงานสร้างเพลงด้วยเสียง
2. เก็บ client_request_id, items[].placeholder_id และ items[].client_request_index จากคำตอบ
3. โพล GET /api/music/generate-with-voice/results?client_request_id=cu_xxx
4. เมื่อ items[].song_id มีค่าและไม่ขึ้นต้นด้วย pending: จึงเรียก /api/music/query, /api/music/download-file หรือ /api/music/download-all

เวอร์ชันปัจจุบันเพิ่มเอนด์พอยต์สอบถามแบบสาธารณะ:

GET /api/music/generate-with-voice/results?client_request_id=cu_xxx

คืนผลลัพธ์งานของ client_request_id เดียวกันภายใต้ผู้ใช้ปัจจุบัน ลูกค้าจึงค้นหา song_id สุดท้ายได้เอง ในรายการที่คืนมา:

• song_id คือ ID เพลงจริง
• placeholder_id จะปรากฏเฉพาะเมื่องานยังอยู่ในสถานะตัวแทนชั่วคราว
• ค่าที่ขึ้นต้นด้วย pending: ใช้กับ /api/music/query หรือเอนด์พอยต์ดาวน์โหลดไม่ได้

หากคุณเก็บไว้เพียง client_request_id หรือ ID ตัวแทน pending:* ให้เรียกเอนด์พอยต์ผลลัพธ์นี้ก่อน หากยังหา song_id จริงไม่เจอ จึงส่ง client_request_id ให้ฝ่ายสนับสนุนด้านเทคนิคช่วยค้นหา

สอบถามผลลัพธ์การสร้างเพลงด้วยเสียง

เอนด์พอยต์: GET /api/music/generate-with-voice/results

ค่าบริการ: ฟรี

พารามิเตอร์ query

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

curl -X GET "https://www.suno-api.io/api/music/generate-with-voice/results?client_request_id=cu_1780480000_abcd1234" \
  -H "Authorization: Bearer YOUR_API_KEY"

ตัวอย่างคำตอบระหว่างสร้าง

{
  "success": true,
  "message": "",
  "data": {
    "client_request_id": "cu_1780480000_abcd1234",
    "status": "processing",
    "items": [
      {
        "song_id": "",
        "placeholder_id": "pending:cu_1780480000_abcd1234:0",
        "client_request_id": "cu_1780480000_abcd1234",
        "client_request_index": 0,
        "status": "processing",
        "type": "voice_generate",
        "title": "ลมทะเลคืนฤดูร้อน"
      }
    ]
  }
}

ตัวอย่างคำตอบเมื่อสร้างเสร็จ

{
  "success": true,
  "message": "",
  "data": {
    "client_request_id": "cu_1780480000_abcd1234",
    "status": "completed",
    "items": [
      {
        "song_id": "song_abc123",
        "client_request_id": "cu_1780480000_abcd1234",
        "client_request_index": 0,
        "status": "completed",
        "type": "voice_generate",
        "title": "ลมทะเลคืนฤดูร้อน",
        "audio_url": "https://...",
        "image_url": "https://...",
        "duration": 180.5
      }
    ]
  }
}

ความหมายของ status ระดับบนสุด

8. ดาวน์โหลดไฟล์เดียว

เอนด์พอยต์: POST /api/music/download-file

พารามิเตอร์ body

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

curl -X POST https://www.suno-api.io/api/music/download-file \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_id": "song_abc123",
    "kind": "audio"
  }' \
  --output song.mp3

คำตอบเป็นสตรีมไฟล์ Content-Type และชื่อไฟล์ให้ยึดตามที่แบ็กเอนด์คืนมา

9. ดาวน์โหลดทรัพยากรเพลงแบบไฟล์รวม

เอนด์พอยต์: POST /api/music/download-all

พารามิเตอร์ body

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

curl -X POST https://www.suno-api.io/api/music/download-all \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_id": "song_abc123"
  }' \
  --output song.zip

ไฟล์รวมมักมีไฟล์เสียง ปก และ metadata.json หากประเภททรัพยากรใดยังไม่ถูกสร้าง ก็จะไม่ถูกใส่ในไฟล์บีบอัด

ข้อผิดพลาดที่พบบ่อย

ข้อผิดพลาดของกลุ่มนี้ คืน HTTP 200 เสมอ ให้ตัดสินผลจากฟิลด์ success ในคำตอบ (false คือล้มเหลว ดูสาเหตุใน message) อย่าดูแค่รหัสสถานะ HTTP ความหมายครบถ้วนของการลบเสียง (ลบแล้วใช้ได้อีกไหม กู้คืนได้ไหม) อยู่ในหัวข้อ 6