Providers

Deepgram

Deepgram هي واجهة API لتحويل الكلام إلى نص. يستخدمها OpenClaw لنسخ الصوت الوارد/الملاحظات الصوتية عبر tools.media.audio، ولتحويل الكلام إلى نص أثناء بث المكالمات الصوتية عبر plugins.entries.voice-call.config.streaming.

يرفع النسخ الدفعي ملف الصوت كاملًا إلى Deepgram ويدرج النص المنسوخ في مسار معالجة الرد ({{Transcript}} + كتلة [Audio]). يمرر بث المكالمات الصوتية إطارات 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 معاملات استعلام إضافية مباشرةً في طلب Deepgram‏ /listen، لذا يعمل أي اسم معامل تدعمه 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" }],      },    },  },}

    تحويل الكلام إلى نص أثناء بث المكالمات الصوتية

    يسجّل Plugin‏ deepgram المضمّن أيضًا موفّرًا للنسخ في الوقت الفعلي لـ Plugin المكالمات الصوتية.

    الإعداد مسار الإعداد الافتراضي
    مفتاح 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