
Flue Cloudflare Workers AI免API Key的內置AI網關詳解【免費下載鏈接】flueThe sandbox agent framework.項目地址: https://gitcode.com/GitHub_Trending/flue1/flueFlue 是運行在 Cloudflare Workers 上的 AI Agent 框架它的殺手級特性是內置 AI 網關全程免 API Key。你不需要向任何模型廠商申請密鑰、不需要在配置里存放秘密——一行代碼聲明模型所有 AI 調用就自動走 Cloudflare 自家的 Workers AI 與 AI Gateway授權和計費直接跟隨你的 Workers 賬號還有每日免費額度可用。為什么可以跳過 API Key傳統做法是注冊模型廠商賬號 → 申請 API Key → 存入環境變量或密鑰管理服務 → 代碼里讀密鑰發起 HTTP 調用。任何一步出錯Agent 就跑不起來。Flue 在 Cloudflare 目標環境下走了一條完全不同的路自動注冊cloudflare內置 provider當你的項目部署到 Cloudflare 時cloudflare/...這類模型前綴開箱即用無需任何額外配置不經過 HTTP走 Workers AI 綁定模型調用通過 Worker 環境的env.AI.run(...)完成綁定本身就是一份憑證——授權和計費跟隨 Worker 本體詳見 workers-ai-provider.ts 中Keyless: the binding itself is the credential的設計沒有密鑰就沒有密鑰泄露不需要配置 secret、不需要擔心.env泄露、團隊協作零門檻。計費按 Workers AI 的 Neurons 單位、跟隨你的 Cloudflare 賬號結算并帶有每日免費額度對新手非常友好??焖偕鲜秩脚渲梅椒ǖ?1 步聲明 AI 綁定在項目根目錄的wrangler.jsonc中加一段配置即可參考示例項目 wrangler.jsonc{ ai: { binding: AI } }第 2 步一行代碼聲明模型一個 Flue Agent 就是一個帶use agent指令的普通 TypeScript 函數參考 with-cloudflare-binding.tsuse agent; import { useModel } from flue/runtime; export function Assistant() { useModel(cloudflare/cf/moonshotai/kimi-k2.6); return You process direct requests using a Cloudflare Workers AI binding.; }cloudflare/之后的一切都會原樣作為模型 ID 傳給 Workers AI——既可以是cf/...的托管模型也可以是網關模型 ID如openai/gpt-5.5。第 3 步本地開發與部署npx vite dev # 本地 workerd 運行 npx vite build # 構建 npx wrangler deploy # 部署全程無需wrangler secret put因為你根本沒有任何密鑰可存。內置 AI 網關免費獲得的三大能力默認情況下每一次cloudflare/...調用都會自動經過 Cloudflare 的 AI Gateway網關 ID 為default你零配置就獲得了能力說明? 響應緩存相同請求命中緩存省錢又提速 請求日志每次模型調用都有可檢索的日志條目 預算控制在 Cloudflare 控制臺為網關設置用量上限如果你需要更精細的調優可以在app.ts中用 cloudflareBindingProvider 覆蓋默認網關用戶注冊優先于生成的默認配置setProvider( cloudflareBindingProvider({ binding: env.AI, gateway: { id: my-gateway, cacheTtl: 300, metadata: { tenant: acme } }, // ...或 gateway: false 完全繞過 AI 網關 }), );網關支持的選項完整定義見 gateway.tsid指定網關 IDskipCache/cacheTtl/cacheKey緩存行為控制metadata/collectLog/eventId日志與關聯標識requestTimeoutMs對首個響應分片的時限約束通過cf-aig-request-timeout頭下發。模型怎么選兩種前綴的差別模型寫法走向適用場景cloudflare/cf/xxxWorkers AI 托管模型OpenAI 兼容格式免 Key 調用 Workers AI 模型庫cloudflare/openai/xxx、cloudflare/anthropic/xxx經 AI Gateway 轉發免 Key 調用網關代理的廠商模型openai/gpt-5.5無前綴Flue 直連 OpenAI provider需要用自己的廠商 API Key一個容易混淆的點cloudflare/openai/gpt-5.5是通過 Cloudflare 計費的而openai/gpt-5.5走的是你自己的 OpenAI 密鑰——寫法只差一個前綴賬單歸屬完全不同。生產級可靠性框架替你兜底Flue 的 Workers AI 通道內置了多項穩定性機制新手無需感知細節??流空閑超時模型流超過 5 分鐘默認沒有吐出一個字節請求會失敗并按可重試錯誤自動重試避免返回 200 后再也不說話的懸掛流截斷即重試SSE 流異常中斷無結束幀會被識別為傳輸層瞬時故障安全重試而不是污染會話會話親和通過x-session-affinity頭把同一會話的請求釘在相同模型實例上讓廠商側的前綴緩存生效精確的網關日志關聯每條響應讀取自身的cf-aig-log-id頭并發下也不會把日志記錯請求。小結場景推薦做法剛上手、想快速跑通用cloudflare/cf/...免 Key 零配置需要多廠商模型統一管理用cloudflare/vendor/...走 AI Gateway已有廠商密鑰、要求直連保留廠商原生前綴 密鑰一句話總結Flue 把連接 AI這件事從密鑰管理問題降級成了一個字符串前綴——在 Cloudflare 上部署 Agent模型調用天然自帶網關、緩存、日志與免費額度。進一步閱讀模型選擇與 provider 機制models.mdCloudflare 部署完整指南deploy/cloudflare.mdCloudflare 官方示例項目examples/cloudflare/內置 provider 源碼packages/runtime/src/cloudflare/【免費下載鏈接】flueThe sandbox agent framework.項目地址: https://gitcode.com/GitHub_Trending/flue1/flue創作聲明:本文部分內容由AI輔助生成(AIGC),僅供參考