AI API 平台
INTEGRATION GUIDE

快速接入 AI API 平台

一个 Base URL，一个 API Key，即可在常见客户端和代码项目中调用你已配置的模型。

Overview

接入概览

平台提供 OpenAI 兼容接口。你只需要在客户端里替换接口地址和 API Key，就可以把请求转发到控制台中配置好的模型渠道。

1进入控制台添加上游渠道和模型。
2在令牌管理中创建调用 Token。
3把客户端 Base URL 改为平台地址。
4选择模型名称，开始发送请求。
Base URL

接口地址

本地开发环境使用下面的地址。正式部署后，把域名替换成你的 HTTPS 域名。

http://localhost:3000/v1

常见完整接口路径：

POST http://localhost:3000/v1/chat/completions
GET  http://localhost:3000/v1/models
API Key

创建调用令牌

进入控制台后，在「令牌管理」里创建新的 Token。客户端请求时使用 Bearer Token 方式传入。

Authorization: Bearer sk-your-token

建议为不同应用分别创建令牌，方便后续查看用量、限制额度和排查问题。

Clients

客户端配置

Base URLhttp://localhost:3000/v1
API Key控制台令牌管理中创建的 Token
Model控制台渠道中已启用的模型名称

Cherry Studio、DeepChat、OpenCat、Claude Code 兼容适配器等工具，通常都可以在 Provider 或 OpenAI Compatible 配置中填写这些字段。

Examples

请求示例

下面是一个最小的 Chat Completions 调用示例。

curl http://localhost:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-token" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      { "role": "user", "content": "你好，帮我测试一下连接。" }
    ]
  }'
FAQ

常见问题

模型名称在哪里看？

进入控制台的渠道管理或模型管理页面，确认模型名称和启用状态。客户端填写的模型名必须和平台中配置的一致。

为什么返回 401？

通常是 Token 未填写、填写错误或令牌已被禁用。请重新复制令牌并检查请求头。

如何查看调用记录？

进入控制台的使用日志页面，可以按令牌、模型、渠道和时间范围筛选请求。