API 文檔

Base URL：https://404-pipeline.zeabur.app　・　版本：v2.1.6　・　文字 DeepSeek + 圖像 OpenAI gpt-image-2

1 ・ 認證

所有 API 都需 Bearer token（除 POST /api/apply 申請 key 用）。 沒有 key 的人到 /apply 自助申請（每月 3 batch）。

Authorization: Bearer 404p_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

2 ・ 一鍵跑整批（推薦）

POST /api/run-full-batch　跑完整 6 棒（含 104 BD 資料、Quality Gate、retry），總耗時 5-8 分鐘。

curl -X POST https://404-pipeline.zeabur.app/api/run-full-batch \
  -H "Authorization: Bearer 404p_xxx..." \
  -H "Content-Type: application/json" \
  -d '{
    "occupation": "行政秘書",
    "industry": "科技業",
    "ageRange": "28-40 歲",
    "salaryBand": "月薪 NT$38,000-55,000",
    "experience": "3-10 年",
    "directions": "AI 名片整理術—老闆要找窗口時 30 秒內找到對的人",
    "brandConstraint": "404方桌主推 AI、Vibe-First、單日課程可結",
    "knownPressureLines": "",
    "maxRetriesPerStage": 2
  }'

回應（成功）：

{
  "ok": true,
  "batchId": 3,
  "batchCode": "行政秘書-550107",
  "auth": { "source": "bearer", "label": "凱文 - test" },
  "stages": [
    { "agentId": 1, "agentName": "市場 BD", "status": "done", "attempts": 1,
      "durationMs": 63291, "promptTokens": 1611, "completionTokens": 4128 },
    { "agentId": 2, "agentName": "課程架構", "status": "done", "attempts": 1, ... },
    ...
  ],
  "detail": "GET /api/batch?id=3"
}

請求參數

3 ・ 取結果

curl https://404-pipeline.zeabur.app/api/batch?id=3 \
  -H "Authorization: Bearer 404p_xxx..."

回傳 batch + stages 6 棒完整輸出 + images 紀錄。每棒 output 是完整 markdown。

4 ・ 出圖（gpt-image-2 medium，商業攝影級）

整 batch 9 carousel + 5 投放廣告 + 1 MOCK = 15 張，每張約 NT$1.6（gpt-image-2 medium $0.053）。 AD-06 自動印 MOCK 浮水印（v2.1.1 公平交易法合規）。

# Agent 6 輸出含 ```json {"images":[...]}``` 區塊
# 直接把那段 images 陣列送進 /api/image
curl -X POST https://404-pipeline.zeabur.app/api/image \
  -H "Authorization: Bearer 404p_xxx..." \
  -H "Content-Type: application/json" \
  -d '{
    "batchId": 3,
    "defaultQuality": "medium",
    "images": [
      {"imageId": "P01", "purpose": "carousel-cover",
       "prompt": "L1+L2+L3+L4 ...", "watermark": false},
      {"imageId": "AD-06", "purpose": "ad-mock-internal",
       "prompt": "...", "watermark": true}
    ]
  }'

quality 對照

5 ・ 細粒度逐棒（要看每棒輸出再決定）

# 1. 建批次（用 access code 在 body）
curl -X POST .../api/batch -d '{...同上, "accessCode":"404-vibe"}'
# → {"batchId":4}

# 2. 跑單棒
curl -X POST .../api/agent \
  -H "Authorization: Bearer 404p_xxx..." \
  -d '{"batchId":4, "agentId":1}'
# → 含 output, gate findings

# 3. 違規時帶 retry: true（會自動把上一輪違規塞回 prompt 給模型）
curl -X POST .../api/agent \
  -H "Authorization: Bearer 404p_xxx..." \
  -d '{"batchId":4, "agentId":3, "retry":true}'

6 ・ 6 棒接力

7 ・ Quality Gate（自動把關）

每棒輸出後跑 R1-R6 規則，違反 block 級會自動 retry 並把違規 findings 塞回 prompt。

8 ・ 限制 / 配額

• 自助申請：每月 3 batch（30 天滾動）
• 每 email 30 天最多申請 2 把 key
• 單 batch 文字成本約 NT$2，全圖商業級 NT$25-30
• 需提額：聯繫管理員（email TBD）

9 ・ 錯誤碼