Sub2API Gateway

168API 使用文档

168API 是基于 Sub2API 搭建的个人 AI API 网关。你只需要一个 API Key,就可以在 Claude Code、Codex、Gemini CLI 和其他 OpenAI-compatible 工具中切换使用已接入的模型。

核心思路:把上游账号、模型映射、密钥、额度、并发和日志集中到 168API 管理。客户端只需要 配置统一的 Base URL、API Key 和模型名。

快速开始

项目配置
站点https://api.168518.cc.cd
OpenAI / Codex Base URLhttps://api.168518.cc.cd/
Claude / Gemini Base URLhttps://api.168518.cc.cd
API Key在控制台生成你的个人 sk-... 密钥
模型名以控制台实际开放的模型映射为准

CC-Switch 配置

Claude Code

适合 Claude Code、Anthropic-compatible 客户端。

Provider: 168API
  Base URL: https://api.168518.cc.cd
  API Key:  sk-your-key
  Model:    后台开放的 Claude 模型名

Codex

适合 Codex CLI、OpenAI-compatible SDK 和 Responses API 工具链。

Provider:
  168API
  Base URL: https://api.168518.cc.cd/
  API Key:  sk-your-key
  Model:    后台开放的 OpenAI/Codex 模型名

Gemini CLI

适合 Gemini-compatible 客户端。

Provider: 168API
  Base URL: https://api.168518.cc.cd
  API Key:  sk-your-key
  Model:    后台开放的 Gemini 模型名

API 端点

能力路径说明
OpenAI compatible/v1用于 GPT、Codex、OpenAI SDK 等兼容请求。
Claude compatible/v1/messages 或控制台展示路径用于 Claude Code 和 Anthropic-style 消息接口。
Gemini compatible/v1beta用于 Gemini CLI 或 Gemini-compatible 客户端。
Antigravity以控制台展示为准用于 Antigravity-compatible 工作流。

模型说明

168API 的模型名来自后台模型映射。不同用户、订阅或密钥可能看到不同模型列表。遇到模型不可用时,请先确认:

  • API Key 是否有效且余额/额度足够。
  • 模型名是否和控制台展示完全一致。
  • 当前密钥是否被限制订阅、并发或 RPM。
  • 上游账号是否可用,是否触发风控或限速。

密钥安全

  • 不要把 API Key 写入公开仓库、前端代码、公开文档或聊天记录。
  • 不同工具建议使用不同 API Key,便于限额、审计和 快速停用。
  • 发现泄露后,立即删除旧 Key 并重新生成。
  • 长期运行的自动化任务建议单独设置额度和并发限制。

常见问题

请求返回 401

通常是 API Key 错误、已删除、未带 Authorization header,或客户端配置的 Key 不是 168API 生成的密钥。

请求返回 404

通常是 Base URL 或路径不匹配。Codex/OpenAI-compatible 工具优先使用 https://api.168518.cc.cd/

模型不存在

检查模型名是否与控制台展示一致。不要直接假设上游官方模型名一定已经映射到 168API。

请求超时或不稳定

可能是上游账号限速、网络波动或并发过高。降低并发后重试,并查看控制台日志。