§02
地址和鑒權
OpenAI 格式(大多數工具和 SDK)用帶 /v1 的地址:
https://api.macloudai.com/v1Anthropic 格式(Anthropic SDK、Claude Code)用不帶 /v1 的地址:
https://api.macloudai.comAPI Key 放在請求頭 Authorization: Bearer sk-...(Anthropic 格式也可以用 x-api-key)。Key 等於你的餘額,不要放進網頁前端代碼或公開的倉庫。
§03
OpenAI SDK
from openai import OpenAI
client = OpenAI(base_url="https://api.macloudai.com/v1", api_key="sk-...")
r = client.chat.completions.create(
model="gem-3.8-flash",
messages=[{"role": "user", "content": "Halo"}],
)
print(r.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.macloudai.com/v1", apiKey: process.env.API_KEY });
const r = await client.chat.completions.create({
model: "gem-3.8-flash",
messages: [{ role: "user", content: "Halo" }],
});
console.log(r.choices[0].message.content);
curl https://api.macloudai.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gem-3.8-flash", "messages": [{"role": "user", "content": "Halo"}], "stream": true}'
支持 stream(流式輸出)。
§04
Anthropic SDK
import anthropic
client = anthropic.Anthropic(base_url="https://api.macloudai.com", api_key="sk-...")
r = client.messages.create(
model="hk-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Halo"}],
)
print(r.content[0].text)
Anthropic 格式的地址不帶 /v1。
§05
Claude Code
在終端里設好這幾個環境變量再運行 claude(想一直生效就寫進 ~/.zshrc 或 ~/.bashrc):
export ANTHROPIC_BASE_URL=https://api.macloudai.com
export ANTHROPIC_AUTH_TOKEN=sk-...
export ANTHROPIC_MODEL=hk-5-5
claude
§06
Cursor
- 打開 Settings → Models。
- 在 OpenAI API Key 填你的 Key,打開 Override OpenAI Base URL,填 https://api.macloudai.com/v1。
- 點 + Add model,填模型頁上的模型名,然後點 Verify。
§07
Cherry Studio
- 設置 → 模型服務 → 添加,類型選 OpenAI(Claude 模型也可以選 Anthropic)。
- API Host 填 https://api.macloudai.com,API Key 填你的 Key。
- 點“管理”或“添加”,填模型頁上的模型名。
§08
LobeChat
在設置 → 語言模型 → OpenAI 里填 API Key 和 API 代理地址 https://api.macloudai.com/v1。自己部署的話設環境變量:
OPENAI_API_KEY=sk-...
OPENAI_PROXY_URL=https://api.macloudai.com/v1
§09
計費和報錯
每次調用按輸入和輸出的 token 數從餘額扣,價格見模型頁。餘額用完後請求會被拒絕,充值後馬上恢復。
| 狀態碼 | 意思 |
|---|---|
| 401 | API Key 不對、被停用或被刪了。 |
| 403 | 餘額不夠,或者這個 Key 不能用這個模型。 |
| 404 | 模型名寫錯了,照模型頁上的名字填。 |
| 429 | 請求太快了,等一下再試。 |
| 5xx | 上游模型暫時出錯,過一會兒重試。 |