OPENAI_COMPATIBLE

OpenAI 相容接入

任何支援 OpenAI 相容 API 的客戶端或 SDK，都可以用下面的 Base URL 和 API Key 接入 BRUCEAI，支援 /v1/models、/v1/chat/completions 與 /v1/responses。

如果客戶端要求模型名稱，用 OpenAI Key 可先填兼顧能力與成本的 gpt-5.6-terra；也可依需求選擇 GPT-6.1 Sol、GPT-6 Astra / Sol / Luna、GPT-5.6 Sol / Luna 或 GPT-5.5。用 Grok Key 填 grok-4.7 / grok-4.6 / grok-4.5，用 DeepSeek Key 填 deepseek-v4.1-flash。後端會依實際模型與上下文級距計費。

模型 ID

可以把這些模型 ID 複製到 config.toml、API request body，或任何需要填模型名稱的 OpenAI 相容客戶端。每一組模型都要用對應類型的 Key 才能呼叫。

GPT需使用 OpenAI Key

Grok需使用 Grok Key

DeepSeek需使用 DeepSeek Key

BEFORE YOU START

先準備 API 金鑰

1. 前往 API Key 頁面

登入後到 API Key 頁面建立或複製 API Key。金鑰格式像 sk-or-v1-xxxxxxxxxxxx，請把它當密碼保管。

建立 API Key

3. 確認 Base URL

https://api.bruceai.net/v1

OpenAI 相容客戶端通常需要填帶 /v1 的 Base URL。

2. 依要用的模型建立對應的 Key

點「新增 API Key」，填一個你認得出來的名稱，再依照要呼叫的模型選擇 Key 的類型：

OpenAI Key: 可呼叫 gpt-6.1-sol、gpt-6-astra、gpt-6-sol、gpt-6-luna、gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna 與 gpt-5.5。支援 Codex、GitHub Copilot 與任何 OpenAI 相容客戶端。
Grok Key: 可呼叫 grok-4.7、grok-4.6 與 grok-4.5。支援 Grok Build、Codex 與任何 OpenAI 相容客戶端。
DeepSeek Key: 可呼叫 deepseek-v4.1-flash：1M 上下文，支援思考模式、工具呼叫與圖片輸入。支援 Codex 與任何 OpenAI 相容客戶端。

一把 Key 只能呼叫自己這家供應商的模型：用 Grok Key 送 GPT 模型 ID，或用 OpenAI Key 送 grok-4.6，都會直接收到 400。要用多家模型就分別建立幾把 Key。

不要把 API 金鑰發給別人，也不要提交到 GitHub、GitLab 或任何公開倉庫。

先選擇你的系統

下方所有指令會依照你選擇的系統切換。

STEP 01

健康檢查

macOS / Linux

bash

curl https://api.bruceai.net/health

STEP 02

列出這把 Key 可用的模型

回傳的清單就是這把 Key 能呼叫的模型 ID：OpenAI Key 會列 GPT 系列，Grok Key 只列 grok-4.7、grok-4.6 與 grok-4.5，DeepSeek Key 只列 deepseek-v4.1-flash。

macOS / Linux

bash

curl https://api.bruceai.net/v1/models \
  -H "Authorization: Bearer sk-or-v1-你的金鑰"

STEP 03

Chat Completions 串流範例

macOS / Linux

bash

curl -N https://api.bruceai.net/v1/chat/completions \
  -H "Authorization: Bearer sk-or-v1-你的金鑰" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-terra","messages":[{"role":"user","content":"hi"}],"stream":true}'

STEP 04

OpenAI SDK 範例

官方 openai 套件直接改 base_url 就能用。Grok 或 DeepSeek 只要換 Key 與 model。

Python

python

from openai import OpenAI

client = OpenAI(
    api_key="sk-or-v1-你的金鑰",
    base_url="https://api.bruceai.net/v1",
)

response = client.chat.completions.create(
    model="gpt-5.6-terra",
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

Node.js

typescript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-or-v1-你的金鑰",
  baseURL: "https://api.bruceai.net/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-5.6-terra",
  messages: [{ role: "user", content: "你好" }],
});
console.log(response.choices[0].message.content);

STEP 05

常見問題

401 / invalid token：確認金鑰完整、沒有多餘空白，格式是 sk-or-v1-...

400 / unsupported_model：模型 ID 不屬於這把 Key 的供應商，或拼法不對（要用小寫的 gpt-5.6-terra、grok-4.6、deepseek-v4.1-flash）。

404：確認 Base URL 結尾是 /v1，端點是 /chat/completions、/responses 或 /models。

400 / conversation too large：對話太長，請在客戶端壓縮對話（例如 Codex 的 /compact），或開啟新對話。