SDK 接入

适用角色:开发者 更新日期:2026-08-06

平台兼容 OpenAI 和 Messages 兼容格式的官方 SDK。无需更换 SDK,只改两行配置(Base URL + API Key)即可把现有代码切到平台。

本平台 API 地址请在控制台查看,OpenAI Compatible 路由前缀为 /v1,认证使用 Authorization: Bearer sk-xxx


一、OpenAI Python SDK

最常用的接入方式。已有 OpenAI 代码时,改两行即可:

from openai import OpenAI
 
client = OpenAI(
    api_key="YOUR_API_KEY",           # ← 改成平台的 Key
    base_url="https://<接口地址>"   # ← 统一使用域名根地址
)
 
resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好"}]
)
print(resp.choices[0].message.content)

安装:pip install openai


二、OpenAI Node.js SDK

import OpenAI from "openai";
 
const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://<接口地址>",
});
 
const resp = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [{ role: "user", content: "你好" }],
});
 
console.log(resp.choices[0].message.content);

安装:npm install openai


三、Messages 兼容 SDK(anthropic 包)

如果你使用 Messages 兼容 SDK,改 base_url 指向平台:

from anthropic import Anthropic
 
client = Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://<接口地址>"  # Anthropic SDK 使用域名根地址
)
 
resp = client.messages.create(
    model="deepseek-v4-flash",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}]
)
print(resp.content[0].text)

安装:pip install anthropic

Anthropic SDK 走 /v1/messages 端点,max_tokens 为必填参数。


四、其他语言 / 通用范式

平台是标准 HTTP API,任何能发 HTTP 请求的语言都能接入。

Go

// 使用 OpenAI 兼容端点,设置自定义 BaseURL
config := openai.DefaultConfig("YOUR_API_KEY")
config.BaseURL = "https://<接口地址>"
client := openai.NewClientWithConfig(config)

通用 curl(任何环境)

curl https://<接口地>/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"你好"}]}'

五、接入检查清单

迁移到平台时,逐项确认:

  • base_url / baseURL 已指向平台
  • api_key 已换成平台的 Key(sk- 开头)
  • model 字段填的是模型名称(如 deepseek-v4-flash,可在「调用指南」或「模型广场」查看);若主用户启用了分组标识路由,也可使用调用指南页的带分组标识调用名
  • 目标分组 / 模型在你账户的可用范围内
  • 业务代码其余部分无需改动

model 字段默认使用模型名称即可。模型名称与带分组标识两种写法的区别见 调用指南与路由说明(分组标识路由为高级功能,默认关闭)。


下一步