跳到主要內容
網頁與行動應用程式

用於網頁與行動應用程式的語音代理 API

在應用程式中加入語音代理，通常意味著要買一個用不到的電話號碼，或是自己串接語音轉文字、模型與語音，同時還得讓 API 金鑰不出現在裝置上。 適合想把語音代理放進自家應用程式、而不是電話線路上的產品團隊：接聽電話的同一批代理、引擎、知識庫和預約功能，都能從瀏覽器分頁或行動應用程式透過 wss://api.voice.wixzel.com/v1/realtime 使用。不需要連接任何東西，也不需要購買號碼。您的伺服器簽發一次性的工作階段，因此您的 API 金鑰永遠不會到達用戶端，而工作階段會像同一引擎上的通話一樣，依秒從同一個預付餘額扣款。

最後更新於

建立帳號快速入門
手機應用程式畫面，中間是一個大型綠色吉祥物，上方對話框裡是一句問候，下方是一個「對話」按鈕

如何用 Wixzel Voice 建立網頁或行動應用程式的語音代理？

  1. 01
    POST /v1/agents

    建立代理：提示詞、開場白、知識庫和語音引擎。它和電話通話會接到的代理是同一個。

  2. 02
    POST /v1/realtime/sessions

    從您的伺服器使用 API 金鑰：指定代理，並可選擇性指定允許的瀏覽器來源和您自己的中繼資料，取得一個只能使用一次、有效一分鐘、僅適用於該代理的 client_secret。

  3. 03
    wss://api.voice.wixzel.com/v1/realtime

    您的用戶端用這個密鑰開啟 socket 並串流音訊。在瀏覽器中，wixzel-voice/realtime 的 RealtimeSession 會處理麥克風、播放和插話；在 Flutter 中，wixzel_voice 套件的 RealtimeConnection 負責通訊協定，麥克風和喇叭由您的應用程式提供。

  4. 04
    GET /v1/calls/{id}

    每個工作階段都是一筆 channel 為 web 的通話紀錄：包含逐字稿、時長、費用和您的中繼資料，結束時也會發送同樣的 callCompleted webhook。

  5. 05
    wixzel-voice/mascot, wixzel_voice_flutter

    選用：在代理說話時顯示它的吉祥物，也就是它的動畫臉孔。在網頁中，wixzel-voice/mascot 的 mountMascot 負責繪製，face.connect(session) 則讓通話進行時嘴型同步。在 Flutter 中，wixzel_voice_flutter 套件的 AgentMascotView 負責繪製，MascotRealtimeLink 讓它與 RealtimeConnection 保持同步。

哪種語音引擎適合網頁或行動應用程式中的語音代理？

在 Wixzel Voice 上使用 gemini-live 引擎，每接通一分鐘 $0.0491。由一個即時模型負責聆聽、思考與說話，因此往返時間就是 Gemini 本身的表現，而且它是每分鐘最便宜的引擎。sarvam 管線也能透過 socket 執行，適用於印度語言；需要特定 ElevenLabs 語音時，classic 也可以。

在 Wixzel Voice 上，網頁或行動應用程式中的語音代理的費用是多少？

Wixzel Voice 在 gemini-live 引擎上進行 4 分鐘工作階段的引擎時間，以一般語速計算，依實際用量逐秒計費。由於沒有電話線路，因此沒有電信費用；工作階段越短，費用也按比例越低。

每月工作階段數接通分鐘數每月引擎費用
5002,000$98.20
2,50010,000$491
10,00040,000$1,964

預付制：從 $5 起儲值點數，工作階段會從中扣除。估算您自己的組合。

哪些指南說明如何在 Wixzel Voice 上建立網頁或行動應用程式的語音代理？

用 Wixzel Voice 透過 WebSocket 在 Flutter 中加入語音代理

讓使用者在 Flutter 應用程式中與您的語音代理對話：您的伺服器建立工作階段，`wixzel_voice` Dart SDK 透過 WebSocket 串流音訊，不需要 SIP 中繼或號碼。

用 Wixzel Voice 在您的網站加入會說話的 AI 吉祥物

用您的網站建立代理，開啟其吉祥物的網站小工具，再貼上一個 script 標籤。訪客在瀏覽器中撥打給它，並受您設定的上限和來電者規則約束。

用 Wixzel Voice 在 Flutter 應用程式中顯示代理的吉祥物

用 `wixzel_voice_flutter` 套件在 Flutter 應用程式中繪製語音代理的動態吉祥物，並讓它在即時通話中同步聆聽、思考和說話。

吉祥物文件

變更代理的外觀，以連結或網站小工具分享，並設定誰可以撥打以及每日上限。

即時 API 文件

在您的伺服器上建立工作階段，透過 WebSocket 串流音訊，不需要中繼，也不需要號碼。

常見問題

我可以把在 Wixzel Voice 上建立的語音代理放進我的網站或行動應用程式嗎？

可以。您的伺服器使用 API 金鑰呼叫 POST /v1/realtime/sessions 並取得 client_secret；您的網頁或應用程式用它開啟 wss://api.voice.wixzel.com/v1/realtime，雙向串流音訊。代理、引擎、提示詞和知識庫，都和電話通話使用的相同。過程中不涉及 SIP 中繼或電話號碼。

我的瀏覽器或應用程式需要我的 API 金鑰嗎？

