Skip to main content

ตั้งค่า TTS (Text-to-Speech)

TTS คือ engine ที่อ่านข้อความ donation ออกมาเป็นเสียงระหว่างไลฟ์ แอปรองรับ 4 provider:

Providerค่าใช้จ่ายคุณภาพAPI key?
Web Speech APIฟรีพื้นฐาน (ตามเสียงของ OS/browser)ไม่ต้อง
Google Cloud TTSจ่ายต่อ charสูง (Chirp3-HD)ต้อง
OpenAI TTSจ่ายต่อ charสูง (เสียงธรรมชาติ)ต้อง
Gemini TTSจ่ายต่อ tokenสูง (30 voices + style prompt)ต้อง

สิ่งที่ต้องเตรียม​

  • ตัดสินใจว่าจะใช้ provider ไหนเป็นหลัก
  • ถ้าเลือก provider ที่เสียเงิน — เตรียม API key ไว้
  • ลำโพง/หูฟังสำหรับฟัง preview

ขั้นที่ 1 — (ถ้าใช้ provider จ่ายเงิน) ใส่ API Key ก่อน​

API key ต้องตั้งใน Connections tab ก่อน ไม่ใช่ใน TTS tab

  1. ไปที่ Settings → Connections
  2. หาแถบ provider ที่จะใช้: Google Cloud TTS, OpenAI, หรือ Gemini
  3. วาง API key ในช่องที่ตรง
  4. กด Save

ถ้าใช้ Web Speech API อย่างเดียว — ข้ามขั้นนี้ได้

ขั้นที่ 2 — เลือก Primary Provider​

  1. ไปที่ Settings → TTS Voice tab
  2. ที่ส่วน Provider เลือก provider หลักที่ต้องการ
  3. ตัวเลือก voice / config จะเปลี่ยนตาม provider ที่เลือก

ขั้นที่ 3 — ตั้ง Voice / Speed / Pitch​

ตามแต่ละ provider:

  • Web Speech — เลือก voice จากที่ OS มี (เสียงไทยจะมีถ้าลง language pack ไว้)
  • Google Cloud TTS — เลือก voice เช่น th-TH-Chirp3-HD-Despina, ปรับ speakingRate (0.25–4.0) และ pitch
  • OpenAI TTS — เลือก model (tts-1 / tts-1-hd), voice (alloy / ash / coral / echo / fable / nova / onyx / sage / shimmer), speed
  • Gemini TTS — เลือก voice 1 ใน 30 ตัว (มี descriptor: Bright, Upbeat, Firm…) + style prompt เช่น "พูดร่าเริง"

ขั้นที่ 4 — ทดสอบด้วย Preview​

ทุก provider มีปุ่ม Preview:

  1. กรอกข้อความตัวอย่าง (เช่น "สวัสดีครับ ขอบคุณสำหรับการโดเนท")
  2. กด Preview / ▶ ฟัง
  3. ฟังเสียงทันที — ปรับ voice / speed / pitch ใหม่ถ้ายังไม่พอใจ

:::tip ทดสอบใน Test Panel ก็ได้ หน้า Test Panel (/test) มีช่อง TTS Preview ที่แยกออกมาด้วย — ทดสอบ TTS โดยไม่ต้องกลับมาที่ Settings :::

ขั้นที่ 5 — ตั้ง Fallback Provider​

Fallback provider จะถูกใช้อัตโนมัติเมื่อ primary ล้มเหลว (เช่น quota หมด, API down) ถ้า fallback ก็ล้มอีก แอปจะตกไปใช้ Web Speech เป็น last resort

  1. ในส่วนเดียวกัน หา Fallback Provider
  2. แนะนำตั้งเป็น Web Speech (ฟรี ใช้งานเสมอ) — ถ้าใช้ paid provider เป็นหลัก

ขั้นที่ 6 — (ทางเลือก) ตั้ง Min Donation / Max Length​

เลื่อนลงด้านล่างใน TTS tab:

  • ttsMinDonation — ยอดต่ำสุดที่จะอ่าน TTS (เช่น 5฿ ขึ้นไป) — donation ต่ำกว่านี้ข้ามเลย
  • ttsMaxMessageLength — จำกัดความยาวข้อความ (chars) — ตัดท้ายถ้ายาวเกิน

Tips & Troubleshooting​

  • Web Speech ไม่มีเสียงไทย: ติดตั้ง Thai language pack ใน Windows Settings → Time & Language → Speech
  • Google TTS error 403: ตรวจว่าเปิด Cloud Text-to-Speech API ใน Cloud Console + API key ไม่หมดอายุ
  • OpenAI ใช้เครดิตเยอะ: ลองสลับเป็น tts-1 (ถูกกว่า tts-1-hd) หรือเปิด min donation filter
  • Gemini Auto-Tone: เป็นโหมดพิเศษสำหรับ Gemini — ดู คู่มือ Gemini Auto-Tone

:::tip Audio Cache Donari cache ไฟล์ TTS ที่ generate แล้ว 24 ชม. — ข้อความซ้ำไม่เปลือง API quota :::

ดูเพิ่มเติม​