端点约定

BeeRouter 对外只有一个 OpenAI 兼容网关。所有请求都打同一个 base URL：路径决定能力，model 字段决定模型。

Base URL

https://api.beerouter.ai/v1

这是当前租户的网关域名。在其后追加下面的端点路径，并为每个请求带上 Authorization: Bearer $API_KEY 鉴权。

端点总览

同步与异步

Chat、messages、responses 在一次 HTTP 请求内返回。设 stream: true 即以 Server-Sent Events（text/event-stream）流式返回，以 data: [DONE] 结束。

图片、视频、语音 生成在上游是长耗时任务，但网关会替你轮询任务并返回统一的同步 JSON 结果——不需要你再去轮询 task id。视频请把客户端超时调大。被限流的请求返回 HTTP 429，并带 Retry-After 响应头。

从直连厂商迁移

端点均与 OpenAI 兼容，大多数情况下你只需改 base_url：

- client = OpenAI(api_key=OPENAI_KEY)
+ client = OpenAI(
+     api_key=SEEAI_KEY,
+     base_url="https://api.beerouter.ai/v1",
+ )

用 Anthropic SDK？把它的 base_url 指向同一个网关，调用 /v1/messages 即可。