快速开始

1. 准备应用和额度Copy Anchor Link

登录开发者控制台，完成手机号和实名认证，选择套餐并生成开发者 AppKey。确认应用、AppKey 和订阅均处于有效状态。

AppKey 是接口级凭证。调用另一个接口前，确认该接口也获得授权；不要把应用 ID 或 Secret 当作 AppKey。

2. 设置请求地址Copy Anchor Link

示例中的地址包含 /api/v1，末尾不要重复添加这一段。

export BAMBUK_BASE_URL="https://你的平台域名/api/v1"
export BAMBUK_APP_KEY="你的平台接口密钥"

环境变量仅在你自己的服务端设置。不要将真实密钥写入文档、Git、浏览器代码或公开日志。

3. 发送请求Copy Anchor Link

curl --fail-with-body --max-time 300 \
  "$BAMBUK_BASE_URL/ai/bambuk/nmt" \
  -H "AppKey: $BAMBUK_APP_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"text":["你好"],"source_lang":"zh","target_lang":"ug"}'

4. 读取响应Copy Anchor Link

{
  "data": {
    "result": {
      "translations": ["模型生成的译文"]
    }
  }
}

响应还可能包含用量、剩余额度等元数据。translations 是数组；不要将整份 JSON 当成单个翻译字符串。

常见阻碍Copy Anchor Link

• 401：确认 AppKey 正确，或者平台 Token 尚未过期。
• 403：检查应用状态、套餐有效期和剩余额度。
• 404：检查完整路径，以及模型接口是否已经启用。
• 429：降低并发，按限流规则等待后重试。
• 超时：模型可能已执行。先核对使用记录，不要立即重复提交。

详见错误处理和计费与配额。