快速开始

1. 注册并登录

打开 api-ai.onyxaxis.org，点击右上角「登录」，或通过注册页创建账号。

2. 获取 API Key

登录后进入控制台，创建一个 API Key。Key 的格式是 sk- 开头的字符串，和 OpenAI 官方 Key 长得一样 —— 这是有意为之，绝大多数 OpenAI 兼容客户端不需要额外适配就能直接用。

WARNING

Key 只在生成时完整显示一次，请妥善保存。不要把 Key 提交到公开代码仓库或分享给他人。

3. 发第一个请求

选一个模型广场里存在的模型名（比如 gpt-5.5），用 OpenAI 兼容格式发一个请求：

bash

curl https://api-ai.onyxaxis.org/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "你好"}]
  }'

能看到正常的 choices[0].message.content 返回，说明接入成功。

4. 接入你已有的客户端

大多数客户端只需要改两个配置项：

base URL → https://api-ai.onyxaxis.org/v1
API Key → 你在控制台生成的 Key

具体改哪个字段因客户端而异，参见示例里对应工具的配置片段，或直接看接口与兼容性了解支持的请求格式。

5. 选模型

不同模型的能力、速度、价格差异很大，完整、实时的列表在模型广场。如果你是从 OpenAI 或 Anthropic 官方迁移过来，直接用同名或近似名的模型即可；如果某个模型名在客户端里出现"看不到文件""不认识这个工具"之类的怪异行为，先看一眼常见问题，很可能是客户端把这个模型名当成了不支持工具调用的特殊模式，而不是网关的问题。

新手常见的坑：别把 GPT 模型接到 Claude Code、或者把 Claude 模型接到 Codex。两个客户端都对"自家"模型有内置假设，跨着配虽然协议能打通，但更容易出现莫名其妙的问题。推荐搭配是 Codex CLI 配 GPT 系列、Claude Code 配 Claude 系列，原因见常见问题。

不想手动改配置文件，也可以用图形界面工具 CC Switch 管理 —— 但同样要注意分开给 Codex 和 Claude Code 配不同的供应商。

快速开始 ​

1. 注册并登录 ​

2. 获取 API Key ​

3. 发第一个请求 ​