客户端与 SDK 接入
使用 Python、Node.js、Anthropic SDK 和兼容客户端接入企业 API。
先完成 快速开始,再配置 SDK 或图形客户端。将 Key 放在服务端环境变量中;网页或手机应用应请求你自己的后端,由后端保管 Key 并调用模型。
Python:OpenAI SDK
安装所需 SDK:
python3 -m pip install openaiimport os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["BEEFAPI_KEY"],
base_url="https://enterprise.beefapi.com/v1",
max_retries=0,
timeout=120.0,
)
response = client.chat.completions.create(
model="gpt-5.6-sol",
messages=[{"role": "user", "content": "写一句简洁的欢迎语。"}],
)
print(response.choices[0].message.content)示例关闭 SDK 自动重试,便于第一次接入时观察每次真实请求。正式应用需按 错误排查 区分可重试错误和执行状态未知,配置有上限的重试。
Node.js:OpenAI SDK
npm install openai以下保存为 .mjs 文件,运行前设置 BEEFAPI_KEY:
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: process.env.BEEFAPI_KEY,
baseURL: 'https://enterprise.beefapi.com/v1',
maxRetries: 0,
timeout: 120000,
});
const response = await client.chat.completions.create({
model: 'gpt-5.6-sol',
messages: [{ role: 'user', content: '写一句简洁的欢迎语。' }],
});
console.log(response.choices[0].message.content);Python:Anthropic SDK
python3 -m pip install anthropicimport os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ["BEEFAPI_KEY"],
base_url="https://enterprise.beefapi.com",
max_retries=0,
timeout=120.0,
)
response = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=512,
messages=[{"role": "user", "content": "写一句简洁的欢迎语。"}],
)
for block in response.content:
if block.type == "text":
print(block.text)图形客户端与 Claude Code
在支持自定义 OpenAI 兼容服务的客户端中,将 Base URL 设为 https://enterprise.beefapi.com/v1,填入企业 Key,模型名使用 实时目录 中的精确 ID。如果客户端字段要求“完整请求地址”,按其说明填写完整 /v1/chat/completions,不要同时让它再次拼接路径。
Claude Code 的企业接入使用根地址 https://enterprise.beefapi.com,通过客户端支持的 Anthropic Base URL 和密钥配置项设置。模型选择应与企业目录一致。客户端订阅权益和企业 API 余额分别管理,填写 Key 不会转移订阅或余额。
接入验证顺序
先查询目录,再发送简短非流式消息,再开启流式输出,最后验证应用实际需要的工具调用和长上下文。测试通过的普通聊天请求不能证明客户端的所有 Agent 功能都可用。
若 curl 成功而客户端失败,检查客户端实际发送的域名、路径、模型、协议和可选参数;记录 HTTP 状态及响应正文,脱敏后再提供给支持人员。