不需要，而且絕對不能讓它取得。用戶端只會持有由您的伺服器簽發的 client_secret，它只能使用一次、有效一分鐘、僅適用於一個代理。針對瀏覽器，請在簽發時傳入 allowed_origins，來自其他網站的 socket 連線都會被拒絕，因此從您網頁複製出去的密鑰在別處毫無用處。

哪些 SDK 支援即時 API？

TypeScript SDK（npm 上的 wixzel-voice）提供瀏覽器用戶端 RealtimeSession，會請求麥克風權限、編碼並播放音訊，並處理使用者打斷代理的情況。Dart SDK（pub.dev 上的 wixzel_voice）提供適用於 Flutter 和 Dart 的 RealtimeConnection，負責通訊協定，麥克風和喇叭則由您的應用程式提供。其他環境請直接使用通訊協定：透過 WebSocket 傳送 JSON 訊框，音訊為 base64 編碼的 8 kHz G.711 µ-law。

網頁與應用程式工作階段的音質如何？

電話音質。雙向音訊都是 8 kHz 的 G.711 µ-law，與電話線路相同，因為這些工作階段和通話走的是同一條媒體路徑。這對語音來說沒有問題，但與瀏覽器音訊為寬頻的平台相比確實是一項限制；我們在這裡先說明，而不是讓您事後才發現。

網頁或應用程式工作階段如何計費？

與同一引擎上的電話通話完全相同：同樣的每分鐘價格、從同一個預付餘額依秒扣款，並在 GET /v1/usage/events 中逐項列出。因為沒有電話線路，所以沒有電信費用。工作階段計入帳號的同時通話上限，預設為五通。簽發工作階段不收費，因此使用者開啟您的網頁後拒絕麥克風權限，您也不需付費。

一個工作階段可以持續多久？

預設為十分鐘。簽發工作階段時設定 max_duration_seconds，範圍從 10 秒到一小時，伺服器會在時間到時結束工作階段。代理和您的用戶端也都可以結束它。

它能在 Flutter 中使用嗎？

可以。Dart SDK 的 RealtimeConnection 負責 socket 和通訊協定。您的應用程式用任何錄音外掛錄製 8 kHz 的 16 位元 PCM，用 SDK 提供的輔助函式轉換成 µ-law，再用任何 PCM 播放器播放代理的音訊。請開啟回音消除，否則代理會從喇叭聽到自己的聲音。

我的應用程式可以在代理說話時顯示它的臉嗎？

可以。每個 Wixzel Voice 代理都有一個吉祥物，這是一張依代理 mascot 欄位中的小型規格繪製的動畫臉孔。在網頁中，wixzel-voice/mascot（npm 上的 wixzel-voice 0.10.0）的 mountMascot 會把它畫在 canvas 上，face.connect(session) 會啟動即時通話，讓嘴型隨代理的音訊同步移動。在 Flutter 中，pub.dev 上的 wixzel_voice_flutter 套件提供 AgentMascotView 來繪製它，並提供 MascotRealtimeLink 讓它隨 RealtimeConnection 一起聆聽、思考和說話。在 Flutter 中兩者都不會替您錄音或播放音訊；網頁輔助工具則兩者都會處理。

有完全不需要寫程式的版本嗎？

有，適用於網站：吉祥物小工具。為代理開啟它，在 embed_origins 中列出您的網站，貼上一個 script 標籤，訪客就能從網頁角落與代理通話。它底層使用同樣的即時 API，計費方式也相同。請參閱「為您的網站加入 AI 語音助理」。

代理商與開發者還在 Wixzel Voice 上建立什麼？

預約安排

建立一個代理，接聽電話、查詢可預約時段並建立預約，透過您自己的 SIP 中繼運作，預約結果再經由 API 寫回。

外撥潛在客戶篩選

上傳潛在客戶、啟動活動，讓代理透過您自己的 SIP 中繼逐一撥打，並詢問您的篩選問題。每通通話都是一筆紀錄，包含狀態與逐字稿，並連結到對應的潛在客戶。

來電客服專線

用代理接聽客服號碼：它會讀取您上傳的知識庫、處理常見問題，並為每通通話留下逐字稿。

印度語言

以專為印度語言打造的模型執行電話代理，由 sarvam 引擎從頭到尾涵蓋語音轉文字、語言模型與文字轉語音。

網站語音助理

只要一個 script 標籤，就能在您的網站上放置會說話的 AI 助理：以您的網站建立的代理，搭配訪客可從瀏覽器撥打的動畫吉祥物，並提供來電者資訊、來電權限設定和每日上限。

由 AI 代理撥打電話

將 Claude Code、Codex、Cursor 或任何 MCP 用戶端連接到您的帳號，讓 AI 代理連接電信業者、建立語音代理、撥打通話、執行活動並讀取逐字稿，而每個會花錢的工具都會先詢問您。

低成本 AI 通話

以每分鐘幾美分的成本執行 AI 電話通話：從預付點數依秒計費，沒有訂閱或最低消費，使用您自己的 SIP 中繼且電信費用不加價，每筆費用都逐項列出。

會說話的 AI 虛擬角色

為語音代理加上一張臉：一個與代理口型同步的動畫虛擬角色，可用於網站、分享連結、網頁應用程式或 Flutter 應用程式，虛擬角色不另收費。

代理商專用

在每位客戶自己的帳號和電信業者上、以客戶的語言為其建立電話代理，並在依秒計費的成本之上收取月費。

Wixzel Voice 的所有事實資料

營運者、價格、限制、退款與資料位置，都在同一頁。

建立您的第一個語音代理

註冊閱讀快速入門