v1.0.11.0 正式版:六個工具,一個工作區。看新功能 →

API QR CodeBETA

掃一下
手機就用上
這台電腦的 AI

讓同一個網路上的手機、平板或其他裝置掃描 QR 碼,透過這台電腦已載入的模型使用 AI。支援 OpenAI 相容 API 的 App 都可以接上 — 不用手抄網址,也不用複製金鑰。

你的電腦
armor-studio.local · 2918
已連上 Armor Studio幫我想三個週末行程一、河濱騎車 + 早午餐;二、市立美術館…回答來自你電腦上的模型

01 — How It Works

一台裝置 一個 QR 碼

每個 QR 碼都是一把新的連線金鑰。給每台裝置各產生一個,之後可以個別撤銷,不影響其他裝置。

  1. 1

    開啟區網分享

    在設定開啟一次,重新啟動 Armor EdgeAI 後,同一個網路上的裝置就連得到這台電腦。

  2. 2

    產生 QR 碼

    側欄「進階 → API QR Code」,替裝置取個名字(例如「客廳平板」)再按產生。

  3. 3

    用 App 掃描

    支援 API QR Code 的 App 掃描後,自動帶入電腦名稱、位址與這台裝置專用的金鑰。

  4. 4

    使用已載入的模型

    裝置用的是你在電腦上載入的對話模型;換模型後,裝置下一次請求就會用新的。

02 — In The App

先看狀態 再產生

App 內的 API QR Code 頁先告訴你三件事:區網分享開了沒、載入了哪個模型、會放進 QR 碼的位址。下方是可以操作的示意。

示意狀態
Armor EdgeAI — API QR Code
API QR CodeBeta
區網分享已開啟同一個網路上的裝置可以連到這台電腦。
對話模型Qwen 3.8 27B Vision裝置會使用這個模型。換模型後,裝置下一次請求就會用新的。
連線位址armor-studio.local192.168.1.24100.88.12.7VPN另有 2 個位址,都會放進 QR 碼。
產生 QR 碼每個 QR 碼是一把新的連線金鑰。給每台裝置各產生一個,之後可以個別撤銷。
QR 碼會出現在這裡
已用 QR 碼連線的裝置1 台
  • 客廳平板建立 10-21最近使用 今天

示意畫面:QR 碼為裝飾圖案、不能真的掃描;電腦名稱與位址皆為虛構。裝置連不上時,請在 Windows 防火牆允許 Armor EdgeAI 在私人網路上的連線。

03 — For Developers

讓你的 App 接上 API QR Code

QR 碼是一行 JSON,掃到之後就是一個標準的 OpenAI 相容端點。App 內的「給開發者」段落另附一份提示詞,交給 Claude Code、Codex、Cursor 這類 AI 程式助手,它會照規格在 App 裡加入掃描、連線與錯誤處理。

QR 碼內容 · 格式 v1(範例值為虛構)
{
  "t": "armor-edgeai/api",
  "v": 1,
  "name": "Armor Studio",
  "hosts": ["armor-studio.local", "192.168.1.24", "100.88.12.7"],
  "port": 2918,
  "key": "armor_sk_…"
}
hosts 依序嘗試,每個 3 秒,第一個回應的勝出
.local 名稱區網 IPv4其他位址VPN
.local 名稱在電腦換 IP 後仍然有效;VPN 位址排最後,同一個 Wi-Fi 上的裝置不必先等它逾時。
QR 碼的內容格式
欄位型別說明
t字串固定為 armor-edgeai/api
v數字格式版本,目前是 1
name字串電腦名稱,可以顯示給使用者看
hosts字串陣列依序嘗試的位址:正在廣播時第一個是 .local 名稱,其後是區網 IPv4,VPN 位址排最後
port數字通常是 2918(也可能是 2919 或 2920)
key字串armor_sk_ 開頭的 API 金鑰,每台裝置一把

一段提示詞,交給 AI 程式助手

提示詞涵蓋十一個章節:從 QR 碼驗證、金鑰的安全儲存、找到電腦、呼叫 API、串流、圖片、錯誤處理、各平台設定,到隱私與自動化測試。

提示詞不含任何金鑰或這台電腦的位址,可以放心傳給開發者。

  1. 一QR 碼的內容與驗證
  2. 二儲存連線資料
  3. 三找到電腦
  4. 四呼叫 API
  5. 五串流(可選)
  6. 六圖片(可選)
  7. 七錯誤處理
  8. 八平台設定
  9. 九隱私與安全
  10. 十測試(用假的 HTTP 伺服器)
  11. 十一完成的標準

使用前該知道的事

QR 碼就是金鑰

區網連線是未加密的 HTTP,同一個網路上的人可能讀到連線內容,只在信任的網路使用。QR 碼請勿拍照或分享;外流時在 App 裡撤銷那台裝置。

裝置不能換模型

可以先產生 QR 碼;裝置要等你載入模型後才能使用。裝置無法自己下載或載入模型。

隨時撤銷

撤銷後,用它連線的裝置就無法再使用這台電腦的模型;所有金鑰也都能在「API 配置」頁管理。

仍在測試

API QR Code 仍在測試:QR 碼的格式與畫面之後可能會調整。

Next

也想讓 AI 代理用這台電腦

AI 代理連線(MCP)讓 Claude Code、Cursor 這類工具呼叫文字辨識與語音轉寫。