推荐默认
亚太 CDN
大多数用户可先测试 `https://apis.20170428.xyz`,连通性正常后在该站注册账号。
业务文档网站
面向新手的开通与接入说明,覆盖购买、兑换、创建 API Key、线路选择、客户端配置与故障排查。
三件事先记住
推荐默认
大多数用户可先测试 `https://apis.20170428.xyz`,连通性正常后在该站注册账号。
低延迟方案
对延迟更敏感时,可优先测试 `https://api.20170428.xyz`,并在该站注册和充值。
区域选择
东南亚网络环境建议测试 `https://xjp.20170428.xyz`,确认后在该站开通。
总览
第一步
根据所在区域和连通性测试结果,在香港、亚太 CDN、新加坡中选择一个站点。
第二步
在选定站点注册账号。三个站点数据库独立,账号、余额和 API Key 不互通。
第三步
注册后查看该站公告,按公告里的链接购买卡密,再回到同一站点兑换充值。
线路选择
三个站点不是同一个数据库。在哪个站点注册,就在哪个站点购买卡密、兑换充值、创建 API Key,并使用该站点的 Base URL。
香港站点
https://api.20170428.xyz
亚太 CDN
https://apis.20170428.xyz
新加坡节点
https://xjp.20170428.xyz
开通流程
根据自己所在区域和连通性测试结果,在三个站点中选择一个作为后续使用站点。
在选定站点注册账号。三个站点数据库独立,请不要跨站使用账号或余额。
注册后查看站内公告,按公告里的链接购买卡密。
回到同一个站点,在卡密兑换或充值页面输入卡密,确认余额到账。
在 API Key 管理页面新建 Key,立即复制保存。
使用同一站点的 Base URL 和 API Key 先跑 curl,再接入客户端。
新手速配
OpenAI Base URL 填 `选定站点/v1`,例如 `https://apis.20170428.xyz/v1`。
Base URL 填选定站点根地址,例如 `https://apis.20170428.xyz`,不要加 `/v1`。
需要在新站点重新注册、充值并创建 API Key,旧站点余额不会自动迁移。
基础概念
卡密是购买后得到的激活码,只能在对应站点兑换充值。
API Key 形如 `sk-xxxx`,只能配合创建它的站点使用。
OpenAI 兼容客户端:`https://站点域名/v1`
Claude Code:`https://站点域名`
curl https://apis.20170428.xyz/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{ "role": "user", "content": "Say hello" }
]
}'
客户端接入
使用你注册并充值的站点根地址,不要加 `/v1`。下面以亚太 CDN 为例。
export ANTHROPIC_BASE_URL=https://apis.20170428.xyz
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
编辑 `~/.codex/config.toml`,`base_url` 换成你注册站点的 `/v1` 地址:
model = "gpt-5"
model_provider = "xyz20170428"
[model_providers.xyz20170428]
base_url = "https://apis.20170428.xyz/v1"
env_key = "XYZ_API_KEY"
Settings → Models → Override OpenAI Base URL。下面以亚太 CDN 为例。
Base URL: https://apis.20170428.xyz/v1
API Key: YOUR_API_KEY
服务商管理里选择 OpenAI 兼容接入。下面以亚太 CDN 为例。
名称: 20170428.xyz
Base URL: https://apis.20170428.xyz/v1
API Key: YOUR_API_KEY
环境变量中的地址要使用注册并充值所在的站点。
OPENAI_API_KEY=YOUR_API_KEY
BASE_URL=https://apis.20170428.xyz
CUSTOM_MODELS=gpt-4o,gpt-4o-mini,gpt-4-turbo
下面以亚太 CDN 为例,其他站点请替换为对应域名。
OPENAI_API_BASE_URL=https://apis.20170428.xyz/v1
OPENAI_API_KEY=YOUR_API_KEY
配置核对
SDK 调用
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://apis.20170428.xyz/v1"
)
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "Hello"}]
)
print(response.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "YOUR_API_KEY",
baseURL: "https://apis.20170428.xyz/v1"
});
const response = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [{ role: "user", content: "Hello" }]
});
故障排查
通常是 API Key 复制错误、已失效,或多了空格换行。
常见原因是余额不足、Key 权限不足、跨站使用 Key,或触发频率限制。
绝大多数是 Base URL 填错。OpenAI 兼容必须带 `/v1`,Claude Code 不能带。
模型名拼写错误,或当前站点暂不支持该模型。先从 `gpt-4o-mini` 开始测试。
先测试不同站点连通性。若决定更换站点,需要在新站点重新注册、充值并创建 API Key。
反馈支持
【基本信息】
账号:user@example.com
时间:2026-06-06 10:00
客户端:Cursor / Codex / Claude Code
系统:Windows 11 / macOS / Linux
【配置】
使用站点:亚太 CDN / 香港 / 新加坡
Base URL: https://apis.20170428.xyz/v1
API Key: sk-AbCd...(隐藏后半段)
【错误信息】
错误代码:401 / 403 / 404
完整报错:请粘贴原文
【复现步骤】
1. 打开客户端
2. 配置 Base URL 和 API Key
3. 发送测试请求
4. 出现错误
【已尝试】
- 重新复制 API Key
- 确认账号、余额、API Key 都来自同一个站点
- 测试不同站点连通性
- 用 curl 单独测试