平台文档
从企业开通、模型路由到用量对账,了解如何管理 Token Pyxis 上的企业智能体工作流。
企业开通与部门
签署企业服务合同后,由 Token Pyxis 的授权人员开通企业工作区。获授权的企业管理员在「成员管理」中为本企业人员创建账号,控制台按角色和部门授予访问权限。
企业是结算与权限边界。可按团队或项目设立部门,分配成员、调用密钥和预算。
- 企业管理员
- 按授权范围维护成员、部门和预算,签发项目 API Key 并查看用量。
- 部门成员
- 按角色查看密钥和用量。具备签发权限的部门账号新建密钥时,密钥自动归属本部门。
- 采购与财务
- 由有权限的企业账号核对钱包、订阅和交易记录,提交或撤回符合条件的发票申请。
密钥与权限
- 由有权限的企业管理员在「API Keys」中按环境和应用签发密钥。创建时保存明文,并配置模型白名单、预算、限流、有效期以及适用的来源 IP。
- 轮换时先创建新密钥,用目标模型验证部署,再禁用旧密钥。密钥泄露时立即禁用并核对该密钥的历史请求。
- 模型请求使用 API Key,管理接口使用登录 JWT。企业、部门、套餐和密钥的可用模型范围会参与校验。
模型选路
企业请求先确定模型与接口能力,再按企业分组、套餐和渠道配置选择能处理该请求的候选渠道。同一个 API Key 调用同一个模型时,平台优先复用仍可用的上次成功渠道。
符合切换条件的上游失败,可以在同一模型的候选渠道中尝试下一条。工作流需要降级到另一个模型时,请在应用中显式选择备用模型并核对其权限、能力和计费。流式已输出或异步任务已提交时,先确认原请求状态再重发。
核对模型能力和目录价限流、预算和套餐
限流用于控制请求速率和并发。RPM 是每分钟请求数,TPM 是每分钟词元数。配置额外预算可限制消费,企业与部门的预算和 API Key 配额会共同影响调用是否可用。
在「模型与价格」核对企业生效价,在「订阅」检查套餐覆盖范围,在「钱包」确认余额与流水。适用的订阅额度优先覆盖相应请求,超出部分按已签署的企业合同结算。按量接口可能按张、秒或次计费。
查看词元计费规则和算例用量与对账
- 保存响应头
x-request-id,并记录调用时间、环境和模型 ID。 - 按请求 ID 查「请求日志」。在详情中核对状态、词元和缓存,并分别查看套餐抵扣前的用量计价和钱包实扣。
- 在「用量报表」按模型或部门统计并导出 CSV。对账时用请求 ID 匹配钱包的关联单号,另外核对订阅扣款。
排查与合规
出现 401 时核对当前端点要求的凭证,出现 402 时核对钱包与额度,出现 429 时按 Retry-After(如有)退避。联系企业管理员时提供请求编号和时间,避免转发密钥或完整请求正文。
调用日志与请求正文捕获分别管理。正文捕获默认关闭,具体数据处理和面向最终用户的内容标识要求见安全及合规页面。
