> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Smart search

> Describe your task to find candidate models. Combine requirements with filters, understand match scores, and refine empty or unsuccessful searches.

Smart search finds candidate models from a description of your task and explains the matches. Use filters, model details, and your own testing to make the final choice.

<h2 id="describe-your-task">
  Describe your task
</h2>

1. Open the [model catalog](https://aihubmix.com/models) and describe your task in the search box.
2. Include the input, required capabilities, and main constraints. For example: “Read product screenshots and return JSON, with low latency as a priority.”
3. Submit the search or select a suggested task.
4. Read the recommendation and open the candidates' [model details](/en/guides/model-details) to check them.

You can select requirements such as image input or tool calling before submitting. Filters and smart search constrain the candidates together.

<Tip>
  Describe the task without pasting API keys, customer information, or full business documents. If you already know a model's name or ID, use regular search.
</Tip>

<h2 id="match-scores">
  Understand match scores
</h2>

A match score indicates how well a model fits **this search**, on a scale of 0–100. Use it to compare the current candidates. It is not a general model ranking or a guarantee that a task will succeed.

Regular search results do not show match scores. A missing score is not replaced with zero. The recommendation explains why a candidate may fit; check its details for pricing and capabilities.

<h2 id="refine-search">
  Refine your search
</h2>

Edit your description and submit it again to get new recommendations. Switching between list and table views, viewing favorites, or changing filters does not automatically run another smart search.

Keep essential requirements first, then adjust preferences such as cost or context length. Test shortlisted models in Playground with representative inputs.

<h2 id="troubleshooting">
  Empty results or unavailable search
</h2>

| Situation | Next step |
| - | - |
| No matching models | Relax a requirement or search for each task separately |
| Search is temporarily unavailable | Retry later, or continue with regular search and filters |
| Results do not fit | Specify the input type, output format, or key constraint and submit again |

Related: [Choose a model](/en/guides/choose-models) · [Model details and comparison](/en/guides/model-details)

Last updated: 2026-10-13


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.