技能介绍

要解决的问题

调用 api.venice.ai 时，最常见的两类失败都和鉴权有关：一是请求头格式不对，直接返回 401 Authentication failed；二是在「账户密钥」和「钱包签名」之间选错了方案，导致后续的计费、权限、对账都跑不通。Venice 的 OpenAPI 规范声明了两种对等的鉴权方案——BearerAuth 与 siwx，这个技能的作用就是把这两条路径讲清楚，让你按部署形态选一条走。

两种方案如何工作

Option A：Bearer API 密钥

密钥在 Venice 后台或通过 venice-api-keys 创建，分 ADMIN 与 INFERENCE 两类，只有 ADMIN 密钥具备管理其他密钥的权限。
每把密钥可挂消费限额：USD 上限和/或 DIEM 上限，触顶即停。
计费按顺序扣减：DIEM（质押）→ USD 余额 → 捆绑额度。
适合有 Venice 账户、需要用量分析（/billing/usage-analytics）、要签发受限子密钥、或需要 DIEM/捆绑额度优先扣的场景。

Option B：x402 钱包签名（SIWE）

直接用以太坊钱包签名，无需注册账户。
按次付费，使用 Base 链（chain ID 8453）上的 USDC，余额挂在钱包地址下，自动扣减。
适合 agent 或无账户的轻量流程。

适用边界与注意点

如果不使用 SDK 而手写 SIWE 签名，需要按 EIP-4361 组装 message 字段并放进正确的请求头位置。技能文档给出了字段表，但具体取值仍需分步确认，别凭印象拼。
两种方案是「二选一」的关系，不存在叠加，不要同时塞两套认证头。
INFERENCE 密钥到不了管理类接口。撞 401 时的排查顺序：先核对 Authorization 头格式，再核对密钥类型，最后核对限额是否触顶。
x402 路径依赖 Base 链上的 USDC 余额，钱包余额不足就是硬失败，没有降级通道。