技能介绍

要解决的问题

在集成 Venice API 时，通常会为不同客户端或环境签发各自的 Bearer token。随着调用方增多，这些密钥的创建、失效与审计会变得混乱：过期密钥散落在各服务里、忘记撤销离职同事的凭证、或者无法确认某个密钥究竟归属哪个上游 session。Venice API Keys 这类管理端点的价值，就是把密钥生命周期收拢到一处统一操作，而不是在业务代码里散落 Authorization 头。

核心能力与工作方式

该技能提供的是面向管理员的端点集合，专门处理 Venice API 的 Bearer 密钥管理。调用这些端点本身有前置条件：请求方需要持有有效的 ADMIN 密钥，或者基于某个父会话（parent session）发起调用。也就是说，它不是给终端用户随意调用的公共接口，而是嵌在运维或后台工具链里的管理入口。

典型使用流程大致如下：

用 ADMIN 密钥完成身份校验，再请求创建新的子密钥
将子密钥下发给具体的客户端或服务实例
在密钥泄露或调用方下线时，通过同一端点进行撤销或轮换

这类设计把「谁有权签发」与「谁有权使用」分开，避免把高权限凭证直接暴露给业务层。

适用边界与注意点

如果你的场景只使用钱包认证（wallet-only auth），不应调用此管理端点，而应改用 venice-auth 或 venice-x402。这两个替代方案面向的是纯钱包签名流程，与基于 Bearer token 的管理逻辑是两套体系。
ADMIN 密钥等同于管理权限的根凭证，务必像对待生产环境主密钥一样保护它，避免写入前端代码或公开仓库。
具体端点路径、请求参数与响应结构以 Venice API 官方文档为准，技能本身不改变底层 API 的行为，只是把这些管理操作整理成 Agent 可直接调用的形式。