OpenAI 与 Anthropic SDK 接入指南

OpenAI SDK 使用 Base URL https://bettertoken.ai/v1，Anthropic SDK 使用 https://bettertoken.ai。以下示例使用你的 BetterToken API Key，分别通过 Chat Completions、Responses 和 Messages 发送简短的文本请求。

选择 SDK 与 Base URL

API	SDK	Base URL	HTTP 认证请求头	参考文档
Chat Completions	OpenAI	`https://bettertoken.ai/v1`	`Authorization: Bearer YOUR_API_KEY`	Chat Completions
Responses	OpenAI	`https://bettertoken.ai/v1`	`Authorization: Bearer YOUR_API_KEY`	Responses
Messages	Anthropic	`https://bettertoken.ai`，不带 `/v1`	`x-api-key: YOUR_API_KEY`	Messages

SDK 会添加接口路径和认证请求头。Anthropic SDK 还会发送 API 版本请求头。如果你正在迁移已有代码，请参阅协议对比。

准备工作

先按快速接入创建 BetterToken API Key 并充值。从模型广场复制支持目标接口的 Model ID。发送请求前，替换下方的两个占位值。在运行示例的终端中设置这些变量。本页 Shell 命令使用 macOS / Linux 语法：

export BETTERTOKEN_API_KEY="YOUR_API_KEY"
export BETTERTOKEN_MODEL_ID="YOUR_MODEL_ID"

Python 用户请在项目虚拟环境中安装 SDK：

python3 -m venv .venv
source .venv/bin/activate
python -m pip install openai anthropic

JavaScript 用户请在项目中安装依赖，将每个示例保存为独立的 .mjs 文件，再用 node 运行：

npm install openai @anthropic-ai/sdk

所有示例都从 BETTERTOKEN_API_KEY 读取密钥，并关闭 SDK 自动重试，避免一次测试在你不知情时发起多次请求。应用的重试策略请参阅错误与限制。

调用 Chat Completions

用 messages 传入对话。文本请求成功后，从 choices[0].message.content 读取内容。

Python
JavaScript
curl

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["BETTERTOKEN_API_KEY"],
    base_url="https://bettertoken.ai/v1",
    timeout=120.0,
    max_retries=0,
)
response = client.chat.completions.create(
    model=os.environ["BETTERTOKEN_MODEL_ID"],
    messages=[{"role": "user", "content": "Reply with one word: OK"}],
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.BETTERTOKEN_API_KEY,
  baseURL: "https://bettertoken.ai/v1",
  timeout: 120000,
  maxRetries: 0,
});
const response = await client.chat.completions.create({
  model: process.env.BETTERTOKEN_MODEL_ID,
  messages: [{ role: "user", content: "Reply with one word: OK" }],
});
console.log(response.choices[0].message.content);

curl --fail-with-body --max-time 120 "https://bettertoken.ai/v1/chat/completions" \
  -H "Authorization: Bearer $BETTERTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$BETTERTOKEN_MODEL_ID\",\"messages\":[{\"role\":\"user\",\"content\":\"Reply with one word: OK\"}]}"

调用 Responses

用 input 传入提示词。OpenAI SDK 提供便于读取文本的 output_text 属性；HTTP JSON 响应则包含 output 数组。请检查消息项及其中的文本内容，不要假设每个输出项都是文本。

Python
JavaScript
curl

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["BETTERTOKEN_API_KEY"],
    base_url="https://bettertoken.ai/v1",
    timeout=120.0,
    max_retries=0,
)
response = client.responses.create(
    model=os.environ["BETTERTOKEN_MODEL_ID"],
    input="Reply with one word: OK",
)
print(response.output_text)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.BETTERTOKEN_API_KEY,
  baseURL: "https://bettertoken.ai/v1",
  timeout: 120000,
  maxRetries: 0,
});
const response = await client.responses.create({
  model: process.env.BETTERTOKEN_MODEL_ID,
  input: "Reply with one word: OK",
});
console.log(response.output_text);

