API Key 格式

API Key 以 wk- 开头，例如 wk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。

传递方式（二选一）

方式一：Authorization 头（推荐）

Authorization: Bearer wk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

方式二：x-api-key 头

x-api-key: wk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

两种方式对所有需要鉴权的 LLM 端点（/v1/chat/completions、/v1/messages、/v1/responses、/v1beta/models/{model}、/api/v3/...）均有效。

鉴权失败

Key 无效或缺失时返回 401，错误体：

{ "error": { "message": "...", "type": "authentication_error" } }

哪些接口不需要鉴权

• GET /v1/models — 列出可用模型，无需鉴权。
• GET /api/public/* — 公开接口（模型、供应商、定价、站点设置等），无需鉴权。