Bambuk 四类模型 API
多语言翻译
一个接口，通过语言参数完成中文、维吾尔语、哈萨克语、藏语和蒙古语文本翻译。
通过同一个接口提交文本数组，使用 source_lang 和 target_lang 指定语言方向。各语言共用请求结构和响应格式，可用语言对以实际部署模型为准。
请求
POST /api/v1/ai/bambuk/nmt
Content-Type: application/json
AppKey: <BAMBUK_APP_KEY>请求地址由平台域名和上述路径组成。AppKey 从开发者控制台获取，授权范围与可用额度以控制台为准。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| text | string[] | 是 | 待翻译文本数组，至少一条非空文本 |
| source_lang | string | 是 | 源语言代码，见下表 |
| target_lang | string | 是 | 目标语言代码，见下表 |
语言代码
| 语言 | 代码 | 从中文翻译的参数 |
|---|---|---|
| 中文 | zh | target_lang: "zh" |
| 维吾尔语 | ug | source_lang: "zh", target_lang: "ug" |
| 哈萨克语 | kk | source_lang: "zh", target_lang: "kk" |
| 藏语 | bo | source_lang: "zh", target_lang: "bo" |
| 蒙古语 | mn | source_lang: "zh", target_lang: "mn" |
切换语言只需修改参数，无需更换接口或购买语言专属接口密钥。不使用 direction 参数，也不将哈萨克语代码映射成 ha。批量与文本长度限制以模型和套餐为准。
调用示例
以下示例在服务端运行。将 BAMBUK_BASE_URL 设置为平台地址（包含 /api/v1，无末尾斜杠），将 BAMBUK_APP_KEY 设置为控制台主密钥。
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"}'成功响应
以下为结构示例，译文由实际部署模型生成。
{
"data": {
"result": {
"translations": ["模型生成的译文"]
}
}
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| data | object | 平台响应数据 |
| data.result | object | 模型返回的翻译结果 |
| data.result.translations | string[] | 译文数组，应按数组读取 |
计费与额度
调用消耗机器翻译接口对应的套餐额度。按次或按 token 的计费方式、有效期和单请求上限以已购买套餐为准；不同语言的翻译均从同一入口发起。查看计费与配额和调用记录。
错误处理
| 情况 | 处理建议 |
|---|---|
| 认证失败 | 检查密钥是否正确、有效，参见鉴权说明 |
| 无有效额度 | 检查套餐有效期和机器翻译剩余额度 |
| 参数或语言对不支持 | 检查数组结构、语言代码与模型部署能力 |
| 请求限流 | 降低并发，等待后重试 |
| 模型超时 | 先检查调用记录再决定是否重试，避免重复调用 |
完整错误格式请参阅错误处理。