鉴权 - Sunra.ai

所有对 Sunra API 的请求都通过 API 密钥进行鉴权。您可以在控制台中创建和管理密钥。

设置 API 密钥

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

export SUNRA_KEY="your-api-key-here"

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

如果您直接通过 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 密钥可以消费您的账户余额——请像对待密码一样保管它。切勿将密钥嵌入客户端代码（浏览器或移动应用），应通过您自己的后端转发请求。推荐做法参见服务端集成。