接入信息
| 项目 | 值 |
|---|---|
| base_url | https://api.gxxai.cn/v1 |
| api_key | 控制台「令牌」页面创建的 Key,以 sk- 开头 |
| model | 控制台模型列表里的名称,下文用 deepseek-v3.2 作示例 |
1保存 API Key
不要把 Key 直接写进代码里,否则代码上传到 Git 仓库时容易泄露。推荐放在环境变量里:
export GXXAI_API_KEY="sk-你的API Key"
$env:GXXAI_API_KEY="sk-你的API Key"
2Python 示例
安装 OpenAI 官方 SDK:
pip install openai
普通调用:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["GXXAI_API_KEY"],
base_url="https://api.gxxai.cn/v1",
)
response = client.chat.completions.create(
model="deepseek-v3.2",
messages=[
{"role": "system", "content": "你是一个简洁的助手。"},
{"role": "user", "content": "用一句话介绍你自己。"},
],
)
print(response.choices[0].message.content)
流式输出(接着使用上面创建好的 client,边生成边显示,适合聊天界面):
stream = client.chat.completions.create(
model="deepseek-v3.2",
messages=[{"role": "user", "content": "写一首关于秋天的短诗"}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
3Node.js 示例
npm install openai
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.GXXAI_API_KEY,
baseURL: "https://api.gxxai.cn/v1",
});
const response = await client.chat.completions.create({
model: "deepseek-v3.2",
messages: [{ role: "user", content: "用一句话介绍你自己。" }],
});
console.log(response.choices[0].message.content);
文件后缀用 .mjs,或在 package.json 里加上 "type": "module",才能直接使用 import 和顶层 await。
4curl 示例
不写代码,也可以先用 curl 在终端里确认接口能通:
curl https://api.gxxai.cn/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $GXXAI_API_KEY" \
-d '{
"model": "deepseek-v3.2",
"messages": [{"role": "user", "content": "你好"}]
}'
5LangChain 示例
pip install langchain-openai
import os
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
model="deepseek-v3.2",
api_key=os.environ["GXXAI_API_KEY"],
base_url="https://api.gxxai.cn/v1",
)
print(llm.invoke("用一句话介绍你自己。").content)
6已有项目怎么迁移
- 找到创建 OpenAI 客户端的地方,把
base_url改成https://api.gxxai.cn/v1。 - 把 Key 换成零点数据的 Key。
- 把代码里的模型名称换成控制台里的国产模型名称。
- 先在测试环境跑一遍主要功能,确认输出格式符合预期再上线。
很多项目通过环境变量 OPENAI_BASE_URL 和 OPENAI_API_KEY 读取配置(新版 OpenAI SDK 也会自动读取这两个变量),
这种情况下不用改代码,改环境变量即可。
常见问题
报错 404
检查 base_url:SDK 里要填带 /v1 的 https://api.gxxai.cn/v1,后面不要再加 /chat/completions。
报错 401 或无效的令牌
Key 不对,或环境变量没生效。可以先在代码里打印一下 Key 的前几位,确认读到的是零点数据的 Key。
报错模型不存在
model 参数和控制台里的名称不一致。直接从控制台复制,注意大小写和连字符。
报错 429
短时间内请求太多。批量任务请控制并发数,并在失败时等待几秒再重试。
能用 Anthropic SDK 调用吗?
可以。零点数据同时兼容 Anthropic 接口格式,地址填 https://api.gxxai.cn(不带 /v1)。调用的仍然是国产模型,不提供 Claude 模型。