紫微斗数大模型:郑大钱

API / 接入 AI

每个 FateStar 帐号都有自己的 API。把金钥接进 Claude、Codex、Cursor、DeepSeek、Gemini, 就能在 AI 里直接紫微排盘、读你存的命盘、请郑大钱解盘 —— 不用打开网站。排盘与网站同一个引擎、同一个结果; 解盘照网站价格扣你的积分。

给 AI 看:一句话装好 API + MCP + Skill (推荐)

把下面这句话贴进 Claude Code、Codex 或任何能执行指令的 AI, 它会自己装好 FateStar 的 MCP、Skill 和 API。最后只要在浏览器登录 FateStar 按「允许」, 不用贴金钥。

贴进你的 AI
请阅读 https://www.fatestar.top/agent.md ,按里面的步骤帮我装好 FateStar 紫微斗数的 MCP、Skill 和 API;需要我自己在浏览器登录的那一步告诉我怎么做。

或在终端机执行一行:

macOS / Linux
curl -fsSL https://www.fatestar.top/install.sh | sh
Windows PowerShell
irm https://www.fatestar.top/install.ps1 | iex

安装脚本只做两件事: 把 FateStar Skill 放进 ~/.claude/skills 与 ~/.codex/skills、用 claude / codex 指令注册 MCP 伺服器。不读也不改其他档案, 不要密码。执行前可以先看完整内容: install.sh · install.ps1 · SKILL.md · agent.md

Claude Desktop / claude.ai: 设定 → 连接器 → 新增自订连接器, 网址填 https://www.fatestar.top/mcp

ChatGPT: 左侧「插件」→ 右上「添加」→ 添加自定义 MCP 服务器, 身份验证选 OAuth, 网址填 https://www.fatestar.top/mcp

反过来, 想让网站改用你自己的 Claude / OpenAI / DeepSeek 来解读: 设定 → 自带 AI

需要金钥的接法

登录后到「设定 → API / 接入 AI」产生一把金钥 (以 FSFSKey 开头)。完整金钥只显示一次, 请存好; 不用了可以随时撤销。

前往产生金钥

各家 AI 分开设定

任何能填「自订 OpenAI Base URL + Key」的工具 (Cherry Studio、LobeChat、Dify、Coze、n8n、各家 IM 机器人框架) 都能把它当成一个模型加进去。出生资料放在 birth 栏位最准; 没给的话会从题目文字解析, 再没有就先请用户提供生日 (不扣分)。

shell
Base URL : https://www.fatestar.top/api/v1
API Key  : FSFSKey_YOUR_KEY
Model    : zwds-zdq        (zwds-zdq-think)

curl https://www.fatestar.top/api/v1/chat/completions \
  -H "Authorization: Bearer FSFSKey_YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"model":"zwds-zdq","birth":{"year":1990,"month":7,"day":23,"hour":16,"minute":20,"gender":"female"},"messages":[{"role":"user","content":"今年事业运如何?"}]}'

用金钥的范例, 把金钥换成你自己的 (设定 → API 产生)。

可以用的工具

ziwei_chart本命盘 (十二宫、四化、格局)免费
ziwei_transits大限 / 小限 / 流年 / 流月 / 流日 / 流时免费
fatestar_list_charts列出我存的命盘免费
fatestar_get_chart读我存的一张命盘免费
fatestar_save_chart排盘并存进帐号免费 (占命盘配额)
fatestar_credits查余额与积分免费
ziwei_reading郑大钱 AI 解盘$0.10 / 题 (长题 $0.20), 扣 API 余额

计费与错误

  • API 用美金余额付费 (设定 → API 储值): AI 解盘每题 $0.10, 长题 $0.20 (长短照网站同一套字数规则); 排盘与运限每次 免费; 读命盘、查余额免费。呼叫模型前先扣, 生成失败原路退回。题目字数上限与网站相同。
  • 新帐号试用: 第一次用网页登录接上 MCP、或产生第一把金钥时, 送 $3.00 API 余额 (约 30 次标准提问), 每个帐号一次, 储值过的帐号不送。
  • 过渡期到 2026-12-15 (北京时间): 美金余额不够时改扣帐号积分 (照网站规则, 每题最少 1 积分; 这时排盘不另收费)。过渡期结束后要先储值才能用。
  • 每把金钥预设每天最多扣 10000 积分、每分钟 10000 次, 可在设定页调整; 带 X-End-User-Id (或 OpenAI 的 user 栏位) 时, 同一位用户每分钟最多 10 次。超过分别回 429 KEY_DAILY_LIMIT_REACHED / RATE_LIMITED。
  • 语气预设是狠人模式 (cruelty = 2, 忠言逆耳、直说重点), 跟网站一样; 想要委婉一点就传 cruelty: 1 (REST、MCP 的 ziwei_reading、OpenAI 端点的 body 都收)。
  • 带 Idempotency-Key (MCP 用 idempotencyKey 参数): 网路重送同一个问题只扣一次。
  • 余额不够: AI 解盘回 402 INSUFFICIENT_CREDITS (附需要与现有), 排盘回 402 INSUFFICIENT_BALANCE; 金钥无效回 INVALID_API_KEY, 已撤销回 API_KEY_REVOKED; 每把金钥预设每分钟 10000 次 (设定页可调), 超过回 429 RATE_LIMITED。
  • 怎么判断错误: REST 与 OpenAI 相容端点看 HTTP 状态码 + body 的 error.code (例如 401 INVALID_API_KEY)。MCP 工具呼叫的 HTTP 一律是 200, 看 result.isError 是不是 true, 再把 content[0].text 当 JSON 解析, 读里面的 error.code (与 REST 同一组错误码)。只有 OAuth 版的 /mcp 在没带或带错 token 时, 会在 HTTP 层直接回 401 并附 WWW-Authenticate。
  • 每次调用都记在「设定 → API」的用量里, 只有你自己看得到。

规格文件

提醒: 命盘里「真实出生四柱 / 真实干支」是万年历的日子; 宫位上的天干地支是宫位编号, 不是日期。