AppKey 鉴权
用户只需一个开发者 AppKey,平台内部完成身份、套餐、额度和模型签名处理。
用户侧唯一凭证
开发者在控制台生成一个 AppKey,请求所有 Bambuk 模型接口时使用同一个密钥:
AppKey: YOUR_DEVELOPER_APP_KEY平台会根据 AppKey 自动识别开发者,检查账号状态、实名认证、套餐有效期、接口额度和限流策略。上游地址、上游密钥和模型签名算法不会暴露给用户。
请求示例
curl --fail-with-body "$BAMBUK_BASE_URL/ai/bambuk/nmt" \
-H "AppKey: $BAMBUK_APP_KEY" \
-H 'Content-Type: application/json' \
-d '{"text":["你好"],"source_lang":"zh","target_lang":"ug"}'平台只接受 AppKey 请求头,不兼容其他密钥请求头。AppKey 必须保存在自己的服务端环境变量中,不能写入浏览器、移动端、Git 或日志。
AppKey 生命周期
- 登录开发者控制台,进入“API 密钥”。
- 首次生成时复制明文 AppKey;平台不会再次显示完整密钥。
- 发现泄露时立即撤销并轮换密钥。
- 轮换后更新服务端环境变量并重新部署。
常见错误
| 状态 | 原因 | 处理 |
|---|---|---|
| 401 | AppKey 缺失、错误或已撤销 | 检查请求头和控制台密钥 |
| 403 | 账号、实名认证、套餐或接口额度不满足 | 前往控制台完善认证或购买套餐 |
| 429 | 超过套餐限流 | 降低并发并按响应提示重试 |
| 502 / 503 / 504 | 平台网关或模型服务暂时不可用 | 检查请求是否已执行,避免自动重复调用 |