业务文档网站

20170428.xyz API 接入中心

面向新手的开通与接入说明,覆盖购买、兑换、创建 API Key、线路选择、客户端配置与故障排查。

三件事先记住

  • 三个站点数据库独立,账号、余额和 API Key 不互通。
  • 卡密用于充值,API Key 用于调用。
  • OpenAI 兼容客户端 Base URL 必须带 `/v1`。
  • Claude Code 使用根地址,不要加 `/v1`。

推荐默认

亚太 CDN

大多数用户可先测试 `https://apis.20170428.xyz`,连通性正常后在该站注册账号。

低延迟方案

香港直连

对延迟更敏感时,可优先测试 `https://api.20170428.xyz`,并在该站注册和充值。

区域选择

新加坡节点

东南亚网络环境建议测试 `https://xjp.20170428.xyz`,确认后在该站开通。

总览

三个站点独立开通,先选站再注册

第一步

选择站点

根据所在区域和连通性测试结果,在香港、亚太 CDN、新加坡中选择一个站点。

第二步

注册账号

在选定站点注册账号。三个站点数据库独立,账号、余额和 API Key 不互通。

第三步

公告购买卡密

注册后查看该站公告,按公告里的链接购买卡密,再回到同一站点兑换充值。

线路选择

按网络环境选择注册站点

三个站点不是同一个数据库。在哪个站点注册,就在哪个站点购买卡密、兑换充值、创建 API Key,并使用该站点的 Base URL。

香港站点

低延迟优先

https://api.20170428.xyz

新加坡节点

东南亚优先

https://xjp.20170428.xyz
重要规则: 三个站点数据不互通。不要在 A 站注册,却拿 B 站的卡密或 API Key 去配置客户端。OpenAI 兼容客户端使用 `选定站点/v1`,Claude Code 使用 `选定站点根地址`。

开通流程

从选站到可调用,只做六步

01

测试并选择站点

根据自己所在区域和连通性测试结果,在三个站点中选择一个作为后续使用站点。

02

注册账号

在选定站点注册账号。三个站点数据库独立,请不要跨站使用账号或余额。

03

公告购买卡密

注册后查看站内公告,按公告里的链接购买卡密。

04

兑换充值

回到同一个站点,在卡密兑换或充值页面输入卡密,确认余额到账。

05

创建 API Key

在 API Key 管理页面新建 Key,立即复制保存。

06

完成联调

使用同一站点的 Base URL 和 API Key 先跑 curl,再接入客户端。

新手速配

不知道怎么配时,按你的工具直接抄

Cursor / Cherry Studio / Open WebUI

OpenAI Base URL 填 `选定站点/v1`,例如 `https://apis.20170428.xyz/v1`。

Claude Code

Base URL 填选定站点根地址,例如 `https://apis.20170428.xyz`,不要加 `/v1`。

想换站点

需要在新站点重新注册、充值并创建 API Key,旧站点余额不会自动迁移。

基础概念

卡密、API Key、Base URL 的区别

卡密 ≠ API Key

卡密是购买后得到的激活码,只能在对应站点兑换充值。

API Key 形如 `sk-xxxx`,只能配合创建它的站点使用。

独立站点规则

OpenAI 兼容客户端:`https://站点域名/v1`

Claude Code:`https://站点域名`

首次连通性测试,以亚太 CDN 为例
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" }
    ]
  }'

客户端接入

常用工具配置速查

Claude Code

使用你注册并充值的站点根地址,不要加 `/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

编辑 `~/.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"

Cursor

Settings → Models → Override OpenAI Base URL。下面以亚太 CDN 为例。

Base URL: https://apis.20170428.xyz/v1
API Key: YOUR_API_KEY

Cherry Studio

服务商管理里选择 OpenAI 兼容接入。下面以亚太 CDN 为例。

名称: 20170428.xyz
Base URL: https://apis.20170428.xyz/v1
API Key: YOUR_API_KEY

NextChat

环境变量中的地址要使用注册并充值所在的站点。

OPENAI_API_KEY=YOUR_API_KEY
BASE_URL=https://apis.20170428.xyz
CUSTOM_MODELS=gpt-4o,gpt-4o-mini,gpt-4-turbo

Open WebUI

下面以亚太 CDN 为例,其他站点请替换为对应域名。

OPENAI_API_BASE_URL=https://apis.20170428.xyz/v1
OPENAI_API_KEY=YOUR_API_KEY

配置核对

提交工单前先自查这四项

账户与余额

  • 当前使用的是注册和充值所在的同一个站点
  • 卡密已在对应站点兑换成功
  • 对应站点后台可见余额
  • API Key 在同一站点创建且未删除

地址与格式

  • OpenAI 兼容客户端地址带 `/v1`
  • Claude Code 地址不带 `/v1`
  • API Key 没有空格和换行

SDK 调用

Python 与 Node.js 示例

Python

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)

Node.js

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" }]
});

故障排查

最常见的 5 类错误

401 Unauthorized

通常是 API Key 复制错误、已失效,或多了空格换行。

403 Forbidden

常见原因是余额不足、Key 权限不足、跨站使用 Key,或触发频率限制。

404 Not Found

绝大多数是 Base URL 填错。OpenAI 兼容必须带 `/v1`,Claude Code 不能带。

Model not found

模型名拼写错误,或当前站点暂不支持该模型。先从 `gpt-4o-mini` 开始测试。

Connection Timeout / SSL

先测试不同站点连通性。若决定更换站点,需要在新站点重新注册、充值并创建 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 单独测试