由建立帳戶同 API Key 開始，用 curl 發出第一個請求，再用 OpenAI / Anthropic SDK 同 Claude Code 接入 PingAI，最後喺 Console 睇用量。
PingAI 係香港 AI API 網關，用一個 OpenAI / Anthropic 兼容端點接入 Claude 全系列模型，唔使逐個上游簽約、唔使記住唔同 SDK。核心設計係透傳型路由：唔改你嘅請求體，將上游當黑盒，只對兩個指標負責——穩定（多上游容災 + 熔斷 + 順位降級）同便宜（路由打分 + 加權輪詢攤分成本）。
對開發者嚟講，你只需要：
pk- 開頭嘅 API Key（喺 Console 建立）https://api.pingai.hk/v1，Anthropic 兼容填 https://api.pingai.hkclaude-sonnet-5下面幾節帶你由零到一完成第一次調用。
開始前需要：
訂閱套餐有唔同檔位，包含每月 credits 配額；按量模式就係充值入餘額，用幾多扣幾多。揀邊個模式視乎你嘅使用量——詳情以定價頁為準。
喺 Console → Keys 頁建立：
pk-xxxxx 格式嘅完整 key——之後唔會再顯示，即刻複製保存Key 嘅計費模式可以揀「訂閱配額」（計落套餐 credits）或者「按量」（扣充值餘額），亦可以設預算上限。
安全提示：
PingAI 提供 OpenAI 兼容端點 /v1/chat/completions，支援 Authorization: Bearer pk-xxx。將 $PINGAI_API_KEY 換成你嘅 key：
curl https://api.pingai.hk/v1/chat/completions \
-H "Authorization: Bearer $PINGAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"用一句話介紹香港"}]}'
Windows PowerShell：
curl.exe https://api.pingai.hk/v1/chat/completions `
-H "Authorization: Bearer $env:PINGAI_API_KEY" `
-H "Content-Type: application/json" `
-d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"用一句話介紹香港"}]}'
返回 JSON 入面 choices[0].message.content 就係模型回覆，usage 顯示 prompt / completion tokens。
因為端點同 OpenAI 相容，直接用官方 openai SDK，只需要改 base_url 同 api_key：
pip install openai
from openai import OpenAI
client = OpenAI(
base_url="https://api.pingai.hk/v1",
api_key="pk-xxx",
)
response = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "用一句話介紹香港"}],
)
print(response.choices[0].message.content)
建議把 key 放環境變數：
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.pingai.hk/v1",
api_key=os.getenv("PINGAI_API_KEY"),
)
Node.js 用官方 openai npm 套件，同樣係改 baseURL 同 apiKey：
npm install openai
import OpenAI from 'openai'
const client = new OpenAI({
baseURL: 'https://api.pingai.hk/v1',
apiKey: process.env.PINGAI_API_KEY,
})
const response = await client.chat.completions.create({
model: 'claude-sonnet-5',
messages: [{ role: 'user', content: '用一句話介紹香港' }],
})
console.log(response.choices[0].message.content)
如果你已經用緊任何 OpenAI 兼容嘅 SDK 或框架，只需換 base URL 同 key，唔使改業務邏輯。
需要 Anthropic 原生協議（例如接 Claude Code、Anthropic SDK）時，用 /v1/messages 端點，base_url 填裸域名，憑證用 x-api-key（或 Authorization: Bearer）：
curl https://api.pingai.hk/v1/messages \
-H "x-api-key: $PINGAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-5","max_tokens":1024,"messages":[{"role":"user","content":"用一句話介紹香港"}]}'
Python 用官方 anthropic SDK：
pip install anthropic
from anthropic import Anthropic
client = Anthropic(
base_url="https://api.pingai.hk",
api_key="pk-xxx",
)
response = client.messages.create(
model="claude-sonnet-5",
max_tokens=1024,
messages=[{"role": "user", "content": "用一句話介紹香港"}],
)
print(response.content[0].text)
Claude Code 支援用環境變數指向第三方網關，將佢指去 PingAI 即可用 pk- key 登入，唔需要 Claude 官方訂閱。
方式一：喺 ~/.claude/settings.json 寫入 env 區塊（全域生效）：
{
"env": {
"ANTHROPIC_API_KEY": "pk-xxx",
"ANTHROPIC_BASE_URL": "https://api.pingai.hk"
}
}
方式二：shell 匯出（僅當前終端）：
export ANTHROPIC_API_KEY=pk-xxx
export ANTHROPIC_BASE_URL=https://api.pingai.hk
PowerShell：
$env:ANTHROPIC_API_KEY = "pk-xxx"
$env:ANTHROPIC_BASE_URL = "https://api.pingai.hk"
設定後喺專案目錄執行 claude，打 /status 睇到指向 PingAI 嘅 base URL 同 Auth token 即代表成功。
唔想手動寫配置？PingAI 官方 CLI 提供全程配置向導：
# 唔使安裝，直接執行
npx pingai wizard
或者全局安裝：
npm install -g pingai-cli
pingai wizard
向導流程：
其他命令：pingai doctor 檢查電腦配置、pingai configure 重新設定、pingai status 查看當前配置、pingai uninstall 卸載。
接入成功之後，可以喺 Console 睇返實際用量：
定期睇用量，係控制成本嘅第一步（詳見「用量管理與成本優化」課程）。
pk- key 有冇抄漏，或喺 Console 重建claude-sonnet-5）api.pingai.hk——檢查網域同網絡POST 同正確嘅 Content-Typemax_tokens 太細：回覆會被截斷，加大上限排錯第一步永遠係用 curl 直接打端點，睇原始回應——可以快速分清楚係 key 問題、模型問題定係網絡問題。