find-models

始终搜索 API 以获取当前模型

AI 模型领域每周都在变化。新模型不断发布，旧模型则被弃用或超越。不要依赖你以前见过的模型名称，包括过去的对话或训练数据中出现的名称。你“熟悉”的特定模型可能已不再是最佳选择，可能比更新的替代方案更慢，也可能已经不存在。

始终先查询 Replicate API。使用搜索和集合来发现当前可用的模型，然后阅读架构，了解输入和输出，再运行任何内容。

文档

• 参考文档：https://replicate.com/docs/llms.txt
• OpenAPI 架构：https://api.replicate.com/openapi.json
• MCP 服务：https://mcp.replicate.com
• 单个模型的文档：https://replicate.com/{owner}/{model}/llms.txt
• 请求 Markdown 格式的文档页面时，设置 Accept: text/markdown。

搜索

• 使用搜索 API（GET /v1/search?query=...）按任务查找模型。它会返回模型、集合和文档。
• 搜索结果会返回每个模型的元数据，包括 tags、generated_description 和 run_count。
• 搜索 API 还会在模型结果旁返回匹配的集合。
• 避免通过 API 列出所有模型。模型数量太多。请使用有针对性的查询。

集合

• 集合是由 Replicate 员工维护的精选模型组。
• official 集合包含始终处于热启动状态、API 稳定且定价可预测的模型。
• 使用集合缩小候选范围，再进行深入比较。
• 使用 GET /v1/collections 列出集合。使用 GET /v1/collections/{slug} 按 slug 获取集合。

阅读模型架构

• 每个模型都会通过模型 API（GET /v1/models/{owner}/{name}）公开其输入/输出架构。
• 架构路径：model.latest_version.openapi_schema.components.schemas.Input.properties
• 每个属性可能包含：type、description、default、minimum/maximum、enum、format（例如，文件输入的 uri）。
• 运行模型前始终先获取架构。架构会发生变化。

选择合适的模型

• 优先选择官方模型。它们始终处于热启动状态（无需冷启动），API 稳定且定价可预测。
• 优先选择最新版本。如果搜索结果返回 v2.5 和 v3.0，请使用 v3。
• 运行次数可能会产生误导。旧模型会随时间累积运行次数，但可能已经过时。一个 2023 年有 10M 次运行的模型，很可能不如一个 2025 年有 100K 次运行的模型。
• 优先选择近期发布的模型。AI 领域发展迅速。
• 查看模型标签，以帮助按任务筛选（image-generation、video、audio 等）。

模型标识符

• 官方模型使用 owner/name 格式（例如 owner/model-name）。路由会自动指向最新版本。
• 社区模型需要使用 owner/name:version_id。必须固定到特定版本。社区模型可能需要冷启动，启动耗时较长。
• 如果必须使用社区模型，请注意它可能需要很长时间才能启动。你可以创建常驻部署，但需要为模型的运行时间付费。