API Key 创建

创建一把独立、可识别、额度受控的访问凭证，并在完整密钥只显示一次时安全保存它。

API Key 就是控制台里的“令牌”。 文档采用 API Key 这一通用术语；在实际页面中，你会看到“令牌管理”“新建令牌”等名称，它们指的是同一类访问凭证。

创建一把可用的 Key

进入个人中心，打开“令牌管理”，点击“新建”。如果是第一次创建，先确定这把 Key 将用于本地开发、测试联调还是生产服务。

名称应能直接说明用途，建议采用“应用 + 环境”的格式，例如：


web-prod
mobile-staging
desktop-client-personal

避免长期使用默认名称。名称清晰时，后续查看消耗、禁用凭证和定位异常都会更快。

按用途选择过期时间，并给测试脚本、桌面客户端或第三方工具设置可控额度。没有明确批量用途时，一次创建一把即可。

提交后，系统会在“保存你的密钥”窗口中展示令牌名称、完整密钥和复制按钮。

完整密钥通常只展示一次。 请立即复制到可信的密码管理器或密钥库。之后列表页显示的前缀或摘要只能用于识别，不能用于 API 鉴权。

字段	推荐设置	说明
令牌名称	按应用和环境命名	例如 `web-prod`，便于识别、统计和停用。
过期时间	测试用短有效期，生产按安全策略设置	支持永不过期、一个月、一天、一小时和自定义时间。
新建数量	默认 `1`	仅在设备、成员或实例需要独立凭证时批量创建。
总额度限制	测试和外部工具优先设置上限	单 Key 额度与账户总额度同时生效，任一耗尽都会限制调用。

一个简单原则： 生命周期越短、运行环境越不可控，Key 的有效期和额度就应越严格。

不要把完整密钥提交到代码仓库，也不要放进前端代码、群聊、普通文档或工单截图。

配置	示例	用途
Base URL	`https://api.ggpu.ai`	GGPU API 的统一入口。
API Key	`<你的完整 API Key>`	通过 `Authorization: Bearer ...` 完成鉴权。
模型名称	`<你的模型名称>`	指定本次请求使用的可用模型。

只有完整 API Key 可以用于鉴权。模型名称也必须与你的账号当前可用范围一致。