开始使用
认证
使用环境变量保存 Key，区分账户登录、API 认证和分组权限。
账户密码和 API Key 用在不同位置#
网页登录使用你的站点账户；模型调用使用令牌页面创建的 API Key。不要把登录密码或网页 Cookie 当成 API Key。通常的 API 请求使用 Authorization: Bearer … 认证；应用的 API Key 输入框只填写密钥本身，不重复添加 Bearer。
在当前终端设置环境变量#
以下命令会提示你输入密钥，输入内容不显示在终端中。变量只对当前终端及其启动的程序生效。设置后，在同一终端运行示例或客户端。
Windows PowerShell#
$lensSecret = Read-Host 'LensAPI API Key' -AsSecureString
$env:LENSAPI_API_KEY = [System.Net.NetworkCredential]::new('', $lensSecret).Password
Remove-Variable lensSecretmacOS / Linux / WSL 的 Bash#
printf 'LensAPI API Key: '
read -r -s LENSAPI_API_KEY
printf '\n'
export LENSAPI_API_KEY不要通过打印变量来检查密钥，也不要把含密钥的命令、请求头或截图贴到公开讨论区。长期使用时，可由你信任的密钥管理工具向应用注入环境变量。
不同客户端使用不同变量#
| 场景 | 配置方式 | 教程 |
|---|---|---|
| 本文 API 示例 | LENSAPI_API_KEY | 快速开始 |
| Codex | 自定义 provider 的 env_key 指向 LENSAPI_API_KEY | Codex 接入 |
| Claude Code | ANTHROPIC_API_KEY，使用 CC-MAX Key | Claude Code 接入 |
Key 有效，但仍然不能调用#
认证成功只说明识别了这把 Key。模型是否可用，还与分组、模型限制、令牌额度、有效期及账户余额有关。逐项检查，不需要反复新建大量 Key。
不用时清除或撤销#
当前终端不用该密钥时，PowerShell 可运行 Remove-Item Env:LENSAPI_API_KEY，Bash 可运行 unset LENSAPI_API_KEY。清除本地变量不会撤销令牌；泄漏或不再需要的 Key 应在站点令牌页面停用或删除。详见密钥与使用安全。