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

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

Key

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

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；哪些应用支持，见接入指南。