账号
这些接口服务于控制台的账号菜单、设置 和 积分与用量,只接受浏览器会话。路径相对于你所在站点的控制台地址。
要在脚本里查看余额,请用 rcc credits status,见 Radeon Cloud CLI。
获取个人资料
Section titled “获取个人资料”
GET
/api/me
会话
{ "id": 1042, "email": "you@example.com", "credits": 24, "verified": true, "is_editor": false, "provider": "email", "api_token": "rc-...", "ssh_public_key": "ssh-ed25519 AAAAC3Nz... laptop"}| 字段 | 说明 |
|---|---|
credits | 积分余额。 |
verified | 账号是否已通过审核。审核中的账号不能启动实例,也拿不到 API Key。 |
is_editor | 是否可以公开发布模板。 |
provider | 账号的登录方式。 |
api_token | 你的 API Key。 |
ssh_public_key | 你的 SSH 公钥,每行一个;没有时为空。 |
列出可用资源
Section titled “列出可用资源”
GET
/api/me/resource-labels
会话
返回分配给你账号的资源池("category": "resource-pool")和规格("category": "resource-template"),也就是 首页 上 规格 和 资源池 的选项,见选择资源。
出现在列表里表示你可以在上面启动,不代表此刻有空闲的 GPU。
SSH 密钥
Section titled “SSH 密钥”每个账号最多保存 10 个 SSH 公钥。每个公钥都可以连接添加之后启动的实例。
| 方法 | 路径 | 作用 |
|---|---|---|
GET | /api/profile/ssh-keys | 列出你的公钥。 |
POST | /api/profile/ssh-keys | 添加一个公钥。 |
DELETE | /api/profile/ssh-keys/{id} | 删除一个公钥,id 来自列表。 |
添加时发送标题和公钥:
{ "title": "Laptop", "key": "ssh-ed25519 AAAAC3Nz..." }列表返回每个公钥的 id、title、type 和 fingerprint,不返回公钥本身。指纹格式是 SHA256:...,和 ssh-keygen -lf ~/.ssh/id_ed25519.pub 的输出一致。
添加账号里已有的公钥返回 409,不是 OpenSSH 公钥的内容返回 400。
经典版界面使用的 POST /api/profile/ssh-key(单数)会用你发送的内容替换全部公钥,每行一个。
POST
/api/profile/redeem
会话
| 字段 | 类型 | 说明 | |
|---|---|---|---|
code | string | 必填 | 完整的优惠码。 |
{ "credits_added": 50, "credits": 74 }400 表示优惠码无效、已经用过,或者是发给其他账号的。503 表示兑换功能暂时关闭。
经典版界面调用的是 POST /api/credits/redeem,优惠码放在 coupon 字段里,效果相同。
API Key
Section titled “API Key”API Key 在 Token Factory 查看。重新生成目前仍要切换到经典版界面,见轮换 API Key。
Token Factory 用量
Section titled “Token Factory 用量”Token Factory 的用量和积分分开统计,见用量和配额。