系列导语
本文是【大模型API中转站】系列的实操手册，聚焦 4SAPI 中转平台的完整接入流程。从注册账号到发出第一条 API 请求，每一步都有截图级的文字指引。建议收藏，接入时对照操作。

一、整体流程速览

一句话记住整个流程：

注册用户 → 充值余额 → 创建令牌 → 选择分组 → 设置额度/期限 → 完成创建 → 调用 API

API 的本质也很简单：

API = URL + 令牌

调用配置示例：
  URL:  https://4sapi.com
  密钥: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠️ 关键提示：根据你要调用的模型，必须查阅技术文档（https://4sapi.apifox.cn/）来确定 URL 是否需要追加 /v1 或 /v1/chat/completions。不同模型的接口路径不同，不能想当然。

二、第一步：注册与充值

2.1 注册账号

前往 4SAPI 官网，使用邮箱完成注册。国内邮箱即可，无需海外手机号。

2.2 充值

进入「控制台」页面，选择左侧栏的「钱包管理」，根据实际需求进行充值。

确保账户余额大于 0，否则无法发起 API 调用。支持支付宝、对公转账，按量计费，没有最低消费门槛。

三、第二步：创建 API Key（令牌）

这是整个流程中最关键的一步。API Key 是你调用所有模型的通行证。

3.1 添加令牌

选择左侧栏的「密钥管理」，点击「添加令牌」。

3.2 填写令牌信息

配置项 说明 建议
令牌名称 给这个 Key 起个名字 用项目名或用途命名（如 my-chatbot、cursor-dev）
选择分组 不同分组对应不同资源渠道 参考模型广场价格，或咨询客服经理
令牌额度 该 Key 的可用额度上限 按项目预算设置，超出后自动停用
有效期 Key 的过期时间 长期项目建议按月/年设置

填写完成后，点击「提交」按钮即可生成 Key。

3.3 保存 Key

⚠️ 密钥仅显示一次，生成后务必立即复制保存。丢失后无法找回，只能重新创建。

3.4 查看 Key 信息

创建完成后，在密钥管理页面可以看到该 Key 的以下信息：

四、第三步：选择分组与模型

4.1 分组是什么

不同分组对应不同的资源渠道。分组区别在于：

建议结合自己的使用需求选择性价比最高的分组。不确定选哪个时，可以直接联系客服经理协助选型。

4.2 查看模型广场

在「模型广场」页面可以看到每个分组下可用的模型列表和对应的消耗价格。

4.3 查看模型详情

点击模型名称可以查看该模型的详细信息，包括：

4.4 复制模型名称

❗ 模型名称必须与平台登记的名称完全一致，一个字都不能错。

正确示范：

✅ claude-sonnet-4-5-20250929    （从模型广场直接复制）
✅ gpt-5.3                       （从模型广场直接复制）
✅ deepseek-v4                   （从模型广场直接复制）

❌ claude-sonnet-4.5             （名称不规范，缺少日期后缀）
❌ Claude Sonnet 4.5             （有空格和大写混用）
❌ gpt5.3                        （缺少连接符）

建议直接从模型广场页面复制模型名称，不要手打。

五、第四步：获取中转地址

在控制台页面右侧可以看到不同的站点信息。4SAPI 提供多个接入节点，你可以根据自己的网络情况选择延迟最低的站点。

六、第五步：确定 API 地址和模型名称

这是最容易踩坑的一步——URL 不是固定的，不同模型对应的 API 端点可能不同。

6.1 三种常见的 URL 格式

URL 格式 使用场景
https://4sapi.com 部分模型的基础端点
https://4sapi.com/v1 最常见，OpenAI 兼容接口
https://4sapi.com/v1/chat/completions 部分第三方软件要求填完整路径

如何确定用哪个？ 从「模型广场」页面点击目标模型，查看该模型对应的 API 端点。或者查阅技术文档 https://4sapi.apifox.cn/。

6.2 配置信息汇总

调用任何一个模型，你需要确认以下三个信息：

┌─────────────────────────────────────────────┐
│  API 地址  →  https://4sapi.com/v1          │
│  API 密钥  →  sk-xxxxxxxxxxxxxxxxxxxxxxxx   │
│  模型名称  →  claude-sonnet-4-5-20250929   │
└─────────────────────────────────────────────┘

