接入文档 - ACICode AI API

5分钟快速接入

ACICode AI API 采用标准的 OpenAI 兼容协议，你可以使用任何支持 OpenAI 格式的 SDK 或工具直接接入。

1

注册账号

访问前台注册创建账号，再到用户中心获取你的 API Key

2

替换配置

将原有代码中的 base_url 和 api_key 替换为 ACICode 提供的配置

3

开始调用

无需修改其他代码，即可开始使用 200+ AI 模型

认证方式

所有 API 请求都需要在 HTTP Header 中携带 API Key 进行认证。

                        
                        HTTP Header
                    
Authorization: Bearer sk-acicode-xxxxx

💡 提示

API Key 可以在前台用户中心的「API 密钥」页签创建和管理。请妥善保管你的 API Key，不要将其暴露在客户端代码中。

Base URL

根据你的部署环境，使用对应的 Base URL：

环境	Base URL
生产环境	`https://api.acicode.cc/v1`
站点同源（推荐）	`https://acicode.cc/v1`

Chat Completions

创建对话补全请求，支持流式和非流式响应。

请求地址

                        POST
                        /v1/chat/completions
                    

请求参数

参数	类型	必填	说明
model	string	是	模型ID，如 grok-4.5、gpt-5.4、gpt-4o 或 claude-4-sonnet
messages	array	是	对话消息列表
stream	boolean / string / number	否	是否流式：true / "true" / 1 均可（Cursor 等客户端兼容），默认 false
temperature	number	否	采样温度，0-2，默认 1
max_tokens	integer	否	最大生成 token 数

请求示例

                        
                        
                        
                        JSON
                    
{
  "model": "grok-4.5",
  "messages": [
    {"role": "system", "content": "你是一个有帮助的助手"},
    {"role": "user", "content": "你好，请介绍一下自己"}
  ],
  "stream": false,
  "temperature": 0.7
}

Models 列表

获取当前账号可用的模型列表。

                        GET
                        /v1/models
                    

常用模型 ID

模型	模型ID	类型
Grok 4.5	`grok-4.5`	CLI OAuth · 推荐
Grok 4.5 Fast / High	`grok-4.5-fast` / `grok-4.5-high`	网关别名 → grok-4.5 + reasoning_effort
Grok 4.3 Fast	`grok-4.3-fast`	Web SSO
GPT-4o	`gpt-4o`	多模态
GPT-4o-mini	`gpt-4o-mini`	轻量
GPT-5.4	`gpt-5.4`	通用
GPT-4.1	`gpt-4.1`	推理
Claude 4 Sonnet	`claude-4-sonnet`	编程
Claude 4 Opus	`claude-4-opus`	长文本

Python SDK 示例

安装

                        
                        Bash
                    
pip install openai

非流式调用

                        
                        
                        
                        Python
                    
from openai import OpenAI

client = OpenAI(
    base_url="https://api.acicode.cc/v1",
    api_key="sk-acicode-xxxxx"
)

response = client.chat.completions.create(
    model="grok-4.5",
    messages=[
        {"role": "user", "content": "你好"}
    ]
)

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

流式调用

                        
                        
                        
                        Python
                    
from openai import OpenAI

client = OpenAI(
    base_url="https://api.acicode.cc/v1",
    api_key="sk-acicode-xxxxx"
)

