OpenRouter 平台功能

OpenRouter 平台功能

Search Models

3 分钟阅读

搜索模型

让任意模型都能搜索 OpenRouter 模型目录

Beta

测试版（Beta）

服务端工具目前处于测试阶段。API 与行为可能会变更。此工具仍属实验性功能——正式发布后，工具类型很可能会更名（去掉 experimental__ 前缀），这对使用当前名称的请求将构成破坏性变更。

openrouter:experimental__search_models 服务端工具让模型能够搜索并筛选 OpenRouter 模型目录。模型可以按名称、能力、模态和其他属性查找模型——这对需要动态选择模型的智能体很有用，例如配合子智能体（Subagent）工具。

快速开始

const response = await fetch('https://openrouter.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <OPENROUTER_API_KEY>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'openai/gpt-5.2',
    messages: [
      {
        role: 'user',
        content: 'OpenRouter 上哪些模型支持图像输入，并且上下文至少为 128k？'
      }
    ],
    tools: [
      { type: 'openrouter:experimental__search_models' }
    ]
  }),
});

const data = await response.json();
console.log(data.choices[0].message.content);

配置

搜索模型工具接受可选的 max_results 参数：

{
  "type": "openrouter:experimental__search_models",
  "parameters": {
    "max_results": 5
  }
}
参数类型默认值说明
max_resultsinteger5每次调用最多返回的模型数量。范围为 1 到 20

调用参数

模型生成搜索参数。所有字段均为可选——空调用会浏览完整目录：

字段类型说明
querystring针对模型名称、slug 和描述进行匹配的自由文本搜索
input_modalitiesstring[]按支持的输入模态过滤（text、image、file、audio、video）。返回支持全部指定模态的模型
output_modalitiesstring[]按支持的输出模态过滤（例如 text、image、embeddings、audio）。返回支持全部指定模态的模型
min_context_lengthinteger最小上下文长度（以 Token 计）
seriesstring按模型系列/家族分组过滤（例如 Claude、GPT、Gemini）

响应

该工具返回匹配的模型及其关键属性：

{
  "models": [
    {
      "id": "anthropic/claude-sonnet-4.5",
      "name": "Anthropic: Claude Sonnet 4.5",
      "description": "...",
      "context_length": 1000000,
      "input_modalities": ["text", "image", "file"],
      "output_modalities": ["text"],
      "series": "Claude"
    }
  ],
  "total_results": 12,
  "showing": 1
}

total_results 是匹配过滤条件的模型数量；showing 是应用 max_results 后实际返回的数量。

定价

目前搜索模型工具不单独计费；你只需支付标准 Token 用量。

后续步骤

上一页Shell下一页 Fusion