端点与鉴权

接入地址

https://chat.tokenplain.top/v1

端点

对客网关只有这三个：

端点	用途
POST /v1/chat/completions	对话补全（绝大多数场景）
POST /v1/embeddings	文本向量
GET /v1/models	你这把密钥能调的模型列表

其余 OpenAI 端点（图片、语音、文件、微调、Assistants 等）本平台不提供。 计价也没有「按图片」「按音频分钟」这类维度。

鉴权

标准 Bearer：

Authorization: Bearer YOUR_API_KEY

密钥在控制台创建，明文只在创建时显示一次。

如果这把密钥配了 IP 白名单，从名单外的地址调用会返回 401 invalid_api_key —— 和「密钥无效」是同一个码。这是有意的：给一个专用错误码等于告诉持有泄露密钥的人 「这把 key 是好的，你只是网络不对」。所以排查 401 时，先确认来源 IP， 不要急着重建密钥。

流式

传 "stream": true 即可，返回标准 SSE，以 data: [DONE] 收尾。

• 流式响应的用量在最后一个数据块里。中途断开时那一块拿不到， 但已经产生的 token 照常计费 —— 网关按实际生成量记账，不按你收到多少。
• 长时间无输出通常是上游在排队，不是断了。按你客户端的超时设置处理即可。
• 断流后重试请新开一个请求，不要试图续传，没有这个语义。

SDK 兼容性

任何兼容 OpenAI 的 SDK 换 base_url 即可，代码不用改。 已经跑通的：官方 openai Python / Node SDK、以及绝大多数支持自定义接口地址的桌面客户端与命令行编码工具。

具体客户端怎么配，见「用现成的 SDK 与客户端接入」。