项目级 Key 接入指南：把大模型能力装进你的软件

发布于 2026-09-25

为什么需要项目级 Key

如果你的软件需要内置大模型能力（写作助手、数据分析、数字人……），直接把平台 API Key 打进安装包等于把钱包交给所有用户。项目级 Key 平台解决三件事：

1. 一个客户一个 Key：客户端只持有自己的受限 Key，泄露影响面可控，可随时吊销；

2. 项目统一钱包：项目方在平台充值，客户调用按统一倍率从项目钱包扣费，余额不足自动断流，充值自动恢复；

3. 用量透明：按客户、模型、日的用量与费用明细，项目方可随时拉取对账。

接入三步

1. 平台管理员为你的项目建档，交付 projectcode 与 projectsecret；

2. 你的后端实现「客户激活」接口：首次运行时调用平台造 Key 接口，把客户 Key 下发给客户端；

3. 客户端以 OpenAI 兼容协议调用，baseurl 指向平台 /v1，apikey 用自己的客户 Key。

安全铁律

projectsecret 只存在你的后端环境变量，绝不进客户端安装包；

客户端只保存自己的客户 Key；

客户的付费关系在你（项目方），平台只对项目钱包计费。

完整接口参数与示例代码见平台「技术交流」后续文章与接入示例包。