รายการเสียงที่ออกแบบเอง

GEThttps://api.paxalabs.com/v1/voices/designed

GET /v1/voices/designed แสดงเสียงที่ออกแบบเองของบัญชี เรียงจากเก่าไปใหม่ พร้อมจำนวนช่องที่ใช้อยู่และลิมิตของแพ็กเกจ

curl https://api.paxalabs.com/v1/voices/designed \
  -H "Authorization: Bearer $PAXA_API_KEY"

{
  "voices": [
    {
      "id": "voice_3f9a1c2e7b4d4e8a9c0b1d2e3f4a5b6c",
      "name": "Nok",
      "role": "Pharmacist",
      "description": "A calm, warm voice that explains each step slowly.",
      "gender": "f",
      "language": "th",
      "model": "paxa-tts-flash-v2",
      "created_at": "2026-10-23T08:41:16.204Z"
    }
  ],
  "slots": {
    "used": 1,
    "limit": 3
  }
}

ค่า id แต่ละค่าคือค่าที่ฟิลด์ voice รับเมื่อตั้ง model เป็น paxa-tts-flash-v2 หลังลดแพ็กเกจ slots.used อาจมากกว่า slots.limit ทุกเสียงที่บันทึกไว้ยังใช้ได้ตามเดิม แต่บันทึกเสียงใหม่ได้เมื่อลบเสียงเดิมออกก่อน การดูรายการไม่ใช้เครดิตและไม่นับรวมในอัตราจำกัดคำขอ

เฮดเดอร์#

authorizationBearer pxa_...จำเป็น

Authorization: Bearer pxa_... (recommended).

x-api-keypxa_...

Alternative to the Authorization header. Ignored when Authorization is present.

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

การตอบกลับ#

The account's designed voices.

voicesarray of objectsจำเป็น

The account's designed voices, oldest first.

ดูฟิลด์ย่อย

voices[].idstringจำเป็น

The voice id, starting "voice_". Send it as voice with model paxa-tts-flash-v2 on POST /v1/tts, POST /v1/audio/speech, or the /v1/tts/live socket.

voices[].namestringจำเป็น

Display name, which PATCH changes. The voice field does not accept it.

voices[].rolestringจำเป็น

Who the voice is, in a few words.

voices[].descriptionstringจำเป็น

How the voice sounds, in one sentence.

voices[].gender"f" or "m"จำเป็น

Voice gender, "f" or "m".

voices[].language"th" or "en" or "zh"จำเป็น

The one language the voice speaks: "th" (Thai), "en" (English), or "zh" (Mandarin Chinese, Simplified script).

voices[].modelstringจำเป็น

The model the voice speaks on.

voices[].created_atstringจำเป็น

Save time, ISO 8601.

slotsobjectจำเป็น

The account's voice slots.

ดูฟิลด์ย่อย

slots.usedintegerจำเป็น

Designed voices the account holds.

slots.limitintegerจำเป็น

Designed voices the plan allows. After a downgrade, used can exceed it: every saved voice keeps speaking, and saving waits until used is below limit.

ข้อผิดพลาด#

401unauthorizedThe request carried no API key, or the key is invalid or disabled.

ก่อนหน้าออกแบบเสียง ถัดไปบันทึกเสียงที่ออกแบบเอง