跳转到正文
Bambuk / 开发文档

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 生命周期

  1. 登录开发者控制台,进入“API 密钥”。
  2. 首次生成时复制明文 AppKey;平台不会再次显示完整密钥。
  3. 发现泄露时立即撤销并轮换密钥。
  4. 轮换后更新服务端环境变量并重新部署。

常见错误

状态原因处理
401AppKey 缺失、错误或已撤销检查请求头和控制台密钥
403账号、实名认证、套餐或接口额度不满足前往控制台完善认证或购买套餐
429超过套餐限流降低并发并按响应提示重试
502 / 503 / 504平台网关或模型服务暂时不可用检查请求是否已执行,避免自动重复调用

模型签名由平台服务端完成,开发者无需计算 HMAC,也无需了解任何上游配置。更多内容参见计费与配额和错误处理。