API 文档

把官方 SDK 的 base_url 换成 https://api.koozhan.com 即可，5 分钟完成接入。

1Quickstart · 三步接入

第一步：注册账号

访问 https://koozhan.com/register 用邮箱注册账号。注册成功立即可用，新账号免费赠送体验额度。

第二步：创建 API Key

登录后在控制台 → 令牌页 → 点 添加新令牌，给令牌起个名字（用于识别用途，比如 my-app-prod），保存后会得到一串以 sk- 开头的 API Key。

提示：API Key 只显示一次，记得立即复制保存。如丢失只能删掉重建。每个账号可建多个 Token，按项目隔离方便对账。

第三步：替换 base_url

把官方 SDK 的 base_url 改成我们的：

Python (OpenAI)
Python (Anthropic)
from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxx",                        # 你的 API Key
    base_url="https://api.koozhan.com/v1",      # 替换这里
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",                  # 模型名照原样填
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
import anthropic

client = anthropic.Anthropic(
    api_key="sk-xxxxxxx",
    base_url="https://api.koozhan.com",         # 注意：Anthropic 协议不带 /v1
)

msg = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)

两套兼容协议

协议base_url路径用途
OpenAI 兼容https://api.koozhan.com/v1/v1/chat/completions所有模型（推荐）
Anthropic 原生https://api.koozhan.com/v1/messagesClaude 模型 / Claude Code CLI

两个协议指向同一个网关，用哪个看你的 SDK 习惯——OpenAI SDK 走 OpenAI 兼容，Anthropic SDK 走原生协议。模型名都是同一套（如 claude-sonnet-4-6、gpt-5、gemini-2.5-pro）。

2OpenAI 兼容协议

所有模型都能通过 OpenAI 兼容协议调用——无论是 GPT、Claude、Gemini、DeepSeek 还是国产模型。完全兼容 openai SDK，零代码改动。

Endpoint

POST https://api.koozhan.com/v1/chat/completions

请求示例

cURL
Python
Node.js
流式 (Stream)
curl https://api.koozhan.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxx" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
      {"role": "system", "content": "你是一位专业的助手"},
      {"role": "user", "content": "用一句话介绍黑洞"}
    ],
    "max_tokens": 200,
    "temperature": 0.7
  }'
from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxx",
    base_url="https://api.koozhan.com/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[
        {"role": "system", "content": "你是一位专业的助手"},
        {"role": "user", "content": "用一句话介绍黑洞"},
    ],
    max_tokens=200,
    temperature=0.7,
)
print(resp.choices[0].message.content)
print(f"用量: input={resp.usage.prompt_tokens}, output={resp.usage.completion_tokens}")
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-xxxxxxx",
  baseURL: "https://api.koozhan.com/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-5",
  messages: [
    { role: "system", content: "你是一位专业的助手" },
    { role: "user", content: "用一句话介绍黑洞" },
  ],
  max_tokens: 200,
});

console.log(resp.choices[0].message.content);
# 流式输出（一边生成一边返回，体验更好）
from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxx",
    base_url="https://api.koozhan.com/v1",
)

stream = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "写一首关于光年的诗"}],
    stream=True,
    stream_options={"include_usage": True},   # 末帧带 token 用量
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

支持参数

参数类型说明
modelstring模型名（必填）
messagesarray对话历史（必填，含 system/user/assistant role）
max_tokensint最大输出长度
temperaturefloat0-2，越大越发散
top_pfloat0-1，nucleus 采样
streambool启用 SSE 流式
toolsarrayfunction calling 工具定义
response_formatobjectJSON mode：{"type":"json_object"}

3Anthropic 原生协议

如果你的代码已经在用官方 anthropic SDK，**只需改一行 base_url** 就能切到酷站AI。同时支持原生 messages API、prompt caching（部分通道）、tool use 等所有官方特性。

Endpoint

POST https://api.koozhan.com/v1/messages

注意：Anthropic 协议的 base_url 不带 /v1，SDK 内部会自动拼接。如果带了 /v1 反而会请求到 /v1/v1/messages → 404。

请求示例

cURL
Python
流式 (Stream)
curl https://api.koozhan.com/v1/messages \
  -H "x-api-key: sk-xxxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 200,
    "system": "你是一位专业的助手",
    "messages": [
      {"role": "user", "content": "用一句话介绍黑洞"}
    ]
  }'
import anthropic

client = anthropic.Anthropic(
    api_key="sk-xxxxxxx",
    base_url="https://api.koozhan.com",
)

msg = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=200,
    system="你是一位专业的助手",
    messages=[
        {"role": "user", "content": "用一句话介绍黑洞"},
    ],
)

print(msg.content[0].text)
print(f"用量: input={msg.usage.input_tokens}, output={msg.usage.output_tokens}")
# 流式输出
import anthropic

client = anthropic.Anthropic(
    api_key="sk-xxxxxxx",
    base_url="https://api.koozhan.com",
)

with client.messages.stream(
    model="claude-sonnet-4-6",
    max_tokens=512,
    messages=[{"role": "user", "content": "写一首关于光年的诗"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

支持的字段

所有官方 Anthropic Messages API 字段都透传支持：model、messages、system、max_tokens、temperature、top_p、top_k、stop_sequences、stream、tools、tool_choice 等。完整字段参考 Anthropic 官方文档。

4Claude Code CLI 配置

Anthropic 官方的 Claude Code 命令行工具（claude 命令）—— 把它指向酷站AI 就能用我们提供的 Claude 模型，不用买 Anthropic 官方 API。

安装 Claude Code（如果还没装）

Install
npm install -g @anthropic-ai/claude-code

配置环境变量

设两个环境变量即可。推荐写到 ~/.zshrc 或 ~/.bashrc 里，永久生效：

bash / zsh (Mac/Linux)
fish
PowerShell (Windows)
# 一次性临时启用（当前 shell 有效）
export ANTHROPIC_BASE_URL="https://api.koozhan.com"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxx"

# 永久生效：追加到 ~/.zshrc 或 ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://api.koozhan.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxx"' >> ~/.zshrc
source ~/.zshrc

# 启动
claude
set -Ux ANTHROPIC_BASE_URL "https://api.koozhan.com"
set -Ux ANTHROPIC_AUTH_TOKEN "sk-xxxxxxx"

claude
# 当前 PowerShell 临时
$env:ANTHROPIC_BASE_URL = "https://api.koozhan.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxxxxxx"
claude

# 永久生效
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.koozhan.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxxxxx", "User")

验证

启动 claude 后，命令行会进入交互模式。问一句话比如"hi"，能正常返回 = 配置成功。

常见问题：
  • 提示 API key not found：检查环境变量名是否准确（必须是 ANTHROPIC_AUTH_TOKEN，不是 API_KEY）
  • 提示 Invalid token：在 koozhan 后台确认 Token 还在生效，余额充足
  • 提示 无可用渠道：你的 Token 所在分组没有 Claude 渠道，联系管理员
  • 响应慢/卡：上游路由偶尔抖动，正常重试 1-2 次

查看用量

在 koozhan 控制台 → 日志页可以看到每次 claude 调用的具体 token 用量与费用明细，按时间倒序排列。