使用 openrouter/auto 作为模型 ID，让 OpenRouter 的智能路由器（由 NotDiamond 驱动）自动分析你的提示词并选择最合适的模型。无需手动挑选模型，特别适合通用应用、成本优化和探索不同模型效果的场景。响应中 model 字段会显示实际使用的模型。

用法

将模型设置为 openrouter/auto：

import { OpenRouter } from '@openrouter/sdk';

const openRouter = new OpenRouter({ apiKey: '<OPENROUTER_API_KEY>' });

const completion = await openRouter.chat.send({
  model: 'openrouter/auto',
  messages: [
    { role: 'user', content: 'Explain quantum entanglement in simple terms' },
  ],
});

console.log(completion.choices[0].message.content);
// 查看实际选用了哪个模型
console.log('Model used:', completion.model);

响应中 model 字段会显示实际选中的模型（如 anthropic/claude-sonnet-4.5）。

工作原理

1. 提示词分析：NotDiamond 的路由系统分析你的提示词
2. 模型选择：根据任务需求选择最优模型
3. 请求转发：请求发送给选中的模型
4. 结果追踪：响应元数据记录使用的模型

支持的候选模型

Auto Router 从精选的高质量模型中选择，包括 Claude、GPT、Gemini、DeepSeek 等主流模型。具体模型池会随新版本发布持续更新，当前列表参考 Models 页面。

限制候选模型范围

通过 plugins 参数限制 Auto Router 可以选择的模型：

const completion = await openRouter.chat.send({
  model: 'openrouter/auto',
  messages: [{ role: 'user', content: 'Explain gravity' }],
  plugins: [
    {
      id: 'auto-router',
      allowed_models: ['anthropic/*', 'openai/gpt-5.1'],
    },
  ],
});

通配符语法

模式	匹配范围
anthropic/*	所有 Anthropic 模型
openai/gpt-5*	所有 GPT-5 变体
google/*	所有 Google 模型
openai/gpt-5.1	精确匹配

不配置时，Auto Router 使用全部支持的模型。也可以在插件设置中配置默认范围，对所有请求生效（除非单次请求覆盖）。

计费

按实际选中模型的标准价格收费，Auto Router 本身不额外收费。

适用场景

• 通用应用：不确定用户会发什么类型的请求
• 成本优化：简单任务让路由器选更经济的模型
• 质量优化：复杂请求自动路由到能力更强的模型
• 模型探索：发现哪些模型最适合你的使用场景

常见问题

Q: Auto Router 和直接指定模型有什么区别？

A: Auto Router 会根据每次请求的内容动态选择，适合请求类型多样的场景。直接指定模型则更可预测，适合对模型有明确要求的场景。

Q: 每次请求都会选同一个模型吗？

A: 不一定，相同提示词可能选到不同模型。如果需要稳定一致的模型，建议直接指定模型 ID。

Q: 支持工具调用和流式输出吗？

A: 支持，Auto Router 兼容所有标准 OpenRouter 功能，包括工具调用、流式输出和结构化输出。