> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sunra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 鉴权

所有对 Sunra API 的请求都通过 API 密钥进行鉴权。您可以在[控制台](https://sunra.ai/dashboard/api-tokens)中创建和管理密钥。

## 设置 API 密钥

将您的 API 密钥设置为环境变量：

```bash theme={null}
export SUNRA_KEY="your-api-key-here"
```

官方[客户端库](/client-libraries)会自动从环境变量中读取 `SUNRA_KEY`，无需额外配置。各客户端也支持在代码中显式传入密钥。

## 直接发起 HTTP 请求

如果您直接通过 HTTP 调用 API，请在 `Authorization` 请求头中传递密钥。两条产品线的 API 使用不同的方案：

| API              | Base URL           | 请求头                                |
| ---------------- | ------------------ | ---------------------------------- |
| 多模态（predictions） | `api.sunra.ai`     | `Authorization: Key $SUNRA_KEY`    |
| LLM（completions） | `api-llm.sunra.ai` | `Authorization: Bearer $SUNRA_KEY` |

同一个 API 密钥对两个 API 均有效。

## 密钥安全

API 密钥可以消费您的账户余额——请像对待密码一样保管它。切勿将密钥嵌入客户端代码（浏览器或移动应用），应通过您自己的后端转发请求。推荐做法参见[服务端集成](/zh-Hans/multimodal/server-side-integration)。