开始使用
从创建 API 密钥、确认接口地址和发现模型开始，再按技术栈接入 OpenAI、Claude、Gemini、Codex 或 Claude Code。上线前请同时检查错误处理与密钥安全。
首次接入建议按顺序完成下面三页，每一步都有可验证结果。
| 用途 | 地址或路径 |
|---|---|
| OpenAI Base URL | |
| Anthropic Base URL | |
| 查询模型 | GET /v1/models |
| 文本对话 | POST /v1/chat/completions |
| Responses | POST /v1/responses |
| 图像生成 | POST /v1/images/generations |
开始使用
用一次最小请求确认接口地址、API 密钥与模型 ID 都可用。
在控制台“API 密钥”页面创建密钥。
选择支持目标协议和模型的分组。
复制模型接口实际返回的模型 ID。
先用 OpenAI 兼容请求排除客户端配置问题。
成功时会返回 JSON。失败时先记录状态码和错误信息，再查看“错误与重试”。
开始使用
API 密钥代表调用权限和费用归属。按设备或应用隔离密钥，可以降低泄露影响。
OpenAI 兼容接口推荐使用标准 Bearer 请求头：
Authorization: Bearer sk-你的密钥Anthropic 客户端也可能使用 x-api-key；Gemini 客户端可能使用 x-goog-api-key。
核心 API
密钥所属分组决定可调用的模型。不要猜测模型名称，应以模型接口实时返回为准。
复制响应中 data[].id 的完整值，填入请求的 model 字段。不同密钥看到不同列表通常是分组权限所致。
核心 API
根据上游分组和客户端选择 OpenAI、Anthropic 或 Gemini 兼容协议。
需要流式输出时可在请求中加入 "stream": true。客户端既要检查 HTTP 状态码，也要处理流中断和流内错误。
核心 API
通过 OpenAI 兼容端点生成图像。可用模型和参数由密钥分组及上游模型决定。
返回可能包含 URL 或 Base64 数据，取决于模型和 response_format 支持情况。
集成
兼容 OpenAI SDK 的客户端通常只需替换 API Key、Base URL 与模型 ID。
pip install openai生产环境不要在源代码中写真实密钥。将密钥放入服务器环境变量，并确保日志、错误页面和构建产物不会输出该值。
集成
项目的“API 密钥”页面已经提供“导入到 CCS”按钮。下面是使用该按钮的教程，不需要手动拼接链接。
先安装并启动 CC Switch，然后登录控制台。导入操作会唤起本机的 ccswitch:// 协议，浏览器询问时允许打开。
codex。在 Codex 中用 /model 切换，或用 codex -m 模型ID 启动。只能选择当前密钥分组支持的模型。
claude。Claude Code 会读取 CC Switch 写入的环境配置，切换提供商后建议重新打开终端。
帮助
先根据状态码区分请求、权限、额度与服务异常，再决定是否重试。
| 状态码 | 常见原因 | 处理建议 |
|---|---|---|
| 400 | JSON、参数或模型错误 | 核对请求体、端点和模型列表 |
| 401 | 缺少密钥或密钥无效 | 检查认证头和密钥状态 |
| 403 | 当前密钥没有权限 | 检查分组、白名单和有效期 |
| 404 | 路径不存在或协议不支持 | 检查 Base URL 与 endpoint |
| 429 | 频率、并发或余额受限 | 降低并发，检查额度后有限重试 |
| 5xx | 服务或上游暂时异常 | 记录请求信息并退避重试 |
只对 429、网络瞬断和部分 5xx 有限重试。建议指数退避并加入随机抖动，例如等待 1、2、4 秒，最多尝试 3 次。400、401、403 不应自动重试。
帮助
用最小请求把客户端、网络、反向代理和上游问题分开定位，并保持文档站与 API 系统隔离。
/v1。docs.jikouapi.com。nosniff 和 Referrer Policy。