01 · Quickstart
快速开始
- 注册并登录 X-CodeAI 中文站。
- 在控制台完成充值，确保账户有可用余额。
- 创建 API Key，并妥善保存密钥。
-
在 OpenAI 兼容 SDK 或客户端中填写 Base URL：
https://cn.x-codeai.com/v1。 - 通过
model字段选择要调用的模型。
02 · Endpoint
接口地址
统一 Base URL：https://cn.x-codeai.com/v1
OpenAI-compatible SDKs and clients should use this Base URL. 例如 OpenAI SDK、Cherry Studio、OpenCat、DeepChat 以及其他支持 OpenAI 兼容接口的客户端，都优先填写该地址。
Claude、GPT、Gemini、DeepSeek、Qwen 等模型不需要切换不同入口；在同一个
API 入口下调整请求里的
model 字段即可切换模型。
如确需使用 Anthropic Messages
格式，请按客户端要求使用对应兼容路径；普通用户优先使用上面的 OpenAI
兼容入口。
03 · OpenAI SDK
OpenAI SDK 示例
Node.js 项目可直接使用 OpenAI SDK，并将
baseURL 设置为统一入口。
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: process.env.X_CODEAI_API_KEY,
baseURL: 'https://cn.x-codeai.com/v1',
});
const completion = await client.chat.completions.create({
model: 'gpt-4o-mini',
messages: [
{ role: 'user', content: '你好，请简单介绍 X-CodeAI。' },
],
});
console.log(completion.choices[0]?.message?.content);04 · Models
模型切换
所有常用模型都通过同一个 Base URL 访问。你只需要在请求中修改
model：
-
gpt-4o-mini、gpt-4.1等 GPT 模型 -
claude-3-5-sonnet-latest等 Claude 模型 gemini-2.5-pro等 Gemini 模型-
deepseek-chat、qwen-plus等国产与开源模型
05 · Clients
常用客户端填写方式
- API Key：填写控制台创建的 X-CodeAI API Key。
-
Base URL / API Host：填写
https://cn.x-codeai.com/v1。 - Model：按需要填写目标模型名称，例如 GPT、Claude、Gemini、DeepSeek、Qwen 等。
- 格式：优先选择 OpenAI Compatible / OpenAI 兼容。
06 · Billing
账单与用量
控制台会展示余额、Token 消耗、模型价格与调用日志。建议为不同项目创建独立 API Key，并按项目设置额度，便于成本控制和问题排查。
如果请求失败，请优先检查 API Key 是否正确、账户余额是否充足、Base URL
是否为
https://cn.x-codeai.com/v1，以及模型名称是否可用。