紫微斗數大模型:鄭大錢

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」的用量裡, 只有你自己看得到。

規格文件

提醒: 命盤裡「真實出生四柱 / 真實干支」是萬年曆的日子; 宮位上的天干地支是宮位編號, 不是日期。