RAG API 认证方式-大模型服务平台百炼(Model Studio)-阿里云帮助中心

RAG API 的 API Key 获取、使用方式与安全建议。

RAG API 采用 API Key 鉴权。请求通过 Authorization Header 携带 API Key，业务空间由 Endpoint 中的 {workspace_id} 标识，格式为 https://{workspace_id}.cn-beijing.maas.aliyuncs.com/。

获取 API Key

打开百炼控制台，使用阿里云账号登录，进入 API Key 页面。
创建新的 API Key，或复制已有的 API Key。

警告API Key 具有账号级权限，请妥善保管，不要在公开渠道分享或提交到代码仓库。

使用方式

每个请求携带 Authorization Header 即可：

Authorization: Bearer <API-Key>

完整示例：

curl "$BASE_URL/api/v1/indices/rag/index/list?page_number=1&page_size=10" \
  -H "Authorization: Bearer $BAILIAN_API_KEY"

其中 $BASE_URL 为 https://{workspace_id}.cn-beijing.maas.aliyuncs.com，$BAILIAN_API_KEY 为您的 API Key。

权限说明

阿里云主账号：可直接调用所有接口。
RAM 子账号：需先获取 AliyunBailianDataFullAccess 权限并加入目标业务空间。
API Key 的权限范围由控制台配置。

安全建议

不入代码仓库：使用环境变量存储 API Key（如 BAILIAN_API_KEY）。
按应用拆分：每个应用使用独立的 API Key，便于追踪和撤销。
定期轮转：定期更换 API Key，降低泄露风险。