---
url: /tutorial/api/platform.md
---

# 平台开放接口

平台开放接口面向**企业认证用户**与**大客户套餐用户**，用于以编程方式管理账号下的 API 密钥、查询余额与用量。

**调用地址**：`https://api.openai-proxy.org`

## 认证

所有接口走 HTTP Bearer 鉴权，请求头加：

```
Authorization: Bearer sk-admin-xxxxxxxxxxxx
```

`sk-admin-` 开头的**管理密钥**在控制台「开发者模式 → 秘钥管理 → 管理密钥」中创建。管理密钥**不能**用于模型调用，API 密钥（`sk-` 开头）也**不能**用于本组接口，两者权限互不重叠。

> 注意：管理秘钥权限较高，强烈建议配置IP白名单进行保护。

## 错误响应

所有错误统一为如下结构（HTTP 状态码非 2xx 时）：

```json
{ "error": { "code": "<错误码>", "message": "<可读描述>" } }
```

常见状态码：`400` 请求参数错误 · `401` 未认证 · `404` 资源不存在 · `500` 服务端错误。文档中各接口只展示 `200` 成功响应，其它非 2xx 一律遵循上述错误结构。