开始使用 ↗

QUICK START

几行配置,接入模型。

快速开始

注册登录后在线充值,支付确认后在控制台点击生成 API Key。每位用户只有一个有效密钥,后续充值自动到账。吊销旧 Key 不会清空余额,余额大于零时可以自助生成新的 Key。不要把 Key 写入公开代码仓库或前端网页。

API BASE URLhttps://key.zhuan.xyz/v1

OpenAI 兼容接口

可用于 Chat Completions、Responses 及服务支持的其他 OpenAI 协议接口。使用模型价格页面列出的准确 Model ID。

from openai import OpenAI

client = OpenAI(
    api_key="sk-zhuan-your-key",
    base_url="https://key.zhuan.xyz/v1"
)
response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Hello"}],
    stream=True
)
for chunk in response:
    print(chunk.choices[0].delta.content or "", end="")
curl https://key.zhuan.xyz/v1/models \
  -H "Authorization: Bearer sk-zhuan-your-key"

也可使用 https://key.zhuan.xyz/openai/v1。具体模型可用性与技术限制请以平台公告和接口实际响应为准。

Anthropic 兼容接口

import anthropic

client = anthropic.Anthropic(
    api_key="sk-zhuan-your-key",
    base_url="https://key.zhuan.xyz/proxy"
)
message = client.messages.create(
    model="claude-sonnet-4-6", max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}]
)
部分 Claude 路由的系统提示和并发能力受服务限制。接入依赖严格系统提示的业务前,请先验证实际模型行为。

密钥与额度

账户只显示一个可用余额。充值确认后,已有密钥自动增加额度;尚未生成密钥时,用户可在余额大于零后自助生成。管理员可直接增加或减少用户额度。密钥定价比例创建后锁定。暂停密钥会立即阻止通过本网关的新请求。

API Key 仅用于模型调用,不能访问管理 API。每位用户会附带稳定的匿名终端用户标识,便于隔离风控。额度和调用消费通过平台管理 API 同步,短暂延迟不代表免费调用。

常见错误

状态处理建议
401确认使用本站创建的 Key,检查 Authorization / x-api-key。
402余额不足,请充值后重试;尚未生成密钥时请先在控制台生成。
403账户、密钥或模型可能受到限制,请联系支持并提供请求 ID。
429请求速率或并发超限,请按 retry-after 等待并退避重试。
502 / 503服务或网络暂不可用;涉及额度的操作请先查看核对状态,避免重复提交。