场景化操作指引

按“我要做什么”找接口，每个步骤直达在线调试页对应接口。

对接入门：第一次调用

第三方第一次调网关：取公钥 → 加密登录 → 拿到 x-token → 调业务接口。

1. 取登录加密公钥（无需鉴权） — GET /v1/user/login-public-key（获取登录密码加密公钥）
2. 用公钥 RSA-OAEP-256 加密密码后登录，拿到 token.token（⚠️ 登录走 BFF 路由 POST /camp/bff/org/user/login，不是 proto 的 /v1/user/login，后者经网关会被 500015 拦截） — POST /v1/user/login（验证登录）
3. 带 x-token 查询自己的聚合信息，验证 token 有效 — GET /v1/user/info（获取单个用户聚合信息）
4. token 快过期时刷新 — GET /v1/user/refresh-token（刷新token）

为新团队开通算力

建工作空间 → 建项目 → 加人 → 配 GPU 配额，新团队即可使用。

1. 新增工作空间 — POST /v1/workspace/create（新增工作空间）
2. 在空间下新增项目 — POST /v1/project/create（新增项目）
3. 把成员批量加入工作空间 — POST /v1/workspace/add/users（批量添加工作空间用户）
4. 给项目添加 GPU 配额 — POST /v1/quota/gpu/add（添加/编辑项目gpu配额）

从模型上线推理服务

选模型 → 创建推理服务 → 查看服务状态。

1. 浏览可选模型 — POST /v1/model/search（获取模型列表）
2. 新增推理服务 — POST /v1/inference（新增推理服务）
3. 查看推理服务详情 — GET /v1/inference/detail（获取推理服务）

提交分布式训练任务

选规格 → 准备数据集 → 提交任务 → 跟踪状态。

1. 搜索可用算力规格 — POST /v1/flavor/search-available（搜索可用规格（融合资源池过滤+配额调度检查））
2. 搜索数据集 — POST /v1/dataset/search（搜索数据集列表）
3. 新增训练任务 — POST /v1/training-job（新增训练任务）
4. 查看训练任务详情 — GET /v1/training-job/detail（获取训练任务）

费用对账

查计量流水 → 查模型计费 → 查子账户额度。

1. 列出计费计量流水 — POST /v1/bill-record/search（列出计费计量）
2. 获取模型计费信息 — POST /v1/model-billing/list（获取计量信息）
3. 批量查询子账户额度 — POST /v1/wallet/sub-account/batch-quota（批量查询子账户当前额度）