创建 API Key

API Key 是客户端调用 Weason 的凭证。建议为 Codex、Claude Code 和生图分别创建 Key，便于识别费用和单独停用。

创建步骤

1. 登录并打开 API 密钥。
2. 点击页面中的新增或创建按钮。
3. 填写名称，例如 codex-laptop、claude-work 或 image-studio。
4. 选择支持目标模型的分组；生图需使用支持目标图片模型的分组。
5. 设置剩余额度、有效期及需要的模型限制。初次使用可设置较小额度。
6. 保存，使用页面的复制功能取得完整 Key。

页面选项可能随版本调整，以控制台实际表单为准。把 Key 保存到密码管理器或本机受控环境中；不要放入共享截图和公开仓库。

在当前终端设置 Key

下面的设置只影响当前终端及从它启动的程序。将占位内容替换为自己的 Key。

macOS / Linux

export WEASON_API_KEY="在这里填写你的 Weason API Key"

Windows PowerShell

$env:WEASON_API_KEY = "在这里填写你的 Weason API Key"

需要长期使用时，可用系统环境变量或密码管理器配置。Windows 用 setx 设置的是后续进程的环境，当前终端不会立即更新；从桌面打开的应用也未必能读取终端中的 export。

验证 Key

curl --fail-with-body https://weason.cn/v1/models \
  -H "Authorization: Bearer $WEASON_API_KEY"

返回包含 data 和模型 id 的 JSON，表示鉴权与模型目录请求成功。它不会验证某个模型的实际生成能力，后续按 第一次请求 测试目标端点。

使用与撤销

在控制台可以调整或停用 Key。发生泄露时先停用旧 Key，再创建替代 Key，并更新所有用到它的客户端。一个设备的配置变更不会自动同步到其他设备。

Key 还可能受到 IP 限制、模型限制、有效期或分组限制。余额足够却不能调用时，也要检查这些项目。