Reflection Beam：開放權重模型、API 與程式代理

白話介紹：Reflection 這個網站有什麼用途？

Reflection 是開發人工智慧模型與相關軟體的公司，網站提供其 Beam 模型、API 平台、開發文件與模型權重的官方入口。Beam 能接收文字任務，進行推理，再產生回答或程式碼。開發者可以把它接進應用程式，也能透過 Mirror 終端代理讓它閱讀專案、修改檔案和執行測試。

理解產品時，可以分成模型、服務和工具三層：Beam 提供推理能力，Reflection API 讓程式呼叫模型，Mirror CLI 則把這些能力連到實際開發工作。自行部署權重是另一條路徑，適合具備模型服務與基礎設施維運能力的團隊。

如何選擇 API、Mirror 或自行部署？

想先驗證提示詞與輸出，可以使用平台 Playground；需要整合自己的產品，選 API；要處理現有程式庫的小型開發任務，可從 Mirror 開始。若需要自己管理推理環境，再評估權重部署。

Beam 是總參數約 5010 億、每個 token 啟用約 230 億參數的稀疏混合專家模型，支援約 100 萬 token 的模型上下文。輸入與輸出都是文字。API 另支援串流、工具呼叫與 JSON Schema 結構化輸出，讓程式較容易串接後續處理。模型主要以英文開發，繁體中文及專業領域任務應另做實測。

第一次串接 Reflection API

按照API 快速入門登入平台，在 API Keys 建立密鑰；完整密鑰只顯示一次，應安全保存為 REFLECTION_API_KEY。

1. 將客戶端基礎網址設為 https://api.reflection.ai/openai/v1。
2. 選擇 Beam-1.0-501B-A23B，透過 Chat Completions 送出文字指令。
3. 從 choices[0].message.content 取得回答，先確認最小請求能成功。
4. 再加入工具、對話歷程或結構化結果，檢查輸出及使用量。

工具呼叫所要求的函式由應用程式執行，再將結果傳回模型。推理強度可以調整，但 Beam 持續保有推理流程；輸入、推理與答案都要納入 token 預算。相容性文件的範圍是 Chat Completions 與 Models，不能直接推定其他 OpenAI 介面也支援。

用 Mirror 處理一個可驗證的程式任務

先準備 uv，再以 uv tool install reflection-mirror 安裝 Mirror，設定 Reflection 密鑰，在專案資料夾啟動 mirror。可先要求它執行測試、找出一個失敗原因、完成修正並重新測試。

依預設流程審查工具動作，完成後檢視 git diff，自己再次執行專案測試。這能確認修改內容與實際效果，而不是只依賴代理的完成訊息。

官方設定指南列出 macOS 15 以上 Apple Silicon，以及 glibc 2.28 以上的 Linux x86-64／ARM64；Mirror 尚未原生支援 Windows。Pi、OpenCode 和 Hermes 也有 Beam 串接說明。

權重、授權與硬體規劃

Beam 權重已於 2026 年 10 月 16 日釋出，採用 Apache 2.0 授權，提供 BF16、FP8 與 NVFP4 格式。官方下載指南的參考部署使用四張以 NVLink 連接的 NVIDIA B300 SXM GPU、Linux amd64、Docker 與 NVIDIA Container Toolkit，並搭配 DFlash2 草稿模型。

這是參考配置，各種量化方式不必然具有相同最低需求。依指南啟動 SGLang、vLLM 或 TokenSpeed 後，可使用 Beam Verifier 檢查端點。客製化文件列有 LoRA、監督式微調和強化學習訓練框架，但各框架的詳細配方仍在後續提供的規劃中。

免費範圍與資料使用條件

截至 2026 年 10 月 20 日，官方說明 API 公測可免費開始使用，未找到統一公開的官方 token 單價。實際額度與費用請查看帳戶帳單；第三方代管平台另有自己的價格。自行部署也需要負擔硬體、儲存與維運成本。

API 的請求、token 與並行限制按組織共用，推理 token 亦會計入。日額度在 UTC 00:00 重設，遇到 429 應遵循限流文件。

隱私政策指出，託管服務會收集輸入與輸出，並可能依使用者選擇用於模型改進；企業內容則由客戶協議規範。提交內部程式碼或個人資料前，請核對實際適用條款。

常見問題

Beam 可以免費使用嗎？

權重可依 Apache 2.0 取得，官方 API 公測可免費起步，但不等於永久無限使用。GPU、其他託管平台及帳戶後續條件需要分別確認。

可以用於商業產品嗎？

Apache 2.0 允許符合授權條件的商業使用。採用 API 時，還需遵守所選服務的條款；模型權重開放也不代表訓練資料全部公開。

能直接處理圖片與音訊嗎？

目前是文字模型。其他格式需先透過合適的外部流程轉成文字，不能視為原生多模態輸入。

一般電腦可以自行執行嗎？

受支援的電腦可以執行 Mirror 並連接遠端模型。完整權重的運行需要另外評估記憶體、GPU 和推理引擎，兩者的硬體要求不同。

官方資源與開發者社群

• 開發文件：API、模型部署與客製化。
• Mirror 原始碼與問題回報。
• 官方 Discord 社群：交流接入問題。
• Reflection 官方 X：追蹤公告。
• 企業合作聯絡表單。