使用指南

怎么把 Fortuneteller.Today 接进你自己的 AI agent?

这页最适合回答什么问题?

先看适用场景、需要的信息和阅读重点,再决定要不要继续使用这个方法。

API 页面适合想把外部 LLM 或 agent 接到网站术数分析链路的人。它的重点不只是展示一个 key,而是讲清楚如何选方法、如何确认输入、如何告知用户 credits 余额与本次消耗,以及余额不足时如何跳转到 Pricing 购买后继续。

如果你想把网站的术数能力接进自己的 agent,这页会说明单一的 analysis workflow、credits 消耗、报告写回 Profile 的方式,以及不同问题适合搭配哪些方法。

核心要点

  • 每个用户都可以生成自己的 API key
  • 统一走 site analysis 并消耗 credits
  • API 生成的 analysis 报告会像网站内报告一样进入 Profile 并带 API 标签

常见使用场景

结合常见问题,补充这类方法更适合怎么用、怎么读。

为什么 Agent API 现在只保留 analysis workflow

现在 Agent API 面向的是“直接拿站内同款报告”的产品路径,因此统一走 analysis workflow。这样 credits 规则、报告入库、Profile 历史记录、组合报告产品行为都与站内保持一致,不会再让用户在 raw result 和 site analysis 之间做额外选择。

为什么 API 页面要明确告知余额与本次消耗

真正可用的 agent 集成,不是等到扣费失败才告诉用户没积分,而是在提交前就先读取当前 credits,再结合 method definition 里的 site_analysis_credit_cost 告知本次会消耗多少。这样用户能先确认,再决定是否继续。

余额不足时为什么要直接跳去 Pricing

如果 analysis job 返回余额不足,外部 agent 不应该让用户困在失败信息里,而应该立即说明“当前剩余多少、还差多少”,然后把用户带去 Pricing 补充 credits,买完后再回到当前流程继续提交。

常见问题

API 会覆盖哪些术数方法?

上线即覆盖站内全部术数方法。你的 agent 可以先用方法推荐接口判断适合哪一类,再读取对应方法的必填字段和 credit cost,最后提交 analysis job。

API 调用会不会消耗 credits?

会。当前 Agent API 统一走网站自己的 analysis workflow,所以会按照方法定义里的 site_analysis_credit_cost 扣 credits。大多数单方法为 1 credit,部分深度或组合报告为 2 credits。

API 生成的报告会出现在 Profile 吗?

会。Agent API 提交的 analysis job 会像站内正常分析一样把报告写回 Profile,并自动带上 API 标签,支持单独筛选。

如果 credits 不够怎么办?

analysis job 会直接返回余额不足错误,同时告诉 agent 当前剩余 credits、所需 credits 和 Pricing 页面地址。外部 agent 应该立刻引导用户去 Pricing 购买后再继续当前流程。

可继续延伸的话题

如果你还想继续比较方法、提问方式与使用边界,可以从这些主题往下读。

  • 怎么把术数网站接进自己的 agent
  • 为什么 Agent API 应该统一走 analysis workflow
  • 如何在 agent 流程里先告知 credits 再提交分析
  • 为什么方法推荐接口比直接硬选术数更重要
  • 如何确保地点和出生信息在 agent 流程里不被改写