Tallgeese AI Nova API

對話記錄

自動儲存「對話助手」同「Robot API」嘅對話。以下顯示全部記錄，可以繼續（UI 對話）或者刪除。

未有對話記錄。

選擇一個 Tallgeese chatbot，然後開始提問。

Robot API 註冊

將選中嘅 Tallgeese chatbot 加入你嘅帳戶。系統會分配一個 robotchatbotid（唔係 Tallgeese chatbot UUID）。呼叫 /robotapi/chat 時傳 source=tallgeeseai 同 robotchatbotid 就會用呢個 bot； source=server 用 Llama Server；否則用 source=llm 本地 Ollama。 Admin / Manager 可以睇到所有帳戶嘅 bots；一般用戶只睇到自己嘅。

尚未註冊任何 Robot chatbot。

API Keys

所有 /robotapi/* 呼叫都需要 API key（最多 10 個）。 Key 只會喺建立／重置時顯示一次，伺服器只保存雜湊值。每把 key 可設定鎖定嘅 prefill prompt，呼叫端唔可以覆寫。

請立即複製呢把新 key——之後唔會再顯示。

請先登入以管理 API keys。

POST /robotapi/tts · 文字轉語音快速測試

純文字 → 語音（唔經 STT / LLM）。先按 language 揀引擎，再按 gender 揀男／女聲。粵語預設 VITS （fast-cantonese）；英語 sherpa-onnx，普通話 sherpa-onnx。

POST / GET /robotapi/tts

認證（必填）

Header：X-API-Key: rsk_…

參數

text（必填）— 要朗讀嘅文字

voice（選填）— fast-cantonese（VITS 快速粵語預設）、 fast-cantonese-female／fast-cantonese-male、 ai（CosyVoice，對應 yue_male_young）、 sherpa-english／sherpa-english-female／sherpa-english-male（英語）、 sherpa-mandarin／sherpa-mandarin-female／sherpa-mandarin-male（普通話）、或具體 CosyVoice 聲線 ID： yue_male_young、yue_default、yue_male 等。實際 TTS 引擎會按 language + gender 自動揀（粵語 VITS／CosyVoice，英／普 sherpa-onnx）。

language（選填）— auto（預設，Whisper + SenseVoice 自動分辨粵語／普通話／英語）、 cantonese、mandarin、english（指定則跳過語種偵測，直接用該語言）。

gender（選填）— male／female。先 language 再 gender：粵語 VITS，英語／普通話 sherpa。

pause（選填，秒）— 逗號停頓，預設 0.08；句號約 1.7 倍。範圍 0–3。

format（選填）— wav（預設）或 mp3

粵語會用所選粵語男／女聲；英語／普通話會用 sherpa-onnx（可揀 sherpa-english*、sherpa-mandarin*，或沿用所選聲線嘅性別自動切換）。

範例用聲線

回應

Body：audio/wav 或 audio/mpeg

Headers：X-Robot-Voice、X-Robot-Tts-Language、X-Robot-Gender、X-Robot-Elapsed-Ms

POST /robotapi/chat

上傳 MP3 / MP4（或其他常見音訊），伺服器自動完成 語音識別 → 對話（預設 Ollama；可選 Llama Server）→ 語音回覆，並回傳 MP3 回覆音訊。語言由 language 決定整條 pipeline：粵語 → 粵語 LLM + VITS／CosyVoice；英語 → 英文 LLM + sherpa-onnx 英語 TTS；普通話 → 書面中文 LLM + sherpa-onnx 普通話 TTS。

POST /robotapi/chat

認證（必填）

Header：X-API-Key: rsk_… 或 Authorization: Bearer rsk_…

Form 欄位

audio（必填）— 音訊／影片檔（mp3、mp4、wav…）

voice（選填，預設 fast-cantonese）— fast-cantonese（VITS 快速粵語預設聲線）、 fast-cantonese-female／fast-cantonese-male、 ai（CosyVoice，對應 yue_male_young）、 sherpa-english／sherpa-english-female／sherpa-english-male（sherpa-onnx 英語）、 sherpa-mandarin／sherpa-mandarin-female／sherpa-mandarin-male（sherpa-onnx 普通話）、或 CosyVoice 聲線 ID： yue_male_young、yue_default、yue_male 等。 language 決定整條 pipeline：英語 → 英文 LLM + sherpa 英語 TTS；普通話 → 書面中文 LLM + sherpa 普通話 TTS；粵語 → 粵語 LLM + 你揀嘅粵語聲線。

範例用聲線（同步更新下面程式碼）

language（選填）— auto（預設／可省略）→ Whisper + SenseVoice 自動偵測； cantonese／mandarin／english → 跳過偵測，整條 pipeline（STT／LLM／TTS）直接用該語言。

gender（選填）— male／female。先按 language 揀引擎，再按性別揀聲線。粵語預設 VITS（fast-cantonese／-female／-male）；英語／普通話用 sherpa-onnx。

pause（選填，秒）— 逗號／、停頓，預設 0.08；句號／？／！約 1.7 倍。範圍 0–3，例如 0.5、1。

max_tokens（選填）— 覆蓋預設 LLM max tokens（16–8192）

history（選填）— JSON 陣列（只接受 user/assistant；system／prefill 會被忽略）

source（選填）— llm（預設，Ollama）或 server（llama-server）

ragdb（選填）— 本地知識庫名稱；只對 source=llm／source=server 生效。有傳：按該庫嚴格回答；唔傳：自由回答。

本地 RAG（對話）

呼叫 /robotapi/chat 時加 ragdb=庫名（只對 llm／server）。唔傳則自由回答。

Prefill Prompt

每把 API key 可喺管理介面設定專屬 prefill；伺服器強制套用，呼叫端唔可以覆寫。適用於 source=llm（Ollama）同 source=server（Llama Server）。

System Prompt 覆寫

GET/PUT /robotapi/system-prompt — 設定粵語／英語／普通話 system prompt 覆寫。留空＝用內建預設。

User Prompt 覆寫

GET/PUT /robotapi/user-prompt — 設定會加喺用戶訊息前面嘅覆寫。留空＝用內建預設。

Action Prompt

PUT /robotapi/settings 嘅 action_prompt — 附加喺 system prompt 後面（系統覆寫仍然生效）。唔會加喺用戶訊息，所以口頭稿唔會讀到 actioncommand。

回應

Body：audio/mpeg（robot-reply.mp3）

Headers：X-Robot-Job-Id、X-Robot-Transcript、X-Robot-Reply、 X-Robot-Actions（URL-encoded JSON 陣列，每項 {"startsecond":number,"actioncommand":string}；可同時有多個動作。預設冇動作，陣列為 []。可喺 LLM 設定加入 Action Prompt）、 X-Robot-Provider、X-Robot-Rag、X-Robot-Rag-Db

Admin 進度

GET /robotapi/jobs · GET /robotapi/jobs/{id}（同樣需要 API key）

回應範例（/robotapi/chat）

RAG 管理 API

用 API key 管理本地知識庫：列出／新增／改名／刪除庫，以及對指定庫上傳或多個檔案批次移除。名稱規則：1–20 字元，只允許 [A-Za-z0-9_]，唔可以重複。

CRUD /robotapi/rag/dbs

認證（必填）

Header：X-API-Key: rsk_…

知識庫

GET /robotapi/rag/dbs — 列出全部

POST /robotapi/rag/dbs — 新增（JSON {"name":"school_handbook"}）

GET /robotapi/rag/dbs/{name} — 睇一個庫＋檔案

PUT /robotapi/rag/dbs/{name} — 改名（JSON {"name":"new_name"}）

DELETE /robotapi/rag/dbs/{name} — 刪除整個庫

檔案

GET /robotapi/rag/dbs/{name}/documents — 列出檔案

POST /robotapi/rag/dbs/{name}/documents — 上傳多個（form field files）

POST /robotapi/rag/dbs/{name}/documents/delete — 批次移除（JSON {"document_ids":["rag_…"]}）

DELETE /robotapi/rag/dbs/{name}/documents/{doc_id} — 移除單一檔

回應範例（RAG 管理）

LLM 設定

對話助手同 Robot API 預設用本地對話服務（Ollama）。可選 source=server 用本機 Llama Server。單次 Robot API 呼叫可用 form 欄位 max_tokens 覆蓋 token 上限。系統 prompt 限制回覆最多約 80 個字／詞；預設 max tokens 為 160。

Max tokens（本地 LLM）

System Prompt

覆寫本地 LLM／Llama Server 嘅基礎 system prompt（留空＝用內建預設）。 API：GET/PUT /robotapi/system-prompt。

語言

System prompt

Action Prompt

附加喺 system prompt 後面（系統覆寫仍然生效）。唔會加喺用戶訊息，所以唔會當口頭稿朗讀。可要求多個動作。留空＝唔要求動作（X-Robot-Actions 預設 []）。

Action prompt

User Prompt 覆寫

覆寫會加喺用戶訊息前面（留空＝用內建預設）。 API：GET/PUT /robotapi/user-prompt。

語言

User prompt 覆寫

Llama Server（source=server）

啟用 Llama Server

本地對話服務位址由伺服器環境變數設定。

Tallgeese AI 連線

呢度只係設定 Tallgeese 認證；唔會改對話助手／預設 Robot API 嘅 LLM。

Tallgeese Base URL

Tallgeese API Key

Chat 模式

Chat URL 覆寫（選填）

驗證 SSL 憑證

預設 Chatbot（Tallgeese 分頁用）

RAG 知識庫

可建立多個本地知識庫。呼叫 /robotapi/chat 時傳 ragdb=<名稱>，則 source=llm／source=server 會按該庫回答（超出範圍會拒絕）； 唔傳 ragdb 就自由回答。

請先登入以管理知識庫。

帳戶管理

只有 Super Admin 可以建立同管理帳戶。角色：admin（全部權限）、 manager（管理權限）、 user（一般帳戶）。

載入中……

Tallgeese AI Nova API

對話記錄

Robot API 註冊

API Keys

POST /robotapi/tts · 文字轉語音快速測試

POST /robotapi/chat

RAG 管理 API

LLM 設定

System Prompt

Action Prompt

User Prompt 覆寫

Llama Server（source=server）

Tallgeese AI 連線

RAG 知識庫

知識庫

檔案（TXT / PDF / Word DOCX）

Admin · 處理進度

帳戶管理