Capability Marketplace
安全与计费
了解能力价格、支付行为、可用状态和安全重试规则。
能力调用使用 Xenodia 统一的账号、余额和请求记录。调用前请从实时能力说明中确认价格与支持的支付关系。
支付方式
| 模式 | 含义 |
|---|---|
owner_only | 由主账户支付。 |
self_only | 由调用账户支付。 |
self_then_owner | 优先使用调用账户余额；策略允许时再使用主账户余额。 |
响应中的 billing 会说明实际付款方和最终金额。
价格单位
价格使用 micro USDC。10000 等于 0.01 USDC，1000000 等于 1 USDC。包含多个操作时，请在每次调用前读取 operations[].pricing.unit_price_micro_usdc。
资金与失败
| 情况 | 资金处理 |
|---|---|
| 调用前操作已不可用 | 不会锁定资金。 |
| 已受理请求未能完成 | 临时预留会被释放，或根据返回的计费状态进入核对。 |
| 付费调用成功 | 最终金额会显示在计费摘要中。 |
| 使用相同请求 key 和相同内容重放 | 返回已保存结果，不会对同一意图重复收费。 |
安全重试
付费和异步操作需要发送 Idempotency-Key。只有重试同一笔逻辑请求且请求内容相同时，才复用同一个 key；新的用户意图必须使用新 key。内容冲突时返回 409 idempotency_conflict。
可用状态
| 状态 | 含义 |
|---|---|
active | 当前可以调用。 |
unavailable | Xenodia 当前不接收该操作的新请求，请按公开提示和重试建议处理。 |
从查看目录到实际调用之间，可用状态可能变化。请始终处理调用响应并保留 request_id。
建议保留的信息
对于付费或重要调用，请保留请求编号、能力 slug、操作、版本、计费状态、最终金额，以及解释该请求所需的输入摘要。