接入文档 - 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://api-test.acicode.cc/v1`

Chat Completions

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

请求地址

                        POST
                        /v1/chat/completions
                    

请求参数

参数	类型	必填	说明
model	string	是	模型ID，如 gpt-5.4、gpt-4o 或 claude-4-sonnet
messages	array	是	对话消息列表
stream	boolean	否	是否使用流式响应，默认 false
temperature	number	否	采样温度，0-2，默认 1
max_tokens	integer	否	最大生成 token 数

请求示例

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

Models 列表

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

                        GET
                        /v1/models
                    

常用模型 ID

模型	模型ID	类型
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="gpt-5.4",
    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="gpt-4o",
    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: 'gpt-5.4',
    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": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

流式响应

设置 stream: true 可以启用 SSE (Server-Sent Events) 流式响应，实现打字机效果。

⚠️ 注意

流式响应的格式与非流式略有不同，每个 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 限制

💡 提升限制

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