SuperAPI AI 工具集

openrouter-openai-compat

智能体与模型

查看项目

更新于 10-15 23:27

技能介绍

用途:把已有的 OpenAI SDK 集成迁移到 OpenRouter,或同时保留 OpenAI 与 OpenRouter 双兼容。OpenRouter 实现 OpenAI Chat Completions 规范(/v1/chat/completions),因此只需改两个值:base_url 指向 https://openrouter.ai/api/v1,api_key 换成 OPENROUTER_API_KEY,无需新增依赖。

主要能力:同一客户端可调用多家模型,模型 ID 需加供应商前缀,如 gpt-4o 变为 openai/gpt-4o,o1 变为 openai/o1,也可直接使用 anthropic/claude-3.5-sonnet、google/gemini-2.0-flash。流式输出、tools/tool_choice、JSON 模式(json_object 与 json_schema)、temperature、top_p、max_tokens、stop、n 等与 OpenAI 一致。

使用方式:Python 或 TypeScript 中设置 base_url 与 api_key,可选加 HTTP-Referer、X-Title 头用于应用归属。通过 extra_body 使用 OpenRouter 独有功能,如按顺序回退的模型列表(route: fallback)、供应商偏好(order、allow_fallbacks、sort: price)、插件(plugins: [{"id": "web"}] 启用联网搜索)。双供应商模式可用 create_client() 依据 LLM_PROVIDER 环境变量在直连 OpenAI 与 OpenRouter 间切换。

限制:organization 参数不适用需移除;embeddings 支持有限;微调模型不能直接访问;logprobs 依模型而定,可通过 /api/v1/models 查询;Responses API 为 beta。非 OpenAI 模型对提示词处理不同,迁移前应测试提示词并关注质量与延迟。