用途:帮助把 Credyt 计费系统接入用户的实际代码库,在合适位置添加客户创建、用量事件、余额检查、成本记录和计费门户等集成。使用前需先运行 billing-setup 技能。
主要能力:1) API 密钥配置,密钥仅存服务端,环境变量 CREDYT_API_KEY;2) 客户创建,用 external_id 关联应用用户 ID,处理已存在(409/422)情况;3) 用量事件跟踪,事件需唯一 UUID、event_type、occurred_at 及定价所需字段;4) 成本跟踪,在用量事件中附带 costs 数组(供应商 ID、金额、币种);5) 余额检查,在昂贵操作前查询钱包余额;6) 计费门户/充值 UI,创建门户会话并跳转;7) 余额展示。
使用方式:优先官方 SDK,TypeScript 用 npm install @credyt/api-client,Python 用 pip install credyt-api;其他语言可用 HTTP 直连并携带 X-CREDYT-API-KEY 头。字段命名 API 用 snake_case,TS SDK 自动转 camelCase,Python SDK 保持 snake_case。若产品含周期性固定费用,订阅可能返回 pending,需设置 return_url、failure_url、redirect_to,并监听 subscription.activated webhook 后再激活账户。
适用场景:需要为应用接入按用量计费、余额与充值流程的开发者。
限制:资料未提供具体价格、收费模式或效果数据;集成细节以官方文档 docs.credyt.ai 为准。