stream = client.chat.completions.create(
    model="grok-4.5",
    messages=[{"role": "user", "content": "讲个故事"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Node.js SDK 示例

安装

                        
                        Bash
                    
npm install openai

调用示例

                        
                        
                        
                        JavaScript
                    
import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.acicode.cc/v1',
  apiKey: 'sk-acicode-xxxxx'
});

async function chat() {
  const response = await client.chat.completions.create({
    model: 'grok-4.5',
    messages: [{ role: 'user', content: '你好' }]
  });
  console.log(response.choices[0].message.content);
}

chat();

cURL 示例

                        
                        
                        
                        Bash
                    
curl https://api.acicode.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-acicode-xxxxx" \
  -d '{
    "model": "grok-4.5",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

CC Switch 配置

CC Switch 可一键管理并切换 Claude Code、Codex、Gemini、OpenClaw 等客户端的供应商。 ACICode 提供 OpenAI 兼容网关，按下方填写即可接入。

准备工作

1）安装 CC Switch； 2）在用户中心创建 API Key（sk-acicode-...）； 3）Base URL 固定为 https://api.acicode.cc/v1（末尾不要多加 /）。

Claude Code（推荐）

1

选择应用

打开 CC Switch，顶部切换到 Claude Code，点右上角 + 添加「应用专属供应商」。

2

自定义供应商

预设里没有 ACICode 时选「自定义」，填写：

字段	值
名称	`ACICode`
API Key	你的 `sk-acicode-...`
Base URL / 端点	`https://api.acicode.cc/v1`
API 格式（高级）	OpenAI Chat Completions
模型	如 `claude-4-sonnet`、`grok-4.5`（可点「获取模型」拉取）

3

启用并验证

在供应商列表点「启用」。Claude Code 一般即时生效；终端里可执行 /status 确认当前供应商。

等价写入 ~/.claude/settings.json 的环境变量示意（CC Switch 会代写，通常无需手改）：

                        
                        
                        
                        ~/.claude/settings.json
                    
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-acicode-xxxxx",
    "ANTHROPIC_BASE_URL": "https://api.acicode.cc/v1",
    "ANTHROPIC_MODEL": "claude-4-sonnet"
  }
}

注意

ACICode 对外是 OpenAI Chat Completions。在 Claude 侧务必把 API 格式选成该项；若选默认 Anthropic Messages 会请求失败。部分版本还需开启 CC Switch 本地代理/应用接管后，格式转换才会生效。

Codex

1

切换到 Codex 应用

顶部选 Codex，添加自定义 / OpenAI Compatible 供应商。

2

填写端点

字段	值
API Key	`sk-acicode-...`（写入 `OPENAI_API_KEY` / auth）
base_url	`https://api.acicode.cc/v1`
wire_api	responses（新版 Codex 已弃用 chat）
model	如 `grok-4.5`（需 `model_catalog_json` 才会出现在 `/model`）

3

启用后重启终端

Codex 切换后需新开终端再运行 codex。也可直接用本站 Codex 一键配置写入同等配置。

                        
                        
                        
                        ~/.codex/config.toml
                    
model = "grok-4.5"
model_provider = "acicode"

[model_providers.acicode]
name = "ACICode AI"
base_url = "https://api.acicode.cc/v1"
wire_api = "responses"
env_key = "ACICODE_API_KEY"
model_catalog_json = "~/.codex/model-catalogs/acicode.json"

OpenClaw / 其它 OpenAI 兼容应用

在 CC Switch 对应应用下添加供应商时，选 OpenAI Compatible（或自定义）， Base URL 填 https://api.acicode.cc/v1，API Key 填 ACICode Key 即可。更多说明见 OpenClaw 专页。

常见问题

404：Base URL 多写了尾部斜杠，或误填成官网地址；请用 https://api.acicode.cc/v1。
401：Key 错误、已停用，或未带 sk-acicode- 前缀。
Claude 无响应 / 格式错误：确认 API 格式为 OpenAI Chat Completions，且 CC Switch 代理已开启。
获取模型失败：可手动填模型 ID；网关 GET /v1/models 可用时再点自动拉取。

流式响应

设置 stream: true（或 "true" / 1）启用 OpenAI 兼容 SSE（text/event-stream，含 data: / [DONE]）。Cursor、VS Code 插件、Codex（wire_api=responses）均可直接接入；网关已关闭 Nginx/代理缓冲。

上游中途断开或缺少 [DONE] 时，网关会下发 SSE error 事件并以 [DONE] 收尾，避免客户端挂起。
流式一旦开始不会中途换号；客户端主动取消不会触发 failover。

⚠️ 注意

流式响应的格式与非流式略有不同，每个 chunk 只包含增量内容，需要客户端自行拼接。

错误处理

API 使用标准的 HTTP 状态码和 JSON 错误格式。

状态码	含义
200	请求成功
401	API Key 无效或已过期
429	请求过于频繁，触发速率限制
500	服务器内部错误

错误响应格式

                        
                        
                        
                        JSON
                    
{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

速率限制

为保障服务稳定性，API 实施以下速率限制：

限制类型	默认限制	说明
请求频率	60 次/分钟	单个 API Key
并发请求	10	同时进行的请求数
Token 速率	100K/分钟	输出 token 限制

💡 提升限制

如需更高的速率限制，请联系客服升级账号等级。