SuperAPI AI 工具集

provider-integration-templates

通用与其它

查看项目

更新于 10-16 05:47

技能介绍

用途:为把 OpenRouter 接入流行 AI 框架提供完整的集成模板、安装脚本和可运行示例,覆盖 Vercel AI SDK、LangChain 与 OpenAI SDK。

主要能力:提供三类资源。安装脚本按框架自动安装与配置依赖;集成模板为可直接复制到项目的提供方配置与接口代码;可运行示例展示完整实现与最佳实践。同时提供验证脚本,用于检查集成是否正常、流式功能是否可用以及版本兼容性。

支持框架与内容:Vercel AI SDK(TypeScript)包含 createOpenAI() 配置、streamText()/generateText() 路由模板、useChat() 聊天组件和基于 Zod 的工具调用;LangChain(Python 与 TypeScript)包含 ChatOpenAI 配置、LCEL 链、带工具的智能体、RAG 实现及记忆与上下文管理;OpenAI SDK(Python 与 TypeScript)支持直接替换配置、流式补全、函数调用和嵌入集成。

使用方式:先阅读并执行目标框架的安装脚本,如 bash scripts/setup-vercel-integration.sh,或 LangChain 脚本加 --python / --typescript。再将模板复制到项目对应路径(如 cp templates/vercel-ai-sdk-config.ts src/lib/ai.ts),替换 YOUR_OPENROUTER_API_KEY 为实际密钥或环境变量,更新模型与流式选项。最后运行验证脚本,如 bash scripts/validate-integration.sh --framework vercel 与 bash scripts/test-streaming.sh --provider openrouter。

环境变量:统一使用 OPENROUTER_API_KEY、OPENROUTER_MODEL,以及可选的 OPENROUTER_SITE_URL 与 OPENROUTER_SITE_NAME(用于排名)。

最佳实践与限制:不要硬编码密钥,启用流式,添加错误处理与速率限制处理,部署前用验证脚本测试,并通过 OpenRouter 面板监控成本。常见问题包括密钥格式 sk-or-v1- 校验、流式为 true 及框架版本兼容、模型 ID 需为 provider/model-name。模板版本 1.0.0,支持 Vercel AI SDK 4.x、LangChain 0.3.x、OpenAI SDK 1.x。具体收费与价格资料未提供。