一. 什么是 One API ?

One API 是 OpenAI 接口管理和分發系統，通過標準 HTTP 格式統一封裝 智譜 ChatGLM、百度文心、訊飛星火、阿里通義、騰訊混元 等國內大模型。
一句話：換域名、換 Key，代碼零改動就能切模型！??

二. 前置準備：搭建基礎環境 ??

1. 環境軟件配置

• 系統：Linux / macOS / Windows 均可 ?
• 硬件：CPU 單核可跑，有 GPU/NPU/MPS 直接起飛 ??
  

  如果你對「CPU vs GPU 推理差異」想秒懂，把問題丟給 代碼示例講解概念 ，讓它生成對比代碼并畫圖，10 s 出答案！

2. 關鍵工具安裝

# 以 Langchain-Chatchat ≥0.3.0 為例
pip install langchain-chatchat -U -i https://pypi.org/simple

網速慢？清華源 https://pypi.tuna.tsinghua.edu.cn/simple 備用 ??

三. 核心步驟：one-api 接入全流程 ???

1. 獲取可執行文件

源碼黨繼續走：

cd one-api/web/default && npm i && npm run build
cd ../.. && go mod download && go build -ldflags "-s -w" -o one-api

編譯腳本想再提速？把上面指令粘進 代碼優化助手 ，自動給你并行編譯、UPX 壓縮，體積砍一半 ?

2. 運行服務

chmod u+x one-api
./one-api --port 3000 --log-dir ./logs

瀏覽器訪問 http://localhost:3000 ，初始賬號 root / 123456 ??

3. 創建渠道

控制臺 → 渠道 → 新建

• 名稱： iFLYTEK-Xinghuo
• 類型： 訊飛星火
• 模型： 訊飛星火 2.0
• 密鑰： <你的 API Key>
  保存后列表實時刷新 ?

4. 申請令牌

控制臺 → 令牌 → 添加

• 名稱： Test-Project-Token
• 過期： 短期測試選 7 天，生產可永不過期 ??
• IP 白名單： 本地開發填 127.0.0.1
  點擊生成，務必復制，后續 HTTP 請求全靠它！

四. 項目配置：讓 one-api 適配你的需求 ??

1. 初始化數據目錄

export CHATCHAT_ROOT=/path/to/chatchat_data   # Linux/mac
set CHATCHAT_ROOT=/path/to/chatchat_data      # Windows
chatchat init                                   # 自動創建 yaml、知識庫、日志目錄

2. 修改配置文件

• model_settings.yaml → 設置 DEFAULT_LLM_MODEL=oneapi 并填入 api_key
• basic_settings.yaml → 改 KB_ROOT_PATH 遷移知識庫
• kb_settings.yaml → 換向量庫為 Milvus 時改 DEFAULT_VS_TYPE
  

  配置項太多怕遺漏？把整個 yaml 拖進 智能代碼審查助手 ，一鍵掃出冗余鍵、缺失字段，并給出最佳實踐 ??

五. 實戰演練：Python 發起 HTTP 調用 ??

import requests, json

url = "http://localhost:3000/v1/chat/completions"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_TOKEN"      # ← 替換為剛才生成的令牌
}
data = {
    "model": "your_model_name",
    "messages": [{"role": "user", "content": "你好，今天天氣如何？"}]
}

resp = requests.post(url, headers=headers, json=data)
if resp.status_code == 200:
    print(resp.json()["choices"][0]["message"]["content"])
else:
    print("? 狀態碼：", resp.status_code)

想自動生成 Java/Go/PHP 多語言版本？把參數喂給 API交互代碼生成 ??，5 種語言秒出，直接復制進項目！

六. 收尾工作：啟動與測試 ?

chatchat start -a

默認交互地址 http://127.0.0.1:8501
輸入： “請介紹一下人工智能的發展歷程”
若回答流暢 → ?? 部署成功！
若報錯 → 先看 logs/ 目錄，再讓 代碼片段解析助手 幫你逐行解析堆棧，快速定位 ??

祝你 HTTP 調用 One API 一路綠燈，玩轉自研大模型 ??