認證
Authentication

/health 以外,所有 API 端點均需提供 X-API-Key Header。

All API endpoints (except /health) require the X-API-Key header.

Header

X-API-Key: your-api-key

設定
Configuration

.env 中設定 SEO_API_KEY

Set SEO_API_KEY in .env:

SEO_API_KEY=your-secret-key

未設定 SEO_API_KEY 時,認證功能關閉(僅限開發環境)。正式環境中,未提供有效 Key 的請求將收到 401 Unauthorized

When SEO_API_KEY is not set, authentication is disabled (development mode only). In production, requests without a valid key receive 401 Unauthorized.

範例
Example

curl http://localhost:8002/api/v1/qa \
  -H "X-API-Key: your-api-key"

速率限制
Rate Limits

端點群組 / Endpoint Group 限制 / Limit
預設(QA、搜尋、回饋、Pipeline、同義詞)
Default (QA, Search, Feedback, Pipeline, Synonyms)
可設定 / Configurable
對話
Chat
較低限制 / Lower limit
週報生成
Report Generation
最低限制 / Lowest limit