# 鉴权 (/docs/api/authentication)



所有接口用同一种凭证：在控制台创建的 API Key，随请求放在 `Authorization` 头里。没有别的鉴权方式，也没有按接口不同的规则。

## 一个头 [#一个头]

```
Authorization: Bearer {key}
```

| 段        | 含义                           | 例子                |
| -------- | ---------------------------- | ----------------- |
| `Bearer` | 固定字样                         | `Bearer`          |
| `{key}`  | 你的 API Key，以 `sk-praxis-` 开头 | `sk-praxis-a1b2…` |

一个 Key 通所有前缀下的接口。Key 在[控制台 → API Key](/docs/cloud/account/api-keys) 创建、轮换和吊销；吊销立即生效。

## 各家 SDK 把 Key 放在哪 [#各家-sdk-把-key-放在哪]

你不需要自己拼这个头——官方 SDK 会放；我们同时接受各家 SDK 默认使用的头名。

| SDK               | 你传什么     | 实际发出的头                    |
| ----------------- | -------- | ------------------------- |
| OpenAI SDK        | `apiKey` | `Authorization: Bearer …` |
| Anthropic SDK     | `apiKey` | `X-API-Key: …`            |
| Google GenAI SDK  | `apiKey` | `x-goog-api-key: …`       |
| E2B SDK           | `apiKey` | `X-API-Key: …`            |
| Tavily SDK / HTTP | `apiKey` | `Authorization: Bearer …` |

## 试一条 [#试一条]

```bash
curl https://api.deepraxis.ai/model/v1/models \
  -H "Authorization: Bearer $PRAXIS_API_KEY"
```

## 鉴权失败长什么样 [#鉴权失败长什么样]

Key 缺失、无效或已吊销，返回 `401`，错误体按该前缀的格式（见[错误](/docs/api/errors)）。收到 `401` 不要重试——换对 Key 再发。

## 保管 [#保管]

* 只在服务端使用；不要放进浏览器、移动端或公开仓库。
* 用环境变量（示例里的 `PRAXIS_API_KEY`），不要写进代码。
* 怀疑泄露时在控制台吊销并新建，旧 Key 立即失效。