Providers
Deepgram
Deepgram คือ API แปลงเสียงเป็นข้อความ OpenClaw ใช้ API นี้เพื่อถอดเสียงไฟล์เสียง/ข้อความเสียงขาเข้าผ่าน tools.media.audio และใช้สำหรับ STT แบบสตรีมของ Voice Call ผ่าน plugins.entries.voice-call.config.streaming
การถอดเสียงแบบแบตช์จะอัปโหลดไฟล์เสียงทั้งหมดไปยัง Deepgram และแทรกข้อความถอดเสียงลงในกระบวนการตอบกลับ (บล็อก {{Transcript}} + [Audio]) ส่วนการสตรีมของ Voice Call จะส่งต่อเฟรม G.711 u-law แบบสดผ่านปลายทาง WebSocket listen ของ Deepgram และส่งข้อความถอดเสียงบางส่วน/ฉบับสมบูรณ์ออกมาเมื่อ Deepgram ส่งกลับ
| รายละเอียด | ค่า |
|---|---|
| เว็บไซต์ | deepgram.com |
| เอกสาร | developers.deepgram.com |
| การยืนยันตัวตน | DEEPGRAM_API_KEY |
| โมเดลเริ่มต้น | nova-3 |
เริ่มต้นใช้งาน
ตั้งค่าคีย์ API
DEEPGRAM_API_KEY=dg_...เปิดใช้งานผู้ให้บริการเสียง
{ tools: { media: { audio: { enabled: true, models: [{ provider: "deepgram", model: "nova-3" }], }, }, },}ส่งข้อความเสียง
ส่งข้อความเสียงผ่านช่องทางใดก็ได้ที่เชื่อมต่ออยู่ OpenClaw จะถอดเสียง ผ่าน Deepgram และแทรกข้อความถอดเสียงลงในกระบวนการตอบกลับ
ตัวเลือกการกำหนดค่า
| ตัวเลือก | พาธ | คำอธิบาย |
|---|---|---|
model |
tools.media.audio.models[].model |
รหัสโมเดล Deepgram (ค่าเริ่มต้น: nova-3) |
language |
tools.media.audio.models[].language |
คำใบ้ภาษา (ไม่บังคับ) |
providerOptions.deepgram จะผสานพารามิเตอร์คำขอเพิ่มเติมเข้ากับคำขอ /listen ของ Deepgram โดยตรง ดังนั้นจึงใช้ชื่อพารามิเตอร์ใด ๆ ที่ Deepgram รองรับได้ (ตัวอย่างเช่น detect_language, punctuate, smart_format):
พร้อมคำใบ้ภาษา
{ tools: { media: { audio: { enabled: true, models: [{ provider: "deepgram", model: "nova-3", language: "en" }], }, }, },}พร้อมตัวเลือก Deepgram
{ tools: { media: { audio: { enabled: true, providerOptions: { deepgram: { detect_language: true, punctuate: true, smart_format: true, }, }, models: [{ provider: "deepgram", model: "nova-3" }], }, }, },}STT แบบสตรีมของ Voice Call
Plugin deepgram ที่รวมมาให้ยังลงทะเบียนผู้ให้บริการถอดเสียงแบบเรียลไทม์สำหรับ Plugin Voice Call ด้วย
| การตั้งค่า | พาธการกำหนดค่า | ค่าเริ่มต้น |
|---|---|---|
| คีย์ API | plugins.entries.voice-call.config.streaming.providers.deepgram.apiKey |
ใช้ DEEPGRAM_API_KEY เป็นค่าทดแทน |
| โมเดล | ...deepgram.model |
nova-3 |
| ภาษา | ...deepgram.language |
(ไม่ได้ตั้งค่า) |
| การเข้ารหัส | ...deepgram.encoding |
mulaw |
| อัตราการสุ่มตัวอย่าง | ...deepgram.sampleRate |
8000 |
| การตรวจหาจุดสิ้นสุด | ...deepgram.endpointingMs |
800 |
| ผลลัพธ์ระหว่างดำเนินการ | ...deepgram.interimResults |
true |
{ plugins: { entries: { "voice-call": { config: { streaming: { enabled: true, provider: "deepgram", providers: { deepgram: { apiKey: "${DEEPGRAM_API_KEY}", model: "nova-3", endpointingMs: 800, language: "en-US", }, }, }, }, }, }, },}หมายเหตุ
การยืนยันตัวตน
การยืนยันตัวตนเป็นไปตามลำดับการยืนยันตัวตนมาตรฐานของผู้ให้บริการ การใช้ DEEPGRAM_API_KEY
เป็นวิธีที่ง่ายที่สุด
พร็อกซีและปลายทางแบบกำหนดเอง
เขียนทับปลายทางหรือส่วนหัวด้วย tools.media.audio.baseUrl และ
tools.media.audio.headers เมื่อใช้พร็อกซี
ลักษณะการทำงานของผลลัพธ์
ผลลัพธ์เป็นไปตามกฎด้านเสียงเดียวกับผู้ให้บริการรายอื่น (ขีดจำกัดขนาด ระยะหมดเวลา และการแทรกข้อความถอดเสียง)