认证

AMD Radeon Cloud 有三种凭证，调用不同的接口要用不同的凭证。

凭证	格式	用途
API Key	`rc-` 加 48 位十六进制字符	Token Factory
CLI 令牌	`rcc_...`	Radeon Cloud CLI：实例、积分、可用资源
会话 Cookie	登录控制台时设置	控制台和平台接口

要在脚本里管理实例，请用 CLI。平台接口是给控制台用的，只接受浏览器会话。

API Key

API Key 的格式如下：

rc-4f8a19c7e02b6d3a5c81f70e9b2d4a6c38e5b1907f2c4d8a

以 Bearer 令牌的方式发送：

curl https://developer.amd.com.cn/radeon/api/v1/models \
  -H "Authorization: Bearer $RADEON_API_KEY"

Token Factory 也接受放在 x-api-key 请求头里的 API Key，这是 Anthropic SDK 的认证方式。调用 /v1/messages 时，同时发送 anthropic-version：

curl https://developer.amd.com.cn/radeon/api/v1/messages \
  -H "x-api-key: $RADEON_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"DeepSeek-V4-Flash","max_tokens":256,"messages":[{"role":"user","content":"Hello"}]}'

两个请求头同时存在时，以 Authorization 为准。只有 Token Factory 读取 x-api-key。

获取 API Key

打开 Token Factory，顶部的 您的 API 密钥 卡片上就是你的 API Key，点复制。第一次打开 Token Factory 时会自动生成。

还在审核中的账号不会生成 API Key。如果看不到，请确认账号是否已通过审核。

实例上的模型服务有自己的 API Key，以 sk- 开头，显示在它的实例卡片上，见模型服务接口。

轮换 API Key

新版控制台暂时没有这个按钮。请切换到经典版界面（设置 → 界面 → 使用经典版），打开 Profile，点 Regenerate Key，见经典版界面。

旧的 API Key 立即失效，请同时更新所有用到它的客户端。

API Key 可能泄露时，请立即轮换。

CLI 令牌

rcc auth login 通过浏览器让 CLI 登录，并保存一个以 rcc_ 开头的令牌。它用来管理账号和实例，不能调用 Token Factory。见登录与账号。

登录控制台后会设置会话 Cookie。没有用密码换取会话的接口，所以脚本无法获得会话。

退出登录、身份提供方的登录过期，或者管理员撤销时，会话失效。

各接口接受的凭证

接口	API Key	CLI 令牌	会话
Token Factory（`/api/v1/...`）	是	否	仅列出模型
实例上的模型服务（`/inference/...`）	卡片上的 `sk-` Key	否	否
CLI 接口（`/api/cli/...`）	否	是	否
平台接口：实例、模板、账号	否	否	是
浏览公开模板（`GET /api/templates`）	可选	否	可选
JupyterLab 等应用（`/instances/...`）	否	否	是

模型服务只接受它自己卡片上显示的 API Key。

认证错误

401 表示凭证缺失、格式错误或无法识别。把 API Key 发给平台接口也会返回 401，内容是 Login required。

403 且 "code": "account_not_verified"，表示已经登录，但账号还在审核中。响应里的 redirect 指向审核页面。

访问实例路径时返回 403，表示这个实例不属于你。

完整列表见错误。