紫微斗數大模型:鄭大錢
API / 接入 AI
每個 FateStar 帳號都有自己的 API。把金鑰接進 Claude、Codex、Cursor、DeepSeek、Gemini, 就能在 AI 裡直接紫微排盤、讀你存的命盤、請鄭大錢解盤 —— 不用打開網站。排盤與網站同一個引擎、同一個結果; 解盤照網站價格扣你的積分。
給 AI 看:一句話裝好 API + MCP + Skill (推薦)
把下面這句話貼進 Claude Code、Codex 或任何能執行指令的 AI, 它會自己裝好 FateStar 的 MCP、Skill 和 API。最後只要在瀏覽器登入 FateStar 按「允許」, 不用貼金鑰。
請閱讀 https://www.fatestar.top/agent.md ,按裡面的步驟幫我裝好 FateStar 紫微斗數的 MCP、Skill 和 API;需要我自己在瀏覽器登入的那一步告訴我怎麼做。或在終端機執行一行:
curl -fsSL https://www.fatestar.top/install.sh | shirm 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 欄位最準; 沒給的話會從題目文字解析, 再沒有就先請用戶提供生日 (不扣分)。
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」的用量裡, 只有你自己看得到。
規格文件
- OpenAPI 3.1: https://www.fatestar.top/api/v1/openapi.json
- Function calling 工具定義: /api/v1/tools?format=openai|deepseek|gemini|anthropic|mcp
- MCP (Streamable HTTP, OAuth):
https://www.fatestar.top/mcp· 金鑰版:https://www.fatestar.top/api/mcp - 給 AI 讀的安裝說明: /agent.md · Skill: /skills/fatestar/SKILL.md
- OpenAI 相容:
https://www.fatestar.top/api/v1/chat/completions· /api/v1/models - 接入你的 IM 機器人: Telegram / 飛書 / LINE / 微信 / WhatsApp 接入套件與教學
提醒: 命盤裡「真實出生四柱 / 真實干支」是萬年曆的日子; 宮位上的天干地支是宮位編號, 不是日期。