1.1 API-key是什么

API Key（应用程序接口密钥）是一串用于身份验证的字符串，用来让系统识别“你是谁”，并确定你是否有权限访问某项服务。简单来说，它就像你访问服务的“通行证”。

1.1.1 为什么需要 API-Key

• 身份验证：服务需要确认访问者是合法用户。
• 权限控制：不同的 API Key 可以对应不同权限，例如只读、读写、管理等。
• 流量计费与监控：通过 API Key 可以统计调用次数、用量并计算费用。
• 安全性：避免任何人都能随意调用接口造成滥用或资源消耗。

1.1.2 API-Key 的常见用途

• 访问云平台的模型推理服务（如 AI 大模型、OCR、语音等）
• 使用第三方数据接口（天气、支付、地图、短信平台）
• 调用内部微服务或私有 API
• 自动化脚本、CI/CD、后端服务之间的相互调用

中转API网址：https://api.aigc369.com/

1.2 获取 API-key

1.2.1 充值额度

注册登录后，点击钱包管理

充值额度

1.2.2 新建密钥

（1）充值后，点击令牌管理

（2）点击添加令牌

（3）配置密钥基本信息

另外可以选择，限制使用哪些模型、IP白名单等。

刚开始可以只写个名称，其他都默认即可。

提交后，就会生成一个密钥信息，点击复制，就拿到密钥了，即API-key

官方请求示例：

1 curl <https://api.aigc369.com/v1/chat/completions> \\
2   -H 'Content-Type: application/json' \\
3   -H 'Authorization: Bearer YOUR_API_KEY' \\
4   -d '{
5   "model": "gpt-4o",
6   "messages": [{"role": "user", "content": "Say this is a test!"}],
7   "temperature": 0.7
8 }'

下面我们将在代码中调用模型使用。

1.3 环境配置密钥

不要将API-key写到代码中，有泄露风险，最好写到环境变量中。

• 配置步骤：设置-系统-系统信息-高级系统设置-环境变量-系统变量-新建（两个）

（1）配置请求地址

（2）配置请求密钥

将上方复制的密钥粘贴到此处。

添加完成后如下图

配置完成后就无需将密钥写到代码中泄露了。

注：千万别泄露自己密钥，上图中密钥已失效。

1.4 API Key 使用注意事项

• 不要把 API Key 写入公开仓库（如 GitHub）
• 不要在前端网页中暴露真实 Key
• 定期更换 Key，降低安全风险
• 如果 Key 泄露，立即禁用并生成新的
• 对不同项目/环境使用不同 Key，便于管理和撤销