安装 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 额度不足

其他错误见 错误码。

相关文档