安装 SDK
NextAI Code 兼容 OpenAI、Anthropic、Google GenAI 的官方 SDK:安装官方包,只改 api_key 与 base_url 两处即可调用。
开始前请先 获取 API Key 并设置环境变量:
BASH
export NEXTAI_API_KEY="YOUR_API_KEY"
| SDK | 安装 | Base URL |
|---|---|---|
| OpenAI Python | pip install -U openai |
https://www.nextai-code.com/v1 |
| OpenAI Node.js | npm install openai |
https://www.nextai-code.com/v1 |
| Anthropic Python | pip install -U anthropic |
https://www.nextai-code.com |
| Anthropic Node.js | npm install @anthropic-ai/sdk |
https://www.nextai-code.com |
| Google GenAI Python | pip install -U google-genai |
https://www.nextai-code.com |
示例中的模型名仅作演示,实际可用模型以 GET /v1/models 返回为准。
OpenAI SDK
用于 Chat、Responses、Embeddings、图片、语音等 OpenAI 兼容接口,也是绝大多数第三方工具的接入方式。
Python
BASH
pip install -U openai
PYTHON
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["NEXTAI_API_KEY"],
base_url="https://www.nextai-code.com/v1",
)
resp = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.choices[0].message.content)
Node.js
BASH
npm install openai
JAVASCRIPT
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.NEXTAI_API_KEY,
baseURL: "https://www.nextai-code.com/v1",
});
const resp = await client.chat.completions.create({
model: "deepseek-v4.1-flash",
messages: [{ role: "user", content: "用一句话介绍你自己" }],
});
console.log(resp.choices[0].message.content);
OpenAI SDK 也读取环境变量
OPENAI_API_KEY与OPENAI_BASE_URL。把它们分别设为你的 API Key 和https://www.nextai-code.com/v1后,可直接OpenAI()无参初始化。
Anthropic SDK
用于 /v1/messages(Claude Messages 格式)。SDK 会自动拼接 /v1/messages,所以 Base URL 不带 /v1。
Python
BASH
pip install -U anthropic
PYTHON
import os
import anthropic
client = anthropic.Anthropic(
api_key=os.environ["NEXTAI_API_KEY"],
base_url="https://www.nextai-code.com",
)
msg = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(msg.content[0].text)
Node.js
BASH
npm install @anthropic-ai/sdk
JAVASCRIPT
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: process.env.NEXTAI_API_KEY,
baseURL: "https://www.nextai-code.com",
});
const msg = await client.messages.create({
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "用一句话介绍你自己" }],
});
console.log(msg.content[0].text);
Anthropic SDK 也读取环境变量
ANTHROPIC_API_KEY与ANTHROPIC_BASE_URL(设为https://www.nextai-code.com),Claude Code 等基于该 SDK 的工具同样适用。
Google GenAI SDK
用于 Gemini 原生格式接口 /v1beta/models/{model}:generateContent。SDK 会自动拼接 /v1beta/...,所以 Base URL 不带版本路径。
Python
BASH
pip install -U google-genai
PYTHON
import os
from google import genai
from google.genai import types
client = genai.Client(
api_key=os.environ["NEXTAI_API_KEY"],
http_options=types.HttpOptions(base_url="https://www.nextai-code.com"),
)
resp = client.models.generate_content(
model="gemini-3.8-flash",
contents="用一句话介绍你自己",
)
print(resp.text)
验证安装
能正常打印模型回复即接入成功。如果报错:
| 现象 | 排查 |
|---|---|
401 / AuthenticationError |
API Key 错误或环境变量未生效,见 获取与配置 API Key |
404,message 为 Invalid URL (...) |
Base URL 写错:OpenAI 需带 /v1,Anthropic / Gemini 不带,见 Base URL 总览 |
404,code 为 model_not_found |
模型名写错或不在你的 API Key 分组中,先调用 GET /v1/models 确认 |
402 |
账户余额或 API Key 额度不足 |
其他错误见 错误码。