跳轉到主要內容

總覽

LemonData 會自動管理快取以優化效能並降低成本。雖然目前沒有公開的端點可用於清除快取項目,但您可以透過請求層級的控制項來完全掌控快取行為。

繞過快取

若要獲取不使用快取的最新回應,請在請求中使用 cache_control 參數:
curl -X POST "https://api.lemondata.cc/v1/chat/completions" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}],
    "cache_control": {"type": "no_cache"}
  }'

快取控制選項

類型效果
no_cache跳過快取查詢,始終獲取最新回應
no_store不要將此回應儲存在快取中
response_only僅使用完全比對快取(跳過語義比對)
semantic_only僅使用語義快取(跳過完全比對)

快取回饋

如果您收到錯誤的快取回應,可以進行回報:
curl -X POST "https://api.lemondata.cc/v1/cache/feedback" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "cache_entry_id": "abc123",
    "feedback_type": "wrong_answer",
    "description": "Response was outdated"
  }'
當一個快取項目收到足夠的負面回饋時,它將會自動失效。

使用情境

在開發過程中,使用 cache_control: {"type": "no_cache"} 以確保您獲取的是最新的 API 回應。
對於股票價格或天氣等即時數據,請務必使用 no_cache 以獲取最新資訊。
在對非預期回應進行除錯時,請使用 no_cache 以排除快取結果的影響。
有關快取的更多詳細資訊,請參閱 快取指南