这是什么
Clean APIs 是一个聚合模型 API:一个接口、一个 Key,调 33 个模型。它的套餐设计有个少见的规矩——所有套餐(含免费档)模型和功能完全一样,流式、工具调用、视觉、推理全开,付费与免费的差别只有每月 Token 量和限速,不拿模型阵容卡人。
免费档的数字很实在:每月 0.5M(50 万)Token,永久免费,不绑卡。Token 按输入+输出合并计,每月重置。50 万 Token 不算多,但拿来跑日常摘要、分类、小脚本的模型调用,或者把 33 个模型挨个试一遍选型,足够了。
还有一个对用户友好的设计:免费额度用完后,请求会改走账户余额按模型单价扣费;余额为空时直接返回 402 报错,不会先欠着再出账单。也就是说不充值就永远不会被扣钱,最多是用不了。
怎么申请
- 注册免费账号。 打开 cleanapis.com,点 Start free 注册。准备一个邮箱即可,不绑卡。正常几分钟完成。卡住常见原因:验证邮件延迟或进垃圾箱,先等几分钟并翻垃圾箱。
- 确认套餐是 Free。 登录控制台看当前套餐,免费账号默认就是 Free 档:每月 0.5M Token。控制台里能看到本月已用量,养成先看余量再跑大任务的习惯。
- 创建 API Key。 在控制台生成 Key,创建时完整保存。所有模型共用这一个 Key,不用按模型分别申请。
- 按官方文档接端点。 接口是 OpenAI 兼容格式,把 base_url 换成官方文档给的端点、key 填上一步的 Key 即可。先用一个小请求验通,再把正式任务接上去。
拿到后怎么用
- 选型是它的最大价值。 33 个模型同价同权,先拿同一个任务把候选模型都跑一遍,对比效果和 Token 消耗,再定主力模型,比逐家注册试用省事得多。
- 注意 Token 是输入输出合并计。 长文档摘要这类输入大的任务,50 万额度掉得比想象快;能截断上下文就截断,别整本书记塞进去。
- 超量逻辑要心里有数。 免费额度耗尽后请求会扣账户余额(按各模型公布的单价);没充值、余额为零时返回 402 停下,不会产生欠费。要长期跑量再考虑 $3.50/月的 Starter(50M Token)起步档。
额度
- 免费档:每月 0.5M(50 万)Token,输入与输出合并计,每月重置。
- 模型与功能:全部 33 个模型,流式、工具调用、视觉、推理全开,与付费档无差别。
- 限速:免费档套餐卡标注 60 次/分钟(官网对比表另标 80 次/分钟,两处口径不一致,实际以接口返回的 X-RateLimit 响应头为准)。
限制
- 免费档每月只有 50 万 Token,重度 Agent 任务跑不了几天,定位是测试和轻量使用。
- 超出免费额度且账户有余额时,会按模型单价扣余额,不是免费到底——不想花钱就别充值。
- 模型阵容共 33 个,是精选聚合,不是全网最全;找冷门模型的别抱预期。
容易卡住的地方
- 调用返回 402:通常是本月免费额度用完且账户余额为零。去控制台看用量面板确认,等下月重置或再决定要不要升级。
- 不知道额度还剩多少:控制台有月度用量显示;接口响应头也带 X-RateLimit 系列字段,脚本里可以顺手记录。
- 限速到底是多少:官网自家两个位置写了 60 和 80 两个数,别按任何一个写死并发,以实际响应头为准,代码里做好 429/限速重试。
避坑
- 别把 50 万 Token 当生产额度规划:它只够测试和轻量任务,正式产品要么升级套餐,要么接别家大额度免费档。
- 充值前先算单价:超量按「每个模型自己的单价」扣,不同模型差价很大,控制台模型目录里有各模型价格,先看再跑。
以上信息以官方页面为准,申请前请打开官网再核对一次。
常见问题
免费档真的不用绑卡吗?
不用。官方定价页对免费档的标注就是「Forever — no card required」,注册免费账号即可开始用。
每月 50 万 Token 是输入和输出分开算吗?
合并算。官方 FAQ 写明 Token 覆盖 prompt 和模型回复两部分,从同一个每月额度里扣。
33 个模型免费档都能用吗?
都能。官方 FAQ 明确:每个套餐(含 Free)都可访问全部 33 个模型,套餐之间只差 Token 量和限速,不差模型与功能。
额度用完了会怎样?会不会被扣钱?
先扣账户余额(按模型单价);余额为空时返回 HTTP 402 明确报错,不会产生欠费或意外账单。没充值过就等于自动停在免费范围内。
免费档限速是多少?
官网套餐卡写 60 次/分钟、对比表写 80 次/分钟,自家口径不一致。实际限制以接口返回的 X-RateLimit 响应头为准。
付费档多少钱起?
Starter $3.50/月含 50M Token,往上 Basic、Pro、Scale 直至 $50/月不限量(仍有限速)。只是测试和轻量使用的话,免费档够用,没必要先付费。