# Sub2API 文档

- [Sub2API 开发者文档](https://docs.sub2api.ruilinlu.com/index.md): Sub2API 是一个独立运营的 AI API 网关服务，提供 OpenAI、Claude、Gemini、Grok 等主流 AI 模型的统一接入能力。本站是其官方文档中心。
- [Sub2API 服务介绍：AI API 网关一站式接入](https://docs.sub2api.ruilinlu.com/getting-started/introduction.md): Sub2API 是面向开发者的 AI API 网关，通过一个 Key 统一调用 GPT、Claude、Gemini、Grok 等主流模型，支持按量计费与 OpenAI 兼容接口。
- [快速开始：5 分钟完成第一次 API 调用](https://docs.sub2api.ruilinlu.com/getting-started/quickstart.md): 从登录、获取 API Key 到发出第一条请求，带你用 5 分钟完成 Sub2API 的完整接入流程。
- [注册与登录 Sub2API 账号](https://docs.sub2api.ruilinlu.com/getting-started/register.md): 了解如何登录 Sub2API 控制台，当前注册状态说明，以及账号安全管理注意事项。
- [购买与充值：Sub2API 余额管理指南](https://docs.sub2api.ruilinlu.com/getting-started/billing-topup.md): 了解 Sub2API 的按量计费模式、如何充值余额和管理账户余额，帮助开发者合理控制 API 调用成本。
- [在 Sub2API 控制台创建 API Key](https://docs.sub2api.ruilinlu.com/getting-started/create-api-key.md): 按步骤在 Sub2API 控制台中创建 API Key，并了解 Key 的安全保管与最佳实践。
- [发起第一次 API 调用：完整示例指南](https://docs.sub2api.ruilinlu.com/getting-started/first-api-call.md): 通过 cURL、Python 和 Node.js 的完整示例，演示如何向 Sub2API 发起 AI 模型调用并理解响应。
- [Sub2API API Base URL 配置说明](https://docs.sub2api.ruilinlu.com/configuration/base-url.md): 介绍 Sub2API 的 API Base URL 格式，以及在各类客户端和代码中正确填写 Base URL 的方法。
- [one-click](https://docs.sub2api.ruilinlu.com/configuration/one-click.md)
- [cc-switch](https://docs.sub2api.ruilinlu.com/configuration/cc-switch.md)
- [manual](https://docs.sub2api.ruilinlu.com/configuration/manual.md)
- [env-vars](https://docs.sub2api.ruilinlu.com/configuration/env-vars.md)
- [在 Codex CLI 中使用 Sub2API](https://docs.sub2api.ruilinlu.com/clients/codex-cli.md): 配置 Codex CLI 使用 Sub2API 作为 API 后端，支持 OpenAI 兼容格式，快速在终端中使用 AI 编程助手。
- [在 Codex App 中配置 Sub2API](https://docs.sub2api.ruilinlu.com/clients/codex-app.md): 通过 Codex App 图形界面将 Sub2API 设置为自定义 API 提供商，在桌面端体验 AI 编程助手功能。
- [在 Claude Code 中配置 Sub2API](https://docs.sub2api.ruilinlu.com/clients/claude-code.md): 将 Sub2API 设置为 Claude Code 的 API 后端，通过环境变量或 CC-Switch 工具快速完成配置。
- [在 Cherry Studio 中配置 Sub2API](https://docs.sub2api.ruilinlu.com/clients/cherry-studio.md): 在 Cherry Studio 桌面 AI 客户端中添加 Sub2API 作为自定义 OpenAI 兼容服务商，支持多模型对话。
- [在 Chatbox 中配置 Sub2API](https://docs.sub2api.ruilinlu.com/clients/chatbox.md): 在 Chatbox 桌面客户端中设置 Sub2API 为 OpenAI API 提供商，享受跨平台 AI 对话体验。
- [在 OpenCode 中配置 Sub2API](https://docs.sub2api.ruilinlu.com/clients/opencode.md): 将 Sub2API 配置为 OpenCode 的 API 后端，使用开源终端 AI 编程助手访问多种模型。
- [在 Cursor 和 VS Code 中配置 Sub2API](https://docs.sub2api.ruilinlu.com/clients/cursor-vscode.md): 在 Cursor 编辑器和 VS Code AI 扩展中配置 Sub2API，在代码编辑环境中直接使用多种 AI 模型。
- [在 Open WebUI 中配置 Sub2API](https://docs.sub2api.ruilinlu.com/clients/open-webui.md): 在自托管的 Open WebUI 实例中添加 Sub2API 作为 OpenAI 兼容连接，通过 Web 界面访问多种 AI 模型。
- [Sub2API 支持的 OpenAI 模型说明](https://docs.sub2api.ruilinlu.com/models/openai.md): 了解可通过 Sub2API 访问的 OpenAI 模型系列，包括 GPT 系列的适用场景和请求方式。
- [Sub2API 支持的 Claude 模型说明](https://docs.sub2api.ruilinlu.com/models/claude.md): 了解可通过 Sub2API 访问的 Anthropic Claude 模型系列，包括 Claude 3.x/4.x 的特性和适用场景。
- [Sub2API 支持的 Google Gemini 模型说明](https://docs.sub2api.ruilinlu.com/models/gemini.md): 了解可通过 Sub2API 访问的 Google Gemini 模型系列，支持 OpenAI 兼容格式调用。
- [Sub2API 支持的 xAI Grok 模型说明](https://docs.sub2api.ruilinlu.com/models/grok.md): 了解可通过 Sub2API 访问的 xAI Grok 模型系列，支持 OpenAI 兼容 API 格式调用。
- [Sub2API 支持的图像生成模型说明](https://docs.sub2api.ruilinlu.com/models/image-generation.md): 了解可通过 Sub2API 访问的图片生成模型，包括 DALL-E 系列的特性与调用方式。
- [如何根据任务选择合适的 AI 模型](https://docs.sub2api.ruilinlu.com/models/how-to-choose.md): 根据任务类型、质量要求和成本预算，选择最适合你的 AI 模型系列的实用指南。
- [Sub2API 计费说明：Token 按量计费模式](https://docs.sub2api.ruilinlu.com/billing/overview.md): 了解 Sub2API 的按量计费模式、余额如何消耗，以及实际费用如何计算。
- [Sub2API Token 计费说明](https://docs.sub2api.ruilinlu.com/billing/token-billing.md): 了解什么是 Token、输入与输出 Token 如何计费，以及如何估算 API 调用的大致成本。
- [Sub2API Cached Token 说明](https://docs.sub2api.ruilinlu.com/billing/cached-token.md): 了解 Cached Token 的含义、如何产生缓存命中，以及缓存命中对 API 调用成本的影响。
- [model-multiplier](https://docs.sub2api.ruilinlu.com/billing/model-multiplier.md)
- [usage-query](https://docs.sub2api.ruilinlu.com/billing/usage-query.md)
- [balance-topup](https://docs.sub2api.ruilinlu.com/billing/balance-topup.md)
- [faq](https://docs.sub2api.ruilinlu.com/billing/faq.md)
- [Windows 上使用 Sub2API 的完整指南](https://docs.sub2api.ruilinlu.com/tutorials/windows.md): 在 Windows 上安装依赖、配置环境变量并完成第一次 Sub2API 调用的完整步骤指南。
- [macOS 上使用 Sub2API 的完整指南](https://docs.sub2api.ruilinlu.com/tutorials/macos.md): 在 macOS 上配置 Python 环境、设置环境变量并验证 Sub2API 连接的完整操作指南。
- [Linux 上使用 Sub2API 的完整指南](https://docs.sub2api.ruilinlu.com/tutorials/linux.md): 在 Linux 服务器或桌面上配置 Sub2API 环境变量并进行验证性 API 调用。
- [Python 使用 Sub2API 的代码示例](https://docs.sub2api.ruilinlu.com/tutorials/python.md): 通过 Python openai 库使用 Sub2API，涵盖单轮对话、多轮对话、流式输出与错误处理的完整代码示例。
- [cURL 使用 Sub2API 的命令示例](https://docs.sub2api.ruilinlu.com/tutorials/curl.md): 使用 cURL 命令行工具调用 Sub2API，适合快速测试和脚本集成，涵盖 Chat、流式与图片生成。
- [overview](https://docs.sub2api.ruilinlu.com/api/overview.md)
- [openai-compatible](https://docs.sub2api.ruilinlu.com/api/openai-compatible.md)
- [streaming](https://docs.sub2api.ruilinlu.com/api/streaming.md)
- [error-format](https://docs.sub2api.ruilinlu.com/api/error-format.md)
- [Sub2API Responses API 接口说明](https://docs.sub2api.ruilinlu.com/api/responses-api.md): 了解如何通过 Sub2API 使用 OpenAI Responses API 格式，以及它与 Chat Completions API 的区别。
- [Sub2API Chat Completions API 接口说明](https://docs.sub2api.ruilinlu.com/api/chat-completions.md): Sub2API 完整兼容 OpenAI Chat Completions API，支持多轮对话、流式输出与 Function Calling。
- [Sub2API Anthropic Messages API 接口说明](https://docs.sub2api.ruilinlu.com/api/anthropic-messages.md): 通过 Sub2API 使用 Anthropic 原生 Messages API 调用 Claude 模型，支持原生 Anthropic SDK 格式直接对接。
- [gemini](https://docs.sub2api.ruilinlu.com/api/gemini.md)
- [image-generation](https://docs.sub2api.ruilinlu.com/api/image-generation.md)
- [401 Unauthorized 错误排查指南](https://docs.sub2api.ruilinlu.com/troubleshooting/401.md): 401 表示 API Key 无效或缺失，本指南帮你通过排查认证 Header、Key 状态和格式快速定位问题。
- [403 Forbidden 错误排查指南](https://docs.sub2api.ruilinlu.com/troubleshooting/403.md): 403 Forbidden 表示请求被拒绝，可能原因包括账户权限、地区限制或模型访问禁止。
- [429 Too Many Requests 限速错误排查](https://docs.sub2api.ruilinlu.com/troubleshooting/429.md): 429 表示请求频率超过限制，介绍如何实现指数退避重试和并发控制以避免触发限流。
- [500 / 502 / 503 服务端错误排查](https://docs.sub2api.ruilinlu.com/troubleshooting/500-502-503.md): 服务端错误通常是临时故障，介绍如何判断根本原因并实现自动重试。
- [Token Revoked 错误排查](https://docs.sub2api.ruilinlu.com/troubleshooting/token-revoked.md): 收到 Token revoked 说明凭证已被撤销，了解原因并重新获取访问凭证。
- [OAuth Token 失效排查指南](https://docs.sub2api.ruilinlu.com/troubleshooting/oauth-token.md): OAuth Token 失效通常表示登录授权已过期，需要重新登录或更换 API Key。
- [上游服务不可用排查指南](https://docs.sub2api.ruilinlu.com/troubleshooting/upstream-unavailable.md): 上游服务不可用意味着 OpenAI、Anthropic 等上游出现故障，了解应对方法。
- [API 响应延迟较高排查](https://docs.sub2api.ruilinlu.com/troubleshooting/high-latency.md): 导致 API 响应延迟升高的常见原因，以及如何通过流式响应和模型选择改善体验。
- [API Key 无法使用的排查方法](https://docs.sub2api.ruilinlu.com/troubleshooting/api-key-invalid.md): API Key 无法使用时，排查格式错误、账户余额不足、Key 已删除等常见原因。
- [模型不存在或不可用排查](https://docs.sub2api.ruilinlu.com/troubleshooting/model-unavailable.md): 模型返回不存在或不可用错误时，检查模型名称拼写、账户权限与上游可用性。
- [API Key 是什么？如何获取和保管](https://docs.sub2api.ruilinlu.com/faq/what-is-api-key.md): 介绍 API Key 的含义、作用和安全保管要则，帮助初次使用 Sub2API 的用户快速上手。
- [Base URL 应该如何填写？](https://docs.sub2api.ruilinlu.com/faq/base-url.md): 不同客户端和 SDK 中 Base URL 的正确填写方式和常见错误写法的识别与纠正。
- [为什么请求返回 401 Unauthorized？](https://docs.sub2api.ruilinlu.com/faq/why-401.md): 401 错误居高不下？分析最常见的 3 种原因并提供对应的快速修复方法。
- [为什么模型不可用？](https://docs.sub2api.ruilinlu.com/faq/model-unavailable.md): 模型返回不可用或不存在错误时的常见原因和转刀替代模型的建议。
- [如何查询 API 用量？](https://docs.sub2api.ruilinlu.com/faq/usage-query.md): 介绍在 Sub2API 控制台中查看用量明细，以及如何从 API 响应中实时获取 Token 用量。
- [如何选择适合我的 AI 模型？](https://docs.sub2api.ruilinlu.com/faq/choose-model.md): 根据任务类型和成本预算快速选择最合适的 AI 模型系列的实用建议。
- [如何联系 Sub2API 管理员？](https://docs.sub2api.ruilinlu.com/faq/contact-admin.md): 遇到无法自行解决的账户、计费或技术问题时，如何联系 Sub2API 管理员获得帮助。
- [Sub2API 服务条款](https://docs.sub2api.ruilinlu.com/policies/terms.md): Sub2API 服务条款，规定服务性质、用户资格、责任限制与平台使用规则。生效日期：2026年8月31日。
- [Sub2API 使用政策](https://docs.sub2api.ruilinlu.com/policies/usage-policy.md): Sub2API 使用政策，规定禁止行为、自动化调用约束和内容责任要求。
- [Sub2API 支持的国家和地区](https://docs.sub2api.ruilinlu.com/policies/supported-regions.md): 了解 Sub2API 的地区访问政策，明确不支持中国大陆地区，以及其他地区的可用性判断方法。
- [Sub2API 服务特定条款](https://docs.sub2api.ruilinlu.com/policies/service-specific-terms.md): 适用于通过 Sub2API 访问的第三方模型和 API 的服务特定条款。
- [Sub2API 隐私政策](https://docs.sub2api.ruilinlu.com/policies/privacy-policy.md): Sub2API 隐私政策，说明服务收集的信息类型、处理目的和第三方数据转移说明。