方案
| 方案 | 价格 | 每天请求次数 | 每月请求次数(约) | 端点 |
|---|---|---|---|---|
| 免费 | $0 | 10 | 300 | 本命盘及其各部分、恒星、每日运势、天象、用量 |
| API Pro | 每月 $6.99 | 1,000 | 30,000 | 全部,另加一段时间内的行运、合盘、太阳回归、最佳日子和地点 |
怎样算一次请求
- 对计算端点的一次成功调用就是一次请求,不分端点:完整星盘与简版星盘消耗相同。
- 通过 MCP 服务器进行的一次工具调用,也计一次请求。
- 因无效而被拒绝的请求(400)不消耗额度,因我们这边的原因而失败的请求(5xx)会退还额度,
GET /v1/usage免费。 - 额度属于账户,涵盖该账户的所有密钥,在 UTC 时间 00:00 恢复。
- 每个响应都带有
X-RateLimit-Limit、X-RateLimit-Remaining和X-RateLimit-Reset,客户端可以据此自行控制请求节奏。
达到限额时
当天的额度用完后,API 返回 429,并给出额度恢复的时间;在免费方案下,还会附上 API Pro 的链接。没有超额费用:超出限额的请求会被拒绝,从不计费。付款一完成,API Pro 就立即生效。
计费
- API Pro 通过 Stripe 按月计费,每月 $6.99;Stripe 可能会以你的当地货币显示金额。
- 可以随时在开发者控制台的 Billing(计费)页面取消;方案会持续到已付费的月份结束。
- 两种方案都允许商业使用。
- API Pro 是独立于 NatalChart.AI 应用方案的订阅:两者互不包含,额度也相互独立。
与其他占星 API 对比
许多占星 API 按积分计价,不同端点消耗的积分也不同。在这里,一次调用就是一次请求。概览页面有一张表,列出七个 API 的免费方案和入门价格;对比页面则逐一介绍它们。
常见问题
有免费的占星 API 吗?
有。免费密钥每天提供 10 次请求,无需绑卡:完整或分部分的本命盘、恒星、每日运势(含对某张星盘的行运),以及任意日期的天象。
超出限额的请求会收费吗?
不会。超出每日限额后,API 返回 429,额度在 UTC 时间 00:00 恢复。两种方案都没有超额费用。
有按年计费的 API 方案吗?
没有。API Pro 按月计费,每月 $6.99,可以随时取消。
在 API Pro 上,一次调用要多少钱?
用满时约 $0.00023:每月 $6.99、每天 1,000 次请求,相当于每月约 30,000 次请求。
免费方案可以用于商业产品吗?
可以。两种方案都允许商业使用。请把密钥保存在你的服务器上。