> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 原来用 OpenAI SDK，接 BeatAPI 要改什么？

> 使用 OpenAI SDK 接入 BeatAPI 只需修改 API Key、base_url（https://direct.beatapi.io/v1）和精确模型 ID，原有 Chat Completions 或 Responses 调用方式保持不变。

现有 OpenAI SDK 项目切换到 BeatAPI 时，只需修改三项配置：API Key、`base_url`（`https://direct.beatapi.io/v1`）以及精确的可用 `model` ID。原有 Chat Completions（`messages`）或 Responses（`input`）代码结构无需重写。

## 最小接入配置

在服务端初始化客户端时填入 `BEATAPI_API_KEY`，将 `base_url` 指向文本直连地址 `https://direct.beatapi.io/v1`（可规避常规 API 域名的 Cloudflare 100 秒超时限制，网络不可达时可回退至 `https://api.beatapi.io/v1`），并指定已开通的模型 ID（例如 `gpt-6-luna`）。

```python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["BEATAPI_API_KEY"],
    base_url="https://direct.beatapi.io/v1",
)

completion = client.chat.completions.create(
    model="gpt-6-luna",
    messages=[{"role": "user", "content": "仅回复 OK。"}],
)
print(completion.model, completion.choices[0].message.content)
```

## 校验与灰度放量步骤

1. **核对可用模型**：不确定当前 Key 可调用的模型 ID 时，携带 `Authorization: Bearer <BEATAPI_API_KEY>` 调用 `GET https://api.beatapi.io/v1/models` 获取列表。
2. **保持协议对应**：Chat Completions 继续调用 `POST /v1/chat/completions` 并传 `messages`；Responses 继续调用 `POST /v1/responses` 并传 `input`。
3. **逐项恢复高级参数**：先发一条短的非流式请求并核对返回的 `model` 与内容，再依次开启流式输出和结构化输出。永久 API Key 只保存在可信服务端，不放入浏览器或移动端代码。

[GPT 参考](/zh/api-reference/text-api/gpt-chat-completions)

## 合同与相关问题

发送收费请求前，先免费查看模型合同：`model:gpt-6-luna`, `model:gpt-image-2.5-flare-std`。

[返回AI 模型问题索引](/zh/faq/models)。