---
title: "Cloudflare AI Gateway 免費層：替 AI API 加上觀測與成本護欄"
description: "用 Cloudflare AI Gateway 的免費核心功能集中管理 AI 請求，實作 logging、cache、rate limiting 與 GEO 查詢的可追蹤欄位。本文說明把請求變成可追蹤事件、用 Analytics 找出錯誤形狀、只快取可重複的讀取、以限流控管預算，並附最小驗證清單與治理邊界。"
canonical: "https://yotron-ai.com/blog/cloudflare-ai-gateway-free-observability"
published: "2026-08-28"
last-updated: "2026-08-28"
---

# Cloudflare AI Gateway 免費層：替 AI API 加上觀測與成本護欄

用 Cloudflare AI Gateway 的免費核心功能集中管理 AI 請求，實作 logging、cache、rate limiting 與 GEO 查詢的可追蹤欄位。本文說明把請求變成可追蹤事件、用 Analytics 找出錯誤形狀、只快取可重複的讀取、以限流控管預算，並附最小驗證清單與治理邊界。

AI API 一旦被多人使用，最先失控的通常不是模型，而是看不見的延遲、重複請求、成本與錯誤。Cloudflare AI Gateway 的核心功能目前在所有方案提供，包含 dashboard analytics、cache、rate limiting；官方定價頁（2026-05-19）另列 Workers Free 所有 gateway 合計 100,000 筆 persistent logs。

## 先把請求變成可追蹤事件

不要把完整 prompt 當成唯一 log。對 GEO 應用，建立不含個資的 metadata：

```ts
const metadata = {
  query_id: crypto.randomUUID(),
  locale: "zh-TW",
  surface: "geo-citation-check",
  page_version: env.PAGE_VERSION,
};
```

把 metadata 傳給 Gateway，再記錄 `model`、`status`、`latency_ms`、`cache_hit` 與 `cited_url`。這樣能回答「哪一種查詢最常失敗」，而不必保存使用者原文。

## 三個免費核心功能

### Analytics：先找出錯誤形狀

依模型、路由與 HTTP 狀態分組看延遲和錯誤。`429` 應和 `5xx` 分開：前者是額度或速率護欄，後者才是供應商或程式故障。

### Cache：只快取可重複的讀取

FAQ 或固定 GEO 測試題可以 cache；個人化 prompt、帳務資料與寫入操作不要 cache。設定 TTL 時保存 `page_version`，內容更新就讓 cache key 改變，避免 AI 引用舊資料。

### Rate limiting：把預算變成技術規則

對匿名來源、單一 API key 與內部批次分開限流。收到 `429` 時回傳 `Retry-After`，前端採指數退避；不要在 Worker 裡無限重試把流量放大。

## 最小驗證清單

```bash
curl -sS -D - https://gateway.example.com/v1/chat \
  -H 'content-type: application/json' \
  -H 'x-geo-query-id: smoke-001' \
  -d '{"messages":[{"role":"user","content":"測試可引用回答"}]}'
```

保存每次測試的 request id，確認 dashboard 能找到同一筆事件；連續重送相同 FAQ，驗證 cache hit；快速發送超過限制的請求，驗證 `429` 與 `Retry-After`。測試資料不要包含真實客戶 prompt。

## 成本與治理邊界

AI Gateway 免費不等於供應商推論免費。Workers AI 仍受 Neurons 額度限制，外部模型則依各供應商計費。DLP scanning 在 AI Gateway 各方案免費，但 Guardrails 會使用 Workers AI 推論並計入用量。正式環境應設 spend limit、log 保留期限與刪除規則。

## 來源

- [Cloudflare AI Gateway 定價](https://developers.cloudflare.com/ai-gateway/reference/pricing/)，官方文件，2026-05-19 更新。
- [AI Gateway 限制](https://developers.cloudflare.com/ai-gateway/reference/limits/)，官方文件，2026-05-27 更新。
- [AI Gateway Analytics](https://developers.cloudflare.com/ai-gateway/features/analytics/)，Cloudflare 官方文件。

本文的 GEO metadata、cache key 與 QA 欄位是工程實作建議，不代表 Gateway 會直接提升 AI 搜尋排名。

---

## 相關推薦與延伸閱讀

- [Cloudflare 推出代理就緒度分數：用四大維度檢查你的網站對 AI Agent 是否準備好](/blog/cloudflare-agent-readiness-score-guide)：Cloudflare isitagentready.com 用四大維度替網站的 AI agent 就緒度打分。本文解析評分邏輯與官方歷史樣本，說明採用率為何不等
- [Cloudflare Vectorize 免費額度：做出會回傳來源的 RAG](/blog/cloudflare-vectorize-free-rag-citations)：用 Cloudflare Vectorize 與 Workers AI 建立小型 RAG 原型，理解免費額度、向量維度計算、來源回傳與 GEO 引用保真。本文說
- [Cloudflare Workers AI 教學：API Key 取得與免費額度呼叫實戰](/blog/cloudflare-workers-ai-free-api)：想零成本串接開源大模型？本文手把手教你取得 Cloudflare Workers AI 的 Account ID 與 API Token，完整解析每日免費額度計
- [Supabase vs Cloudflare 儲存方案比較：資料庫整合與物件儲存怎麼選？](/blog/supabase-vs-cloudflare-storage)：比較 Supabase Storage 與 Cloudflare R2 的資料模型、權限、API、流量成本與適用情境，提供中小企業與 AI 應用的選型決策表。本