# Agent API 与 LLM 接入说明 Canonical URL: https://www.fortuneteller.today/zh/api Language: zh-CN Last updated: 2026-09-02 > 生成你自己的 Agent API key，用外部 LLM 直接调用 Fortuneteller.Today 的术数分析能力，并在 Profile 中查看 API 报告。如果你想把网站的术数能力接进自己的 agent，这页会说明单一的 analysis workflow、credits 消耗、报告写回 Profile 的 ## Keywords - Agent API - API key - LLM 接入 - 术数 API - 占卜 API ## 怎么把 Fortuneteller.Today 接进你自己的 AI agent？ API 页面适合想把外部 LLM 或 agent 接到网站术数分析链路的人。它的重点不只是展示一个 key，而是讲清楚如何选方法、如何确认输入、如何告知用户 credits 余额与本次消耗，以及余额不足时如何跳转到 Pricing 购买后继续。 如果你想把网站的术数能力接进自己的 agent，这页会说明单一的 analysis workflow、credits 消耗、报告写回 Profile 的方式，以及不同问题适合搭配哪些方法。 ## Highlights - 每个用户都可以生成自己的 API key - 统一走 site analysis 并消耗 credits - API 生成的 analysis 报告会像网站内报告一样进入 Profile 并带 API 标签 ## Guide ### 为什么 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，买完后再回到当前流程继续提交。 ## FAQ ### 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 购买后再继续当前流程。 ## Related topics - 怎么把术数网站接进自己的 agent - 为什么 Agent API 应该统一走 analysis workflow - 如何在 agent 流程里先告知 credits 再提交分析 - 为什么方法推荐接口比直接硬选术数更重要 - 如何确保地点和出生信息在 agent 流程里不被改写 ## Internal links - [zh-CN](https://www.fortuneteller.today/zh/api) - [en](https://www.fortuneteller.today/en/api) - [x-default](https://www.fortuneteller.today/en/api) ## Reader action [Open this page](https://www.fortuneteller.today/zh/api)