Cloudflare Developers：開發文件、模型 API 與雲端應用

Cloudflare Developers 整合 Cloudflare 的產品文件、API 參考與實作教學，協助開發者建立網站、後端介面和 AI 應用程式。讀者可以先依任務選擇服務，再確認串接方法、使用限制與費用。

白話說明：這個網站能幫你做什麼？

它像是一套雲端開發工具的使用手冊。需要讓程式上線、儲存使用者上傳的檔案，或讓網站回答問題時，可以在這裡找到對應產品與操作方式。文件提供說明，實際建立資源則透過 Cloudflare 帳號、控制台、命令列或 API 完成。

這個入口適合開發者、技術創業者與網站維運人員。新手可以從小型範例開始，但建立正式服務仍需要撰寫程式、管理權限及驗證結果，閱讀文件不會自動產生完整應用程式。

先部署一個最小的 Worker

依照Workers 命令列入門文件，先準備 Cloudflare 帳號與受支援的 Node.js 環境：

1. 執行 npm create cloudflare@latest -- my-first-worker，選擇簡單的 Worker 範例。
2. 進入專案目錄，以 npx wrangler dev 啟動開發環境，開啟終端機顯示的本機網址。
3. 修改來源檔案回傳的文字，儲存並重新整理，確認畫面已更新。
4. 執行 npx wrangler deploy，完成必要授權，再查看產生的 workers.dev 網址。

如果只想先試模型，可改走Workers AI REST API 教學，取得 Account ID 與 API Token，傳送模型需要的輸入，檢查 JSON 回應與錯誤欄位。Token 應留在伺服器端；本機測試發出的模型請求仍可能消耗服務額度。

AI 功能怎麼選：推論、管理與代理執行

Workers AI 在 Cloudflare 基礎設施上執行模型，可由 Worker 或外部後端透過 REST 呼叫。文字生成、向量表示與圖片相關任務使用不同模型，輸入輸出格式也需要分別查閱。

AI Gateway 管理送往支援供應商的請求，提供分析、日誌、快取、限流、重試與模型備援。它幫助團隊追查問題與控制使用情況，模型推論仍是另一層服務。

Agents 則提供持續狀態、即時連線、排程工作與 MCP 工具等能力，適合需要跨步驟執行任務的智慧代理。行為、授權與結果檢查仍由開發者決定。

儲存檔案、業務資料與向量

R2 適合圖片、文件等物件；D1 處理關聯式 SQL 資料；KV 提供鍵值儲存；Durable Objects 適合需要協調的狀態；Vectorize 儲存與搜尋向量。

例如，文件問答系統可以用 R2 留存原始檔、D1 保存業務紀錄，再以 Vectorize 找出相關內容供模型參考。開發者仍須安排資料匯入、存取權限和答案驗證。選擇前可閱讀資料與儲存產品比較，不要將所有資料放進同一種儲存服務。

免費閱讀與免費額度是兩件事

文件公開可讀，雲端資源依產品計費。2026 年 10 月 7 日核對的Workers AI 定價提供每日 10,000 Neurons 配額，於 UTC 00:00 重置。超量需要 Workers Paid，部分模型另要求付費計費方式，並非整個模型目錄都能無條件免費使用。

Gateway 的核心分析、快取與限流免費，但推論、日誌或其他功能可能產生費用。Gateway 費用說明也依首次建立網關的日期區分日誌方案。官方美元標價不能直接視為新臺幣含稅總價，各資料服務也有自己的用量與限制。

上傳資料前檢查日誌與授權

Workers AI 資料政策表示，未經明確同意，不會將客戶內容用於模型訓練或服務改進；搭配儲存產品時，內容仍可能被保存。外部模型供應商的條件需要另外確認。

AI Gateway 日誌預設開啟，可能記錄提示詞及回應，可調整收集設定。正式處理敏感資料前，應確認保存方式，並閱讀所選模型的個別授權，不能把 API 存取權當成通用商用授權。

網站維運也有對應文件

DNS、快取、TLS、WAF 與 Turnstile 文件分別處理解析、效能、加密、防護和訪客驗證。Turnstile 可嵌入網站，不要求全部流量經過 Cloudflare。這些能力要按需求設定，部署完成不代表安全規則已一併配置。

常見問題

免費方案能呼叫所有 AI 模型嗎？

不能這樣推定。每日配額、模型的付費要求和呼叫速率限制都會影響可用範圍，也不能將 Neurons 換算成固定的免費請求次數。

既有後端可以直接串接嗎？

可以透過 REST API 呼叫 Workers AI，使用 Account ID、適當權限的 Token 與模型對應的請求格式，不必先將整個後端搬到 Workers。

使用 AI Gateway 後還要付模型費用嗎？

模型推論與網關核心功能分開看待。免費的管理功能不代表供應商推論免費，還應檢查日誌和其他服務的費用。

官方資源與開發者社群

• API 參考文件：查詢介面與認證方式。
• 開發者 Discord：討論實作與串接問題。
• 官方 GitHub：查看專案與原始碼。
• CloudflareDev 動態：開發者產品公告。
• 官方支援與服務狀態：取得協助與確認事故。