Credyt
综合介绍
Credyt 是一套专门为 AI 产品打造的计费基础设施。它做的事情很明确：帮 AI 产品记录每一次用量、按用量算钱、让用户充值，然后把账单理清楚。
很多 AI 产品不是按“包月”来收费的，而是按“用了多少”来收费。比如调用一次大模型接口、处理一张图片、生成一段语音，这些都是用量。但用量怎么记、价格怎么算、用户的钱怎么扣，自己做起来很麻烦。Credyt 就是把这一整套流程打包好，让 AI 产品直接接入使用。
这套系统包含三个核心模块：实时计量、按用量计费、钱包充值。实时计量负责统计每一次 API 调用；计费引擎按照你设定的价格规则计算费用；钱包系统则处理余额充值、扣费、账单查询这些财务操作。三者配合，形成一个完整的计费闭环。
对开发者来说，Credyt 的价值在于省事。不需要自己从零搭建计量和计费系统，只需要接入 SDK 或调用 API，就能获得一套能用的计费能力。这意味着你可以把精力放在产品本身，而不是花几个月去折腾计费逻辑。
功能列表
- 实时用量计量：自动记录每一次 API 调用的时间、模型类型、Token 数量、处理时长等数据，支持毫秒级延迟的用量统计。
- 灵活计费规则：支持按 Token 数、按请求次数、按时长、按数据量等多种计费维度，可针对不同模型或功能设置不同单价。
- 钱包与充值：每个用户拥有独立钱包，支持在线充值、余额查询、自动扣费，可设置余额不足提醒。
- 实时扣费：每次用量发生后立即计算费用并从钱包余额中扣除，避免月底统一结算带来的纠纷。
- 用量明细查询：提供详细的调用记录和费用明细，支持按时间、模型、用户等多维度筛选。
- API 接入：提供 REST API 和多种语言 SDK，方便开发者快速集成到现有系统中。
- 用量告警：可设置单次调用费用上限和每日消费上限，超额时自动阻断并通知用户。
- 账单与报表：自动生成日账单、月账单，支持导出 CSV 格式，方便财务对账。
- 多租户支持：一个账号下可创建多个子项目或子用户，适合团队协作和分部门核算。
- 预扣费与后扣费：支持调用前预扣预估费用，调用结束后按实际用量多退少补，也支持先用量后结算。
使用帮助
第一步：创建账号与项目
访问 Credyt 官网，注册一个账号。注册完成后，进入控制台，点击“创建项目”。项目是计量和计费的基本单位，一个项目对应一个 AI 产品。
创建项目时，需要填写项目名称、选择计费币种（如美元或人民币），并设置默认的计费模型。这些信息后续可以在项目设置中修改。
第二步：获取 API Key
在项目详情页，找到“API 密钥”选项卡，点击“生成新密钥”。系统会生成一串以 cred_ 开头的密钥字符串。
需要注意：API Key 只在生成时完整显示一次，之后无法再次查看。你需要把它保存在安全的地方。如果丢失，可以作废旧密钥并重新生成。
API Key 用于在调用 Credyt 的计量和计费接口时进行身份验证。请勿将密钥暴露在客户端代码或公开仓库中。
第三步：接入计量 SDK
Credyt 提供 Python、Node.js、Go 等语言的 SDK。以 Python 为例，安装方式如下：
pip install credyt-sdk安装完成后，在代码中初始化客户端：
from credyt import CredytClient
client = CredytClient(api_key="你的API密钥")接下来，在你的 AI 接口被调用时，插入计量上报代码。例如，在调用大模型 API 后，上报 Token 用量：
client.meter.report(
event_name="llm_call",
user_id="用户唯一标识",
properties={
"model": "gpt-4o",
"prompt_tokens": 350,
"completion_tokens": 120
}
)上报的 properties 字段会作为计费规则的匹配依据。比如，你可以设置“当 model 为 gpt-4o 时，每 1000 个 prompt token 收费 0.005 美元”。
第四步：配置计费规则
进入控制台的“计费规则”页面，点击“新建规则”。你需要设置以下内容：
- 规则名称：例如“GPT-4o 按 Token 计费”。
- 匹配条件：选择用量的匹配字段，比如
model = gpt-4o。 - 计费维度：选择按什么计费，可选 Token、请求次数、时长等。
- 价格公式：设定单价，例如“每 1000 Token 收费 0.01 美元”。
你可以创建多条规则，Credyt 会按照优先级从高到低匹配。如果某次用量没有匹配到任何规则，默认不计费，但你会在日志中看到未匹配的记录。
第五步：开通钱包与充值
在“钱包管理”页面，你可以为项目开通钱包功能。每个用户（以 user_id 区分）会自动拥有一个独立钱包。
充值方式有两种：
- 用户自助充值：通过 Credyt 提供的充值页面或 API，用户可以使用支付宝、微信支付或 Stripe 完成充值。
- 管理员手动充值：在控制台的钱包列表中，找到指定用户，点击“调整余额”，直接增加或扣减余额。这种方式适合内部测试或赠送额度。
充值成功后，余额实时到账，用户可以立即使用。
第六步：查看用量与账单
控制台的“用量明细”页面会展示每一次计量的详细记录，包括时间、用户、模型、Token 数、费用金额。你可以按日期范围、用户 ID 或事件名称进行筛选。
“账单”页面自动汇总每日和每月的费用，并显示每个用户的消费总额。点击“导出 CSV”可以下载账单数据，方便导入财务系统。
第七步：设置告警与限额
在“告警设置”中，你可以配置两类规则：
- 单次调用限额：例如设置单次调用费用上限为 5 美元，超过则直接拒绝该次调用。
- 每日消费上限：例如设置用户每日最多消费 100 美元，超出后暂停该用户的调用权限。
当触发告警时，Credyt 会通过邮件或 Webhook 通知你。你也可以在代码中监听告警回调，实现自动处理。
第八步：对接现有系统
如果你不想使用 SDK，Credyt 也提供完整的 REST API。所有接口都支持 GET 和 POST 请求，请求和响应均使用 JSON 格式。
接口文档中详细列出了每个端点的参数和示例，包括：
- 上报计量：
POST /v1/meter - 查询余额：
GET /v1/wallet/balance - 发起充值：
POST /v1/wallet/recharge - 查询账单：
GET /v1/billing/invoices
你可以在自己的后端服务中直接调用这些接口，将计费能力无缝集成到现有架构中。
产品特色
Credyt 是一套让 AI 产品直接接入就能用的实时计量与按量计费基础设施，省去自己搭建计费系统的全部麻烦。
适用人群
- AI 应用开发者：正在开发基于大模型或其他 AI 能力的应用，需要按用量向终端用户收费，但不想花大量时间从零构建计费系统。
- AI 创业团队：产品处于快速迭代期，需要灵活的计费方案来测试不同定价策略，Credyt 的规则配置可以随时调整，无需改代码。
- 企业 AI 平台部门：内部有多个业务线使用 AI 能力，需要统一计量和分摊成本，Credyt 的多项目和多用户支持可以满足分账需求。
- 独立开发者：个人开发 AI 工具或服务，希望以低成本获得专业级计费能力，只需简单接入即可开始收费。
应用场景
- 大模型 API 转售：你代理了多家大模型 API，希望按用户的调用量收费。Credyt 可以按模型、按 Token 数精确计费，并让用户预充值后再使用。
- SaaS 产品的按量付费：你的 SaaS 产品中包含 AI 功能，希望采用“基础订阅 + 超出用量付费”的混合模式。Credyt 负责计量超额部分并自动扣费。
- AI Agent 平台：用户在你的平台上创建 AI Agent，每次 Agent 执行任务都会消耗 Token 或调用外部工具。Credyt 可以实时记录每次执行的成本，并向用户展示费用明细。
- 内部成本核算：公司内部多个部门共用一套 AI 服务，需要按部门统计使用量和费用。Credyt 的多用户体系可以为每个部门分配独立钱包和账单。
- 开发者工具插件：你开发了一款 IDE 插件或命令行工具，内置 AI 辅助功能，希望按使用次数收费。Credyt 的轻量接入方式适合这类场景。
常见问题
- Credyt 的计量准确吗？
Credyt 在服务端进行计量统计，不依赖客户端上报，因此不会出现漏记或重复计费的情况。每次 API 调用都会生成一条独立的计量记录，延迟在毫秒级别。
- 用户充值后，钱到哪里？
充值资金进入你在 Credyt 平台绑定的商户账户。Credyt 本身不沉淀资金，每笔充值都会在几分钟内结算到你的银行账户或 Stripe 账户。
- 计费规则可以随时修改吗？
可以。计费规则的修改立即生效，但不会追溯修改之前已产生的用量。也就是说，修改规则只影响之后的新调用，历史账单保持不变。
- 支持哪些支付方式？
国内用户支持支付宝和微信支付，海外用户支持 Stripe 信用卡支付。具体支持的支付渠道取决于你所在的国家和地区。
- 如果用户余额不足怎么办？
你可以设置两种处理方式：一是直接拒绝调用并返回错误提示；二是允许调用但将费用记为欠款，在用户下次充值时自动扣除。你可以在控制台的“钱包设置”中切换模式。
- Credyt 会存储我的用户数据吗？
Credyt 只存储计量和计费所需的必要信息，包括用户 ID、调用时间、模型名称、Token 数量等，不会获取你的业务数据或对话内容。
- 接入 Credyt 需要多久？
如果使用官方 SDK，通常一个小时内可以完成基本接入。如果使用 REST API 自行对接，时间取决于你的开发效率，一般不超过一天。
