用途：查询 OpenRouter 的模型目录，帮助在选型、比价、核对能力时快速筛选模型。核心接口为 GET /api/v1/models，无需 API 密钥。
主要能力：列出全部模型并统计数量；用 supported_parameters=tools 过滤支持工具调用的模型；读取模型对象中的 pricing.prompt/completion（按 token 计价，乘 1M 得可读费率）、context_length、top_provider.max_completion_tokens、architecture.modality 等字段；用 Python 按免费、工具调用、最低价、128K+ 上下文等条件过滤；通过 GET /api/v1/models/{id}/endpoints 比较同一模型各提供商的定价与量化；使用模型 ID 后缀 :free、:nitro、:floor、:extended、:thinking 选择变体行为；用 openrouter/auto 让路由自动选模型，openrouter/free 仅路由到免费模型。
使用方式：命令行需 curl 与 jq，例如 curl -s https://openrouter.ai/api/v1/models | jq '.data | length'。Python 需 3.8+ 与 requests，openrouter/auto 示例还需 OpenAI SDK（pip install requests openai）。仅特殊路由器的补全示例需要将 OpenRouter API 密钥导出为 OPENROUTER_API_KEY。
适用场景：模型选型与比价、构建组织模型白名单、监控模型弃用与新增、按所需能力（工具、JSON 模式等）筛选模型、为单个模型寻找最便宜或最快的提供商。
限制：价格变动频繁，应始终通过 /api/v1/models 核实实时价格，建议目录缓存 1 小时 TTL；模型 ID 可能被重命名或移除，需重新查询并使用目录中的精确 ID；过滤条件拼写错误会导致空结果；资料中的热门模型价格表仅供参考。