创建 API 密钥

API 密钥用于证明请求属于你的账户。每个程序或使用场景建议使用独立密钥，便于限制权限、追踪用量和单独撤销。

创建步骤

1. 打开API 密钥页面。
2. 点击“创建 API 密钥”。
3. 填写易于识别的名称，例如 个人开发环境 或 Cherry Studio。
4. 选择支持目标模型的分组。
5. 按需要设置过期时间和密钥额度。
6. 保存后复制完整密钥，并存入安全位置。

创建表单会集中显示分组、有效期、额度和访问限制；截图未生成或展示任何真实密钥。

密钥通常以 sk- 开头。示例文档统一使用 sk-your-key，不要把真实值写进文档或代码仓库。

表单字段怎么选

字段	建议
名称	写明用途和环境，避免只写“测试”
分组	先到模型广场确认目标模型所在分组
过期时间	临时测试使用短有效期；长期服务设置轮换计划
密钥额度	先给较小额度，验证稳定后再提高
无限额度	仅用于受控的可信服务，不建议新密钥默认开启
模型限制	只允许该应用确实需要的模型
IP 白名单	后端服务器有固定出口 IP 时启用

部分站点配置可能提供 Auto 分组、分组顺序或跨组重试。使用前应理解其倍率和路由行为；首次接入建议先选择一个明确分组，便于排错。

安全保存

macOS 或 Linux：

export SPRELAY_API_KEY="sk-your-key"

Windows PowerShell：

$env:SPRELAY_API_KEY = "sk-your-key"

生产环境应使用部署平台的 Secret 管理功能，不要把密钥提交到 .env.example、Git 历史或前端构建产物。

创建后立即验证

先复制密钥，再使用模型列表接口或第一次请求验证。若请求失败，优先检查密钥状态、分组和模型权限。

下一步：选择分组与模型