接入信息

项目 值
base_url https://api.gxxai.cn/v1
api_key 控制台「令牌」页面创建的 Key,以 sk- 开头
model 控制台模型列表里的名称,下文用 deepseek-v3.2 作示例

1保存 API Key

不要把 Key 直接写进代码里,否则代码上传到 Git 仓库时容易泄露。推荐放在环境变量里:

macOS / Linux
export GXXAI_API_KEY="sk-你的API Key"
Windows PowerShell
$env:GXXAI_API_KEY="sk-你的API Key"

2Python 示例

安装 OpenAI 官方 SDK:

终端
pip install openai

普通调用:

chat.py
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.py
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
chat.mjs
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 在终端里确认接口能通:

macOS / Linux 终端
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
langchain_demo.py
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已有项目怎么迁移

  1. 找到创建 OpenAI 客户端的地方,把 base_url 改成 https://api.gxxai.cn/v1。
  2. 把 Key 换成零点数据的 Key。
  3. 把代码里的模型名称换成控制台里的国产模型名称。
  4. 先在测试环境跑一遍主要功能,确认输出格式符合预期再上线。

很多项目通过环境变量 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 模型。