// Quick Start

使用文件

通過環境變數配置 API 地址和密鑰，無需改動程式碼即可接入 PioModel。

01API 端點

Anthropic SDK（Claude Code 等）
https://api.piomodel.com
OpenAI SDK / HTTP
https://api.piomodel.com/v1
KEY
喺控制台「API Key 管理」建立密鑰，格式為 sk-your-api-key。請求時作為 Authorization: Bearer sk-... 傳入。

02環境變量設置

Windows 配置

僅當前終端視窗有效，關閉後失效。適合臨時測試。

# PowerShell (valid for current session only)
$env:ANTHROPIC_BASE_URL = "https://api.piomodel.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-api-key"

macOS / Linux 配置

僅當前終端視窗有效，關閉後失效。適合臨時測試。

# bash / zsh (valid for current session only)
export ANTHROPIC_BASE_URL="https://api.piomodel.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"

03工具接入

主流 AI 編程工具都能直連 PioModel，設定好環境變數或下面嘅配置即可。

Claude Code CLI

Anthropic 官方命令列工具，透過環境變數連線 PioModel，無需改動程式碼。

前往「API Key 管理」頁面一鍵下載配置腳本 → 
# bash / zsh (valid for current session only)
export ANTHROPIC_BASE_URL="https://api.piomodel.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"

設定完成後啟動：

claude

Codex CLI

OpenAI 官方 Codex 命令列工具，走 /v1/responses 介面。注意 base_url 必須包含 /v1。

編輯 ~/.codex/config.toml：

model_provider = "piomodel"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.piomodel]
name = "piomodel"
base_url = "https://api.piomodel.com/v1"
wire_api = "responses"
env_key = "PIOMODEL_API_KEY"

然後將 API Key 設置到環境變數：

# bash / zsh
export PIOMODEL_API_KEY="sk-your-api-key"

設定完成後啟動：

codex

Cursor / Windsurf

喺設定入面覆蓋 OpenAI 介面位址與密鑰即可。

{
  "openai.baseUrl": "https://api.piomodel.com/v1",
  "openai.apiKey": "sk-your-api-key"
}

Cline（VS Code）

喺 Cline 入面選擇 OpenAI Compatible 提供方，填入位址、密鑰與模型名。

Provider   : OpenAI Compatible
Base URL   : https://api.piomodel.com/v1
API Key    : sk-your-api-key
Model      : claude-sonnet-4-5-20250929

04調用示例

from anthropic import Anthropic

# Automatically reads ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN from env
client = Anthropic()

message = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content[0].text)

安裝： pip install anthropic / openai · npm install openai

05串流回應

請求體加入 stream: true 即可啟用 SSE 串流輸出，適合聊天介面即時渲染。

from anthropic import Anthropic

client = Anthropic()

with client.messages.stream(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Write a haiku about Go."}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

06格式自動轉換

PioModel 喺閘道側做 Anthropic Messages ↔ OpenAI Chat 雙向透明轉換。呢意味住：同一個模型，你既可以用 Anthropic 風格調用，亦可以用 OpenAI 風格調用——一套代碼，任意模型。

兩種風格嘅主要欄位對應關係：

Anthropic 風格OpenAI 風格說明
systemmessages[role=system]系統提示位置不同，閘道自動搬運
max_tokens（必填）max_tokens（可选）缺省時閘道按模型上限處理
content 分块数组content 字符串文字／圖像區塊與字串互轉
stop_reasonfinish_reason結束原因欄位名對應
TIP
已有 OpenAI 代碼想調用 Claude？只需改 base_url 與 model 兩處即可，訊息結構毋須改動。

07多模態

圖像生成使用同一閘道與密鑰，按量計費。

img = client.images.generate(
    model="gpt-image-2",
    prompt="夜幕下的城市天际线，电影感",
    size="1024x1024",
)
print(img.data[0].url)

08函式呼叫

用 OpenAI 風格嘅 tools 定義可呼叫函式，模型會喺需要時回傳 tool_calls，由你嘅代碼執行後回填結果。

tools = [{
  "type": "function",
  "function": {
    "name": "get_weather",
    "description": "查询某城市天气",
    "parameters": {
      "type": "object",
      "properties": {"city": {"type": "string"}},
      "required": ["city"],
    },
  },
}]

resp = client.chat.completions.create(
    model="claude-sonnet-4-5-20250929",
    messages=[{"role": "user", "content": "上海今天天气怎么样？"}],
    tools=tools,
)
print(resp.choices[0].message.tool_calls)

09錯誤處理

/v1/* 路徑遵循 OpenAI 錯誤格式，錯誤 JSON 包含 type / code / message。

{
  "error": {
    "type": "invalid_request_error",
    "code": "insufficient_quota",
    "message": "余额不足"
  }
}

常見錯誤碼

HTTP說明
401API Key 無效或未提供
402餘額不足，請前往充值
429觸發限流或每日配額耗盡
503上游渠道全部不可用（熔斷中）
查看全部模型與價格 →