通用 SDK 接入指南

BestAI 兼容 OpenAI 和 Anthropic 两种 API 协议。任何支持自定义 Base URL 的 SDK 或工具都可以直接接入。

统一接入信息

项目	值
Base URL	https://api.bestai.chat
API Key	sk- 开头，在控制台创建
OpenAI 兼容端点	/v1/chat/completions、/v1/responses
Anthropic 兼容端点	/v1/messages
模型列表	GET /v1/models

同一个 Key 可同时用于 OpenAI 协议和 Anthropic 协议。

Python — OpenAI SDK

from openai import OpenAI

client = OpenAI(
    base_url="https://api.bestai.chat/v1",
    api_key="sk-你的Key",
)

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[
        {"role": "user", "content": "你好"}
    ],
)

print(response.choices[0].message.content)

Python — Anthropic SDK

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.bestai.chat",
    api_key="sk-你的Key",
)

message = client.messages.create(
    model="claude-sonnet-4",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "你好"}
    ],
)

print(message.content[0].text)

Node.js — OpenAI SDK

import OpenAI from "openai"

const client = new OpenAI({
  baseURL: "https://api.bestai.chat/v1",
  apiKey: "sk-你的Key",
})

const response = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "你好" }],
})

console.log(response.choices[0].message.content)

Node.js — Anthropic SDK

import Anthropic from "@anthropic-ai/sdk"

const client = new Anthropic({
  baseURL: "https://api.bestai.chat",
  apiKey: "sk-你的Key",
})

const message = await client.messages.create({
  model: "claude-sonnet-4",
  max_tokens: 1024,
  messages: [{ role: "user", content: "你好" }],
})

console.log(message.content[0].text)

curl — Chat Completions

curl https://api.bestai.chat/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "你好"}]
  }'

curl — Anthropic Messages

curl https://api.bestai.chat/v1/messages \
  -H "x-api-key: sk-你的Key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

注意事项

Base URL 区别

SDK 类型	Base URL
OpenAI SDK（Python/Node）	https://api.bestai.chat/v1
Anthropic SDK（Python/Node）	https://api.bestai.chat

OpenAI SDK 需要带 /v1 后缀（SDK 内部不会自动追加路径），Anthropic SDK 只需要根地址（SDK 自动追加 /v1/messages）。

环境变量方式

生产环境不要把 Key 硬编码在代码中。推荐：

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.bestai.chat/v1",
    api_key=os.environ["BESTAI_API_KEY"],
)

流式输出

BestAI 完整支持 SSE 流式响应：

stream = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "写一首诗"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

图片生成

curl https://api.bestai.chat/v1/images/generations \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "一只橘猫在码代码",
    "size": "1024x1024"
  }'

其他工具接入

任何支持自定义 OpenAI API 地址的工具（如 ChatBox、LobeChat、Open WebUI 等），填入以下信息即可：

• API 地址 / Base URL: https://api.bestai.chat/v1
• API Key: sk-你的Key
• 模型: 从 模型价格页 选择