curl --fail-with-body --max-time 120 "https://bettertoken.ai/v1/responses" \
  -H "Authorization: Bearer $BETTERTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$BETTERTOKEN_MODEL_ID\",\"input\":\"Reply with one word: OK\"}"

调用 Messages

传入 messages，并设置必填的 max_tokens。这个简短文本请求的成功响应包含类似 content[0].text 的文本块。处理一般响应时，应遍历 content，只读取 type: "text" 的块。

Python
JavaScript
curl

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["BETTERTOKEN_API_KEY"],
    base_url="https://bettertoken.ai",
    timeout=120.0,
    max_retries=0,
)
response = client.messages.create(
    model=os.environ["BETTERTOKEN_MODEL_ID"],
    max_tokens=256,
    messages=[{"role": "user", "content": "Reply with one word: OK"}],
)
for block in response.content:
    if block.type == "text":
        print(block.text)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: process.env.BETTERTOKEN_API_KEY,
  baseURL: "https://bettertoken.ai",
  timeout: 120000,
  maxRetries: 0,
});
const response = await client.messages.create({
  model: process.env.BETTERTOKEN_MODEL_ID,
  max_tokens: 256,
  messages: [{ role: "user", content: "Reply with one word: OK" }],
});
for (const block of response.content) {
  if (block.type === "text") console.log(block.text);
}

curl --fail-with-body --max-time 120 "https://bettertoken.ai/v1/messages" \
  -H "x-api-key: $BETTERTOKEN_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$BETTERTOKEN_MODEL_ID\",\"max_tokens\":256,\"messages\":[{\"role\":\"user\",\"content\":\"Reply with one word: OK\"}]}"

常见错误

现象	检查与处理
URL 错误或 `404`	OpenAI SDK 的 Base URL 带 `/v1`，Anthropic SDK 的不带。不要将完整接口路径追加到 SDK 的 Base URL。
`401` 或缺少凭据	示例从 `BETTERTOKEN_API_KEY` 显式传入密钥。直接调用 OpenAI 接口使用 Bearer，直接调用 Messages 使用 `x-api-key`。
找不到模型	将 `YOUR_MODEL_ID` 替换为模型广场中准确、可用的 Model ID，并确认它支持所选接口。
请求仍发往旧地址	检查 SDK 参数和继承的变量，参阅清除冲突的环境变量。
文本为空或回答不完整	查看完整响应和停止原因，检查输出 Token 上限。

两种 SDK 可以共用一个 Key 吗？

可以。一个 BetterToken API Key 可调用所有可用模型。按各 SDK 的要求设置 Base URL 和请求格式即可。

如何添加流式输出、工具调用或结构化输出？

流式输出和工具调用的支持情况因模型而异。先用你的 Model ID 发送一个小请求，再按流式输出与工具调用操作。JSON 校验和依赖模型支持的结构化输出请参阅结构化 JSON 常见问题。

接口文档

开发者指南

OpenAI 与 Anthropic SDK 接入指南

选择 SDK 与 Base URL

准备工作

调用 Chat Completions

调用 Responses

调用 Messages

常见错误

两种 SDK 可以共用一个 Key 吗？

如何添加流式输出、工具调用或结构化输出？

相关文档

官方参考

​选择 SDK 与 Base URL

​准备工作

​调用 Chat Completions

​调用 Responses

​调用 Messages

​常见错误

​两种 SDK 可以共用一个 Key 吗？

​如何添加流式输出、工具调用或结构化输出？

​相关文档

​官方参考

选择 SDK 与 Base URL

准备工作

调用 Chat Completions

调用 Responses

调用 Messages

常见错误

两种 SDK 可以共用一个 Key 吗？

如何添加流式输出、工具调用或结构化输出？

相关文档

官方参考