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

    bash
    DEEPGRAM_API_KEY=dg_...
  • เปิดใช้งานผู้ให้บริการเสียง

    json5
    {  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):

    พร้อมคำใบ้ภาษา

    json5
    {  tools: {    media: {      audio: {        enabled: true,        models: [{ provider: "deepgram", model: "nova-3", language: "en" }],      },    },  },}

    พร้อมตัวเลือก Deepgram

    json5
    {  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
    json5
    {  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 เมื่อใช้พร็อกซี

    ลักษณะการทำงานของผลลัพธ์

    ผลลัพธ์เป็นไปตามกฎด้านเสียงเดียวกับผู้ให้บริการรายอื่น (ขีดจำกัดขนาด ระยะหมดเวลา และการแทรกข้อความถอดเสียง)

    ที่เกี่ยวข้อง

    Was this useful?
    On this page

    On this page