创建与管理 API 密钥
从创建、一次性保存到模型授权、IP 白名单、消费上限、限流与停用，按最小权限配置程序接入。
更新日期
开始之前
- 已注册并登录自己的 LINK42 账户；控制台操作使用登录会话，API 调用使用本站 API 密钥。
- 生成会按实际用量扣费。先确认余额、模型可用状态与预估费用；截图只用于说明操作，不代表模型已开通，也不代表生成结果。
创建密钥并安全保存
打开 API 密钥
进入个人控制台的“API 密钥”，点击“创建密钥”。本站创建自己的接入密钥，不提供导入其他平台密钥的入口。
填写用途与限制
用项目或环境命名，例如“后端服务-测试”。按需要填写授权、白名单、预算和有效期；测试与生产使用不同密钥。
保存一次性密钥
创建成功后完整值仅显示一次。将它放到服务端环境变量或密钥管理系统；不要截图、提交 Git、写进前端或聊天。关闭后无法重新查看完整值。
验证最小调用
用同一 Key 请求 GET https://www.link42.ai/v1/models。找到授权的 model id，再提交最小请求；目录读取不生成内容。
查看清晰原图模型授权与 IP 白名单
查看清晰原图| 设置 | 作用 | 配置建议 |
|---|---|---|
| allowed_models | 指定模型白名单 | 只勾选该应用需要的模型；目录和调用都会检查授权。 |
| allowed_model_groups | 按模型授权类别限制 | 与具体模型授权按实际保存配置生效；组织授权还会进一步限制成员。 |
| IP/CIDR | 限制请求来源 IP | 填写服务器公网出口 IP 或 CIDR，不是内网地址；代理后的出口需核对。 |
预算、速率与有效期
总消费上限控制该 Key 累计消费，日/月上限控制对应周期；是否留空、是否允许零值以当前表单说明为准，不把“0”一概解释成不限。RPM/TPM/并发限制分别约束请求速率、Token 速率和同时进行的请求。预算不是钱包充值，也不会更改模型价格或用户折扣。
编辑、停用与泄露处理
先停用泄露密钥
发现泄露时立即停用或撤销，检查最近用量和账单；只删除自己程序里的字符串不会停止别人调用。
创建替代密钥并迁移
新 Key 使用必要的最小授权。更新服务端配置并验证后再撤销旧 Key；不要把旧值或新值贴给客服。
常见问题与排查
| 现象 | 先检查什么 | 如何处理 |
|---|---|---|
| 401 | Key 是否完整、有效且未停用 | 检查鉴权头，不用浏览器会话代替 API Key。 |
| 403 / ip_not_allowed | 当前出口 IP 是否在白名单 | 核对代理/云服务器的公网出口 IP。 |
| model_not_allowed | Key 和组织模型范围 | 核对准确 model id 与授权，不改展示名称绕过。 |
| 429 / budget limit | RPM/TPM/并发或消费上限 | 查看错误码与 Retry-After，调整自己的限制或稍后查询。 |