Skip to main content

认证

API Key 获取与使用方式

记忆库 API 采用 API Key 鉴权。请求通过 Authorization Header 携带 API Key。

获取凭证

1

进入控制台

打开阿里云百炼控制台，使用阿里云账号登录。
2

获取 API Key

在控制台获取 DASHSCOPE_API_KEY，以 sk- 开头。详见获取 API Key。
API Key 具有账号级权限，请妥善保管，不要在公开渠道分享或提交到代码仓库。
3

获取业务空间 ID

在业务空间管理页面复制业务空间 ID（格式如 llm-xxxxxxxxxxxx），详见获取 Workspace ID。请求地址中的 {workspaceId} 需替换为该 ID，且 API Key 须属于同一业务空间。

使用方式

将 API Key 配置到环境变量： 
export DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxxxx"
每个请求携带 Authorization Header： 
curl https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v2/apps/memory/add \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json"

权限说明

  • 阿里云主账号：可直接调用所有接口
  • RAM 子账号：需获得相应权限授权后调用
  • API Key 的权限范围由控制台配置

安全建议

  • 不入代码仓库：使用环境变量存储 API Key
  • 按应用拆分：每个应用使用独立的 API Key，便于追踪和撤销
  • 定期轮转：定期更换 API Key，降低泄露风险
准备好凭证后，查看 AddMemory 接口开始调用。