SuperAPI AI 工具集

openrouter

编程与开发

查看项目

更新于 10-15 21:10

技能介绍

用途:该技能面向需要接入 OpenRouter 的 AI 智能体,提供统一 API 的集成指导,用一套接口访问 90+ 提供商的 400+ 模型,适用于对话补全、模型选择、流式响应、工具调用、结构化输出、联网搜索、多模态输入、路由回退、错误重试以及成本与性能优化等场景。

主要能力:请求端点为 POST https://openrouter.ai/api/v1/chat/completions,必需请求头为 Authorization: Bearer ${apiKey} 与 Content-Type: application/json,可选 HTTP-Referer 和 X-Title 用于应用归属。模型标识格式为 provider/model-name[:variant],变体包括 :free、:online、:extended、:thinking、:nitro、:exacto。支持 stream 流式输出、tools 与 tool_choice 工具调用、response_format 结构化输出(json_object 或 json_schema 严格模式)、plugins 启用 web 搜索与 response-healing,以及图片、音频、视频、PDF 等多模态输入。可通过 provider.order、allow_fallbacks、sort 控制路由,或用 models 数组配置模型回退。

使用方式:按需设置 model、messages、temperature、max_tokens、top_p、top_k、stop、user、session_id、metadata 等参数;流式响应按 SSE 解析 data: 行,遇 [DONE] 结束;工具调用需解析 tool_calls 并回传结果;用量与成本可从 usage 字段读取。

限制:资料未提供具体价格、免费额度、速率上限与各模型上下文长度等数值,需以官方为准。部分参数存在模型差异,例如 top_k 不适用于 OpenAI 模型;:exacto 无回退可能降低可用性。错误处理建议对 408、429、502、503 使用指数退避重试,400、401、403、402 不应重试。