开始接入
鉴权、API Key 与计费分组
正确配置 Bearer、Anthropic 与 Gemini 请求头，管理密钥轮换、权限和计费分组。
更新于
选择正确地址
| 用途 | 地址 |
|---|---|
| OpenAI-compatible SDK | https://api.token4ai.cloud/v1 |
| Anthropic SDK / Claude Code | https://api.token4ai.cloud |
| Gemini native REST | https://api.token4ai.cloud/v1beta/models/{model}:generateContent |
| Vega 控制台 | https://dash.token4ai.cloud/dashboard |
SDK 通常会追加接口路径。OpenAI base_url 只写到 /v1；Anthropic base_url 使用根地址，避免重复拼出 /v1/v1。
凭证与请求头
一次请求只使用一种密钥传递方式。不要把密钥放到查询字符串、日志、截图或前端 JavaScript 中。浏览器应用应调用自己的服务端，由服务端访问模型网关。
| 协议 | 请求头 |
|---|---|
| OpenAI / general | Authorization: Bearer <API_KEY> |
| Anthropic | x-api-key: <API_KEY>; anthropic-version: 2023-06-01 |
| Gemini | x-goog-api-key: <API_KEY> |
分组与授权范围
API Key 绑定的供应商及计费分组共同约束可访问的模型和价格。切换分组后，应重新查询模型和价目表，再更新应用配置。新建 Key 的限制与可选分组以当前控制台实际展示为准。
| 接口家族 | 所需 scope |
|---|---|
| Models | models.read |
| Chat / Gemini | chat.completions |
| Responses | responses.create |
| Messages / count_tokens | messages.create |
| Embeddings / Rerank | embeddings.create |
| Images | images.generate |
| Audio | audio.create |
| Files read / write | assets.read / assets.write |
返回 403 时先确认当前 Key 的授权范围。不要将“目录中存在模型”理解为“当前 Key 可以调用所有接口”。
轮换与撤销
密钥泄露后立即撤销或轮换，更新服务端配置并重启需要重新读取环境变量的进程。先用新密钥验证目录和一条最小请求，再检查旧密钥是否已停用。轮换不是更换账户，历史用量仍应在原账户中核对。