七、第六步：代码接入

7.1 环境准备

# Python 版本要求
python --version  # >= 3.8

# 安装依赖
pip install openai>=1.0.0
# 如需走 Anthropic 原生格式：
pip install anthropic>=0.30.0

7.2 方式一：OpenAI 兼容格式（推荐）

使用时，把 Key 放在 HTTP 请求的头部进行鉴权，向指定接口地址发送请求：

from openai import OpenAI

client = OpenAI(
    base_url="https://4sapi.com/v1",                  # 从模型广场确认的 URL
    api_key="sk-你的4SAPI令牌密钥"                     # 密钥管理中创建的 Key
)

response = client.chat.completions.create(
    model="claude-sonnet-4-5-20250929",               # 从模型广场复制的名称，必须完全一致
    messages=[
        {"role": "system", "content": "你是一个专业的Python开发助手。"},
        {"role": "user", "content": "用 Python 写一个 LRU 缓存实现，要求线程安全。"}
    ],
    temperature=0.7,
    max_tokens=4096
)

print(response.choices[0].message.content)

7.3 方式二：Anthropic 原生格式

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-你的4SAPI令牌密钥",
    base_url="https://4sapi.com/v1",
    timeout=120
)

response = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=8192,
    system="你是一个专业的技术文档写手，输出使用 Markdown 格式。",
    messages=[
        {"role": "user", "content": "帮我总结一下 React 19 的核心更新。"}
    ]
)

print(response.content[0].text)

7.4 替换已有项目的 API 地址

💡 替换技巧：如果你原本就是调 OpenAI 官方 API 的项目，只需将代码中的 https://api.openai.com/ 替换为 https://4sapi.com 即可，其他代码不用改。

Claude 模型也支持原生 /v1/messages 接口，详情参考 Claude 原生接口调用文档。

7.5 第三方软件/平台的 URL 配置

在一些第三方软件或平台输入自定义 URL 时，可能需要不同的路径格式。具体 URL 可从「模型广场」页面点击模型查看：

https://4sapi.com
https://4sapi.com/v1              ← 最常见
https://4sapi.com/v1/chat/completions

不同软件对 URL 格式的要求不同（有的要求填 API Base，有的要求填完整端点），建议先查阅对应软件的自定义 API 配置文档。

八、第七步：验证与测试

8.1 快速验证

运行任意一段接入代码，如果终端正常返回模型回复，说明接入成功。

8.2 三项核心测试

# 测试 1：连通性
response = client.chat.completions.create(
    model="claude-sonnet-4-5-20250929",
    messages=[{"role": "user", "content": "ping"}]
)
print("✅ 连通性正常" if response else "❌ 连通失败")

# 测试 2：长文本（确认超时设置合理）
long_prompt = "请详细分析以下代码：" + "def example():\n    pass\n" * 200
response = client.chat.completions.create(
    model="claude-sonnet-4-5-20250929",
    messages=[{"role": "user", "content": long_prompt}],
    max_tokens=4096
)
print(f"✅ 长文本通过，返回 {len(response.choices[0].message.content)} 字符")

# 测试 3：并发
# 同时发 5 个请求，全部成功返回即为通过

九、常见踩坑汇总

坑 原因 解法
调不通 URL 少写了 /v1 去模型广场确认正确的 API 端点
404 错误 URL 多写了后缀 部分模型的端点不需要 /chat/completions
401 认证失败 把后台登录密码当 API Key 了 去密钥管理页面复制真正的 API Key
模型不存在 模型名字拼错了 从模型广场直接复制，不要手打
余额不足 账户余额为 0 去钱包管理充值
第三方软件连不上 URL 格式不对 尝试 /v1、/v1/chat/completions、不带后缀三种

技术文档：https://4sapi.apifox.cn/
模型广场：登录控制台后可见
客服咨询：如对分组选型有疑问，可直接联系客服经理协助

本文是【大模型API中转站】系列的实操手册。文中提及的 4SAPI 为当前演示平台，读者可根据自身需求选择合适的中转平台。