所有接口都用 API Key 鉴权。Key 在 控制台 创建后直接使用即可，本站在校验时会自动忽略开头的 sk-，所以加不加前缀都能通过；Key 应仅保存在服务端，不应写入前端代码或提交到代码仓库。
使用 API Key
云上创造 接受三种鉴权请求头，按所用协议或 SDK 选择：
| 请求头 | 适用端点 | 谁会用到 |
|---|---|---|
Authorization: Bearer sk-xxxxxx | 全部端点 | 直接调用，以及 OpenAI SDK（设置 api_key） |
x-api-key: sk-xxxxxx | 仅 /v1/messages 与 /v1/models（其它端点带它会返回 401，请改用 Authorization: Bearer） | Anthropic SDK（设置 api_key），配合 anthropic-version: 2023-06-01 |
x-goog-api-key: sk-xxxxxx | 仅 Gemini 原生端点 /v1beta/models/... | Google GenAI SDK |
使用官方 SDK 时，将 api_key 设为 云上创造 API Key、base_url 指向 云上创造，SDK 会自动添加对应请求头；各 SDK 的完整示例见 创建消息、创建对话补全、生成内容。直接调用 HTTP 接口时任选一种：
本页示例为海外模型，地址用国外通道 https://acapi.top；换成国内通道 https://api.acapi.top 同样可用，两个地址均可用，见 调用地址。
bash
curl https://acapi.top/v1/chat/completions \
-H "Authorization: Bearer sk-xxxxxx" \
-H "content-type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [{"role": "user", "content": "你好"}]
}'鉴权失败统一返回 401。不论是没带鉴权头、Key 写错、还是 Key 已删除，响应体都是同一种形状：error.type 固定为 new_api_error、error.code 为空字符串，message 为中文提示「本次请求鉴权未通过…」并带本次请求 ID。请以 HTTP 状态码 401 判断鉴权失败，不要依赖 message 文案（文案可能随提示优化而调整）。
json
{
"error": {
"code": "",
"message": "本次请求鉴权未通过；仅凭此错误无法确认是 本站令牌还是上游凭据问题，也不能据此判断 云上创造 API Key 已失效。请核对请求鉴权配置，具体以错误 code 与控制台令牌状态为准；持续失败请联系站方。 (request id: 202610040133100287101778268d9d6esaiHA3z)",
"type": "new_api_error"
}
}| 常见触发条件 | 处理 |
|---|---|
没有带任何受支持的鉴权请求头，或在非 Gemini 端点只带了 x-goog-api-key，或在 /v1/messages、/v1/models 以外的端点（如 /v1/chat/completions、/v1/responses、用量查询接口）只带了 x-api-key | 按上表为对应协议补上正确的请求头 |
Authorization: Bearer / x-api-key / x-goog-api-key 里的 Key 不正确、不完整或已删除 | 在 控制台 核对或重新创建 Key |
Key 泄露后的处理
在 控制台 删除泄露的 Key，并创建新的 Key 替换。已删除的 Key 无法再通过鉴权，使用它的请求将收到 401。