Skip to main content

Authentication

API Key acquisition and usage

Memory API uses API Key authentication. Pass the key via the Authorization header.

Get credentials

1

Open the console

Open the Bailian console and log in with your Alibaba Cloud account.
2

Get API Key

Obtain DASHSCOPE_API_KEY from the console, starting with sk-. See Get API Key.
API keys have account-level permissions. Store them securely and never commit to code repositories.
3

Get workspace ID

Copy your workspace ID (in the format llm-xxxxxxxxxxxx) from the Workspace Management page. See Obtain APP ID and Workspace ID. Replace {workspaceId} in the request URL with this ID, and use an API key that belongs to the same workspace.

Usage

Configure as an environment variable: 
export DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxxxx"
Each request carries the 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"

Permissions

  • Alibaba Cloud primary account: can call all endpoints directly
  • RAM sub-accounts: require appropriate permissions
  • API Key scope is configured in the console

Security best practices

  • Never in repos: use environment variables
  • Per-app keys: use separate keys for each app
  • Rotate regularly: change keys periodically
View AddMemory to start calling.