掌控成本与延迟：OpenRouter ai-sdk-provider Provider路由、BYOK与ZDR完全指南

【免费下载链接】ai-sdk-providerThe OpenRouter provider for the Vercel AI SDK contains support for hundreds of models through the OpenRouter chat and completion APIs.项目地址https://gitcode.com/gh_mirrors/ai/ai-sdk-provider点击查看免费下载ai-sdk-provider 是 OpenRouter 官方为 Vercel AI SDK 打造的 Provider一个密钥即可接入数百个大型语言模型。这篇文章面向新手用通俗的语言带你掌握三大核心能力Provider 路由精确控制请求走哪些上游供应商、BYOK 自带密钥用自己的上游 API 密钥降低成本和ZDR 零数据保留满足合规与隐私要求轻松掌控 AI 调用成本与延迟。 一文看懂三个旋钮各解决什么问题OpenRouter 像一个AI 模型超市同一个模型比如openai/gpt-4o可能由多个上游供应商同时提供。不同供应商的价格、速度、数据政策都不一样。ai-sdk-provider 把 OpenRouter 的路由控制能力完整暴露出来你可以把三个旋钮理解为功能一句话解释解决的问题Provider 路由指定请求走哪些供应商、按什么顺序和策略稳定性、价格、延迟BYOKBring Your Own Key使用你已有的上游供应商 API 密钥降低每 token 成本ZDRZero Data Retention只走不存储你提示词数据的端点企业合规、隐私保护 Provider 路由精确控制请求走哪条通道路由偏好通过模型设置里的provider参数传递完整定义见 src/types/openrouter-chat-settings.ts。用 order、only、ignore 指定供应商范围const model openrouter(openai/gpt-4o, { provider: { order: [anthropic, openai], // 按此顺序尝试 allow_fallbacks: true, // 首选不可用时自动切换备用默认开启 require_parameters: false, // 是否只走支持全部请求参数的供应商 // only: [openai], // 白名单只用这些供应商 // ignore: [groq], // 黑名单跳过这些供应商 }, });各参数小抄order供应商 slug 列表按顺序优先尝试例如[anthropic, openai]only/ignore白名单与黑名单互斥搭配可精确圈定候选范围allow_fallbacks首选供应商宕机时是否自动降级到备用供应商生产环境建议保持默认truerequire_parameters设为true后只走完整支持你请求中所有参数如工具调用、温度的供应商避免参数被静默忽略quantizations按量化等级过滤如int8、fp16完整选项见 src/types/openrouter-api-types.ts。 路由能力不止于 ChatEmbedding、Reranking 等模型同样支持order与sort参考 src/types/openrouter-embedding-settings.ts。用 sort 和 max_price 为价格、延迟排序和封顶sort支持price、throughput、latency三种策略让 OpenRouter 自动按价格、吞吐量或延迟对候选供应商排序类型定义见 src/types/openrouter-api-types.tsmax_price为 prompt、completion、image、audio、request 分别设置单价上限超出预算的供应商会被直接排除。成本敏感团队的最快配置方式就是sort: pricemax_price封顶一次把最贵供应商挡在门外。auto-router让平台自动挑模型配合openrouter/auto模型与auto-router插件还可以用通配符限定自动路由可选择的模型范围如anthropic/*、openai/*插件配置见 src/types/openrouter-chat-settings.ts端到端示例在 issue-392-auto-router-plugin.test.ts。 BYOK自带密钥成本立省一笔BYOKBring Your Own Key自带密钥如果你已经在 OpenAI、Anthropic 等供应商处有 API 密钥比如带企业折扣可以直接在 OpenRouter 侧使用请求仍然走 OpenRouter 网关统一路由但推理费用由你的密钥承担成本更透明、更低。两种启用方式方式一在创建 Provider 时通过api_keys注入参数定义见 src/provider.tsimport { createOpenRouter } from openrouter/ai-sdk-provider; const openrouter createOpenRouter({ apiKey: sk-or-xxxx, // OpenRouter 密钥 api_keys: { openai: sk-xxxx }, // 你的 OpenAI 密钥 });SDK 会把它序列化为请求头X-Provider-API-Keys发给 OpenRouter实现见 src/provider.ts。方式二在 OpenRouter 账户的 Integrations 设置页绑定上游密钥之后无需改代码即可全局生效。看清 BYOK 成本账单开启用量统计usage: { include: true }后响应中会告诉你这次请求是不是走 BYOK、上游推理花了多少钱providerMetadata.openrouter.usage.isByok本次请求是否使用 BYOKproviderMetadata.openrouter.usage.costDetails.upstreamInferenceCost上游推理成本透传成本providerMetadata.openrouter.usage.costOpenRouter 侧扣费。字段解析逻辑见 src/chat/index.ts 与 README.md。⚠️ 一个容易踩的坑在使用 AI SDK Workflow持久化工作流时BYOK 的api_keys不会被持久化——恢复出来的模型在发起请求时会直接报错防止静默改用 OpenRouter 余额。正确做法是在工作流步骤内部创建这类模型详见 src/utils/workflow-serde.ts 和 README.md。️ ZDR 与 data_collection零数据保留合规无忧ZDRZero Data Retention零数据保留指供应商端点不存储你的提示词和响应数据是医疗、金融等合规敏感场景的硬性要求。两个相关路由开关定义见 src/types/openrouter-chat-settings.ts参数取值作用provider.zdrtrue/false只路由到不保留提示词的端点provider.data_collectiondeny/allow是否允许可能存储数据用于训练等的供应商枚举定义见 src/types/openrouter-api-types.ts典型合规配置const model openrouter(openai/gpt-4o, { provider: { zdr: true, data_collection: deny, sort: latency, // ZDR 端点候选较少按延迟排序保障体验 }, }); 注意开启zdr: true会缩小候选供应商范围建议搭配sort使用并在上线前验证你使用的模型确实存在 ZDR 端点。✅ 总结三大旋钮组合速查表你的场景推荐组合 成本敏感sort: pricemax_price封顶⚡ 延迟敏感sort: latencyorder指定低延迟供应商 已有企业密钥BYOKapi_keysusage.include核对账单 合规敏感zdr: truedata_collection: deny 高可用allow_fallbacks: trueorder多供应商备份快速回顾Provider 路由用order/only/ignore/sort/max_price圈定并排序上游供应商直接决定成本与延迟BYOK通过api_keys注入你自己的上游密钥账单中可用isByok与upstreamInferenceCost精确核对ZDR一条zdr: true让请求只走零数据保留端点合规一步到位。三者可以自由叠加用几行配置就能把模型超市变成完全符合你预算与合规要求的专属通道。赞分享【免费下载链接】ai-sdk-providerThe OpenRouter provider for the Vercel AI SDK contains support for hundreds of models through the OpenRouter chat and completion APIs.项目地址https://gitcode.com/gh_mirrors/ai/ai-sdk-provider点击查看免费下载相关推荐提示缓存省成本OpenRouter ai-sdk-provider Anthropic Prompt Caching实战指南提示缓存省成本OpenRouter ai sdk provider Anthropic Prompt Caching实战指南 如果你在用 Vercel AIRAG双引擎OpenRouter ai-sdk-provider 文本嵌入与文档重排完整实战指南RAG双引擎OpenRouter ai sdk provider 文本嵌入与文档重排完整实战指南 构建 RAG检索增强生成系统需要两个核心引擎 文本嵌入OpenRouter ai-sdk-provider工具调用完全指南Function Calling与并行工具调用实战OpenRouter ai sdk provider工具调用完全指南Function Calling与并行工具调用实战 ai sdk provider htt上一篇H1st Graph完全指南构建可解释的AI工作流下一篇Harper性能对比研究科学方法评估语法检查工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考