# 认证：API Key 和哪些请求需要它

> okdata 怎么认证：以 okd_ 开头的 API Key 放在 Bearer 请求头里；去哪里拿、怎么保管、哪些不需要 Key，以及认证错误是什么意思。

网页版：https://okdata.online/zh/docs/authentication/

每个付费请求带一把 API Key 就够了，不需要平台账号、Cookie 或扫码登录。

## Key

- Key 以 `okd_` 开头，在[控制台](/zh/console/)的 API Key 页面创建；只在创建时显示一次。
- 放在请求头里：`Authorization: Bearer okd_...`。HTTP 接口 `https://api.okdata.online` 和 MCP 服务 `https://api.okdata.online/mcp` 用的是同一个请求头。
- 把它放进环境变量（约定为 `OKDATA_API_KEY`），或用户目录下客户端自己的设置里。不要写进代码、代码仓库、网址，也不要发进会被分享的对话。
- 每个应用或 agent 单独建一把，用它的名字命名。以后在控制台吊销某一把，只影响那一个应用。

```bash
export OKDATA_API_KEY="okd_..."
curl -sG "https://api.okdata.online/v1/douyin/trends/list" -H "Authorization: Bearer $OKDATA_API_KEY"
```

## 不需要 Key 的请求

| 请求 | 需要 Key |
| --- | --- |
| `GET https://api.okdata.online/v1/catalog`、`GET https://api.okdata.online/v1/catalog/status` | 不要 |
| MCP 的 `find`、`describe`，以及 `account` 返回的服务状态 | 不要 |
| 任何接口调用、MCP 的 `call` | 要 |
| `GET https://api.okdata.online/v1/account`（余额）、`GET https://api.okdata.online/v1/calls/{request_id}`、MCP `account` 查余额 | 要，免费 |

所以在还没有 Key 的时候，智能体就能找接口、看价格、查服务状态；有了 Key 也能不花钱先验证。

## Key 被拒绝时

缺 Key、写错或已吊销，会返回 `401 unauthorized`，`charged: false`。检查请求头名是不是 `Authorization`，值是不是以 `Bearer `（带空格）开头，以及这把 Key 在控制台里是否仍有效。在 MCP 客户端里，如果 `find` 能用而 `call` 报 `unauthorized`，说明 Key 没有传到我们这里。

## 在 AI 应用里登录

有些应用（比如 claude.ai 的连接器和 ChatGPT）连接 MCP 服务时用登录而不是 Key。okdata 支持这种登录（OAuth 2.1）：你登录控制台、同意授权，应用会拿到它自己的一把 Key，带花费上限（不改就是每月 $5）。要断开，在 API Key 页面吊销这把 Key。允许填请求头的应用，照样可以直接用 Key；哪些应用支持，见[接入指南](/zh/integrations/)。

更新于 2026-11-12