把台股社群回覆能力接進你的產品

01 / Quick start

先用公開測試端點確認格式

公開端點不需要 API Key，每個 IP 每分鐘最多 4 次。它適合測試，不適合正式服務。

curl -X POST "https://berich.cc/api/agent/phoebe/demo-reply" \
  -H "Content-Type: application/json" \
  -d '{
    "post_content": "今天大盤又跌 300 點，手上的 0050 該停損嗎？",
    "author": "小明"
  }'

02 / Production

正式環境使用 API Key

正式端點為 POST /api/agent/phoebe/v1/reply。API Key 只能放在伺服器端，請勿寫進網頁、App bundle 或公開 Git 儲存庫。

curl -X POST "https://berich.cc/api/agent/phoebe/v1/reply" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $PHOEBE_API_KEY" \
  -d '{
    "post_content": "今天大盤又跌 300 點，手上的 0050 該停損嗎？",
    "author": "小明",
    "topic_hint": "ETF",
    "angel": "olivia"
  }'

03 / Request

請求欄位

angel: mira / starter

🌸 Phoebe & 🔥 Mira · 內容與社群傳播

適合 Threads / IG / FB 爆款經營。專長在於情緒同理、散戶恐慌安撫、社群金句轉發與台股法規免責避險。

angel: olivia / victoria

📊 Olivia & 👑 Victoria · 量化籌碼與投資長

適合看盤軟體、量化交易群或 VIP 會員服務。專精法人與主力分點動向、籌碼集中度計算，並由投資長進行跨維度綜合研判。

04 / Response

回應格式

{
  "ok": true,
  "request_id": "req_...",
  "intent": "panic",
  "reply": "先別急著在情緒最滿的時候做決定...",
  "consulted_team": true,
  "senior_advisor": "Mira (內容創意長)",
  "senior_advice": "市場短期震盪是常態...",
  "topic": "ETF",
  "angel": {
    "id": "mira",
    "name": "Mira",
    "title": "內容創意長"
  },
  "usage": {
    "plan": "starter",
    "remaining_quota": 985,
    "total_limit": 1000,
    "days_left": 6,
    "expires_at": "2026-09-05T15:00:00Z"
  }
}

reply 是建議文案；正式發布前仍應由你的系統套用內容政策、敏感詞與人工審核規則。

05 / Examples

TypeScript

const response = await fetch(
  "https://berich.cc/api/agent/phoebe/v1/reply",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-API-Key": process.env.PHOEBE_API_KEY!,
    },
    body: JSON.stringify({
      post_content: "00919 最近一直跌，存股還要繼續嗎？",
      author: "ETF 新手",
      topic_hint: "高股息 ETF",
      angel: "olivia",
    }),
  },
);

if (!response.ok) {
  throw new Error(`Phoebe API error: ${response.status}`);
}

const result = await response.json();
console.log(result.reply);

Python

import os
import requests

response = requests.post(
    "https://berich.cc/api/agent/phoebe/v1/reply",
    headers={"X-API-Key": os.environ["PHOEBE_API_KEY"]},
    json={
        "post_content": "台積電法說後震盪好大，該怎麼看？",
        "author": "投資小白",
        "angel": "victoria",
    },
    timeout=30,
)
response.raise_for_status()
print(response.json()["reply"])

06 / Integration

建議的正式介接方式

1. 你的後端接收貼文、客服訊息或社群監聽事件。
2. 後端呼叫 Phoebe API，取得 reply 與 intent。
3. 套用你的審核規則，再由人工確認或透過平台官方 API 發布。

不要把平台 Access Token 傳給 Phoebe。發布權限應留在你自己的後端。

07 / Errors

錯誤與重試

• 401：API Key 缺失、錯誤或已撤銷。
• 403：試用到期、額度用盡，或指定的 Angel 未包含在目前方案。
• 422：欄位格式不符。
• 429：每分鐘請求速率上限。
• 500：暫時無法生成。使用指數退避重試，最多 2 次。

08 / Security & Compliance

安全承諾與合規原則

• Safe by Design（零社交 Token 存取）：Phoebe API 為純文字分析與建議接口，絕不要求、絕不存儲你的社交平台 Access Token 或帳號密碼，審核與發布 100% 掌握在你的後端或小編手上。
• Zero Public Model Training Policy（零公開模型訓練保證）：你的業務貼文與分析請求數據僅用於即時推理生成，絕不上傳或作為任何第三方公開基礎 AI 模型的訓練資料。
• 台股法規與免責合規：所有回覆嚴格遵循市場公開數據分享、交易心理陪伴與理財觀念科普，不進行個股買賣點名、目標價預測或獲利保證。
• 透明請求次數計費：單次呼叫扣除 1 次額度，無任何字數階梯加價或隱藏點數換算。