功能特性

# 功能与能力 ## 缓存 控制面板: Settings → Cache Responses → Enable typescript // 自定义 TTL (1 小时) headers: { 'cf-aig-cache-ttl': '3600' } // 跳过缓存 headers: { 'cf-aig-skip-cache': 'true' } // 自定义缓存键 headers: { 'cf-aig-cache-key': 'greeting-en' } **限制：** TTL 60秒 - 30天。**不支持流式传输 (Streaming)。** ## 速率限制 控制面板: Settings → Rate-limiting → Enable - **固定窗口：** 按间隔重置 - **滑动窗口：** 滚动窗口 (更准确) - 超出限制时返回 `429` ## 防护栏 (Guardrails) 控制面板: Settings → Guardrails → Enable 过滤提示词/响应中的不当内容。操作：标记 (记录) 或 拦截 (拒绝)。 ## 数据防泄漏 (DLP) 控制面板: Settings → DLP → Enable 检测 PII (电子邮件、社保号、信用卡)。操作：标记、拦截或脱敏。 ## 计费模式 | 模式 | 描述 | 设置 | |------|-------------|-------| | **统一计费** | 通过 Cloudflare 支付，无需提供商密钥 | 仅使用 `cf-aig-authorization` 请求头 | | **BYOK** | 在控制面板存储提供商密钥 | 在 Provider Keys 部分添加密钥 | | **透传** | 随每个请求发送提供商密钥 | 包含提供商的认证请求头 | ## 零数据留存 控制面板: Settings → Privacy → Zero Data Retention 不存储任何提示词/响应。仍会跟踪请求计数和成本。 ## 日志记录 控制面板: Settings → Logs → Enable (最多 10M 条日志) 每条记录：提示词、响应、提供商、模型、Token、成本、持续时间、缓存状态、元数据。 typescript // 跳过请求日志记录 headers: { 'cf-aig-collect-log': 'false' } **导出：** 使用 Logpush 到 S3, GCS, Datadog, Splunk 等。 ## 自定义成本跟踪 针对 Cloudflare 定价数据库中不存在的模型： 控制面板: Gateway → Settings → Custom Costs 或通过 API：设置 `model`, `input_cost`, `output_cost`。 ## 支持的提供商 (22+) | 提供商 | 统一 API | 备注 | |----------|-------------|-------| | OpenAI | `openai/gpt-4o` | 完全支持 | | Anthropic | `anthropic/claude-sonnet-4-5` | 完全支持 | | Google AI | `google-ai-studio/gemini-2.0-flash` | 完全支持 | | Workers AI | `workersai/@cf/meta/llama-3` | 原生 | | Azure OpenAI | `azure-openai/*` | 部署名称 | | AWS Bedrock | 仅提供商端点 | `/bedrock/*` | | Groq | `groq/*` | 快速推理 | | Mistral, Cohere, Perplexity, xAI, DeepSeek, Cerebras | 完全支持 | - | ## 最佳实践 1. 为确定性提示词启用缓存 2. 设置速率限制以防止滥用 3. 使用防护栏