AI 對話模型價格文檔指南
MaCloud AI/文檔
OpenAI · Anthropic · Gemini

接入文檔

接口和官方的一樣。已經能跑的代碼和工具,只要換 base URL 和 API Key。

更新於 2026-11-01

§01

三步開始

  1. 用郵箱或 Google 賬號註冊。 免費註冊
  2. 在控制台充值,然後建一個 API Key。
  3. 把程序里的 base URL 換成我們的地址,填上 API Key,model 填模型頁上的名字。 看模型
§02

地址和鑒權

OpenAI 格式(大多數工具和 SDK)用帶 /v1 的地址:

https://api.macloudai.com/v1

Anthropic 格式(Anthropic SDK、Claude Code)用不帶 /v1 的地址:

https://api.macloudai.com

API 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)
支持 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

  1. 打開 Settings → Models。
  2. 在 OpenAI API Key 填你的 Key,打開 Override OpenAI Base URL,填 https://api.macloudai.com/v1。
  3. 點 + Add model,填模型頁上的模型名,然後點 Verify。
§07

Cherry Studio

  1. 設置 → 模型服務 → 添加,類型選 OpenAI(Claude 模型也可以選 Anthropic)。
  2. API Host 填 https://api.macloudai.com,API Key 填你的 Key。
  3. 點“管理”或“添加”,填模型頁上的模型名。
§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 數從餘額扣,價格見模型頁。餘額用完後請求會被拒絕,充值後馬上恢復。

狀態碼意思
401API Key 不對、被停用或被刪了。
403餘額不夠,或者這個 Key 不能用這個模型。
404模型名寫錯了,照模型頁上的名字填。
429請求太快了,等一下再試。
5xx上游模型暫時出錯,過一會兒重試。