用途:在 Netlify 服务端计算(Functions / Edge Functions)中调用 OpenAI、Anthropic、Google Gemini、OpenRouter 等模型,无需自行配置各厂商 API Key 或账号,网关自动注入 SDK 已读取的密钥与 Base URL。
主要能力:各厂商官方 SDK 可无参实例化(OpenRouter 例外,需显式传 Base URL);也可通过 OpenAI SDK 以 OpenRouter 记法访问 xAI、DeepSeek、Meta、Mistral、Qwen 等模型。注入变量包括 OPENAI_API_KEY/OPENAI_BASE_URL、ANTHROPIC_API_KEY/ANTHROPIC_BASE_URL、GEMINI_API_KEY/GOOGLE_GEMINI_BASE_URL、OPENROUTER_API_KEY/OPENROUTER_BASE_URL,以及始终注入的 NETLIFY_AI_GATEWAY_KEY/NETLIFY_AI_GATEWAY_BASE_URL。若已设置 GOOGLE_API_KEY 或 GOOGLE_VERTEX_BASE_URL,则不再注入 Gemini 变量。
使用方式:在 netlify/functions 下编写函数,安装对应 SDK(如 npm install openai),无参实例化客户端并调用;本地开发可用 netlify dev(需 npm install -g netlify-cli@latest 与 netlify login),或安装 @netlify/vite-plugin 并在 vite.config.js 中加入 netlify() 后运行 npm run dev。启用需使用基于额度的套餐,执行 netlify init 关联项目,并至少完成一次生产部署(netlify deploy --prod --open)。
限制:仅限服务端,不可从浏览器调用;凭据仅运行时可用,构建脚本、预渲染/SSG、构建插件中调用会失败;同步函数 60 秒超时,长生成需流式或后台函数;需至少一次生产部署才激活;输入上限 200k tokens;速率限制按团队每分钟额度(Free 90 / Personal 450 / Pro 1,800 / Enterprise 9,000);$1 用量=180 credits;不传递请求头,不支持批量推理与 OpenAI 优先处理;仅路由至零数据保留(ZDR)提供商;模型列表动态变化,勿硬编码。网关不存储提示或输出。