บรรยายว่าผู้พูดเป็นใครและเสียงฟังเป็นแบบไหน เช่น อายุ เพศ ระดับเสียง จังหวะ ท่าทีการพูด และภาษาที่พูด เสียงจะพูดภาษาที่คำบรรยายระบุ ถ้าไม่ได้ระบุจะพูดภาษาที่ใช้เขียนคำบรรยาย ชื่อ บทบาท และคำอธิบายของเสียงจะกลับมาเป็นภาษาที่ใช้เขียนคำบรรยาย
ถ้าอยากปรับเสียง ให้ส่ง draft กลับมาพร้อม instruction เช่น "ทุ้มลงอีกนิดและพูดช้าลง" ทุกการตอบกลับมี draft ใหม่ และเสียงจะมีอยู่จริงเมื่อคุณบันทึก draft นั้นแล้วเท่านั้น
แต่ละคำขอคิด 5 เครดิต รวมประโยคตัวอย่างแล้ว คิดก่อนเริ่มทำงาน และคืนให้อัตโนมัติเมื่อไม่ได้เสียงกลับมา การส่งซ้ำจะออกแบบเสียงใหม่และคิดเครดิตอีกครั้ง เอนด์พอยต์นี้จึงปฏิเสธ Idempotency-Key ด้วย 400 validation แต่ละคำขอนับในอัตราจำกัดคำขอและใช้หนึ่งช่องคำขอพร้อมกันฝั่งเสียงพูดของแพ็กเกจ
เฮดเดอร์#
authorizationBearer pxa_...จำเป็นAuthorization: Bearer pxa_... (recommended).
x-api-keypxa_...Alternative to the Authorization header. Ignored when Authorization is present.
เนื้อหา#
descriptionstringWho the voice is and how it sounds, in English, Thai, or Chinese, up to 1,000 characters: age, gender, pitch, pace, manner, and the language it speaks. The voice speaks the language this names, else the language this is written in, and its name, role, and description come back in the language this is written in.
draftstringA draft an earlier design response returned, to refine that voice. Send it with instruction and without description.
instructionstringWhat to change about the draft's voice, up to 500 characters, such as "a little lower and slower". The rest of the voice stays as it was.
การตอบกลับ#
A designed voice, ready to refine or save.
draftstringจำเป็นThe voice, sealed. Send it back with an instruction to refine the voice, or to POST /v1/voices/designed to save it. It opens only for this account.
voiceobjectจำเป็นThe designed voice's words.
ดูฟิลด์ย่อยซ่อนฟิลด์ย่อย
voice.namestringจำเป็นA name for the voice, which saving keeps unless you send another.
voice.rolestringจำเป็นWho the voice is, in a few words.
voice.descriptionstringจำเป็นHow the voice sounds, in one sentence.
voice.gender"f" or "m"จำเป็นVoice gender, "f" or "m".
voice.language"th" or "en" or "zh"จำเป็นThe one language the voice speaks: "th" (Thai), "en" (English), or "zh" (Mandarin Chinese, Simplified script).
voice.linestringจำเป็นThe example line audio speaks, up to 120 characters in the voice's language.
voice.modelstringจำเป็นThe model the voice speaks on, paxa-tts-flash-v2.
audiostringจำเป็นThe example line spoken in the voice, as base64 MP3.
usageobjectจำเป็นWhat the request was billed for.
ดูฟิลด์ย่อยซ่อนฟิลด์ย่อย
usage.creditsnumberจำเป็นWhat this turn cost, 5 credits.