-
Notifications
You must be signed in to change notification settings - Fork 0
AI Providers
FindRomCover supports cloud providers, local servers, and custom endpoints. All of them are configured in Settings > AI Settings....
| Provider | Base URL | Default model | Key required | Notes |
|---|---|---|---|---|
| OpenRouter | https://openrouter.ai/api/v1 |
qwen/qwen3.7-flash |
Yes | Aggregator with hundreds of models; cheapest vision options |
| OpenAI | https://api.openai.com/v1 |
gpt-4o-mini |
Yes | Reliable JSON output; gpt-5-nano is a low-cost alternative |
| Anthropic | https://api.anthropic.com/v1 |
claude-sonnet-4-5 |
Yes | Strong visual reasoning; native Messages API |
| Gemini | https://generativelanguage.googleapis.com/v1beta |
gemini-2.5-flash |
Yes | Generous free tier; gemini-2.5-flash-lite is cheaper |
| GLM | https://api.z.ai/api/paas/v4 |
glm-4.5v |
Yes | Zhipu/Z.AI; use https://open.bigmodel.cn/api/paas/v4 for the China endpoint |
| Local | http://localhost:11434/v1 |
qwen2.5vl:7b |
No | Ollama or LM Studio; no cloud cost, slower on weak hardware |
| Custom (OpenAI-compatible) | User-defined | User-defined | Optional | Proxies, gateways, self-hosted servers |
| Custom (Anthropic-compatible) | User-defined | User-defined | Optional | Endpoints speaking the Anthropic Messages API |
- Create an API key at openrouter.ai/keys.
- Select OpenRouter in AI Settings, paste the key, and click Test / Load Models.
- Pick a model. The default
qwen/qwen3.7-flashis the cheapest vision-capable model on OpenRouter at the time of writing.
OpenRouter exposes modality metadata, so the model picker knows exactly which models accept image input. See Recommended Models for a cost-ranked list.
- Create an API key at platform.openai.com/api-keys.
- Select OpenAI, paste the key, and click Test / Load Models.
- Choose a vision-capable model such as
gpt-4o-miniorgpt-5-nano.
The OpenAI adapter uses the shared OpenAI-compatible client and supports response_format JSON mode where available.
- Create an API key at console.anthropic.com.
- Select Anthropic, paste the key, and click Test / Load Models.
- Choose a model such as
claude-sonnet-4-5orclaude-haiku-4-5for lower cost.
Anthropic uses a native adapter implementing the Messages API, including image blocks.
- Create an API key at aistudio.google.com/apikey.
- Select Gemini, paste the key, and click Test / Load Models.
- Choose a model such as
gemini-2.5-flashorgemini-2.5-flash-lite.
Gemini uses a native adapter implementing generateContent with inline image data. The free tier is generous, which makes it a good starting point.
- Create an API key at z.ai.
- Select GLM, paste the key, and click Test / Load Models.
- Choose
glm-4.5vor another vision-capable GLM model.
For the China endpoint, change the Base URL to https://open.bigmodel.cn/api/paas/v4.
Run a local vision model and point FindRomCover at it. No API key is required.
Ollama
ollama pull qwen2.5vl:7b
ollama serve- Base URL:
http://localhost:11434/v1 - Model:
qwen2.5vl:7b(or another vision model you have pulled)
LM Studio
- Start the local server in LM Studio (default port 1234).
- Base URL:
http://localhost:1234/v1 - Model: the identifier shown by LM Studio.
Local models are private and free to run, but they are slower and generally less accurate than cloud models. They are a good fit for small collections or offline setups.
Use a custom provider when you have a proxy, gateway, or self-hosted server:
| Option | API style | When to use |
|---|---|---|
| Custom (OpenAI-compatible) | /chat/completions |
Anything that speaks the OpenAI API, including Azure OpenAI gateways and LiteLLM |
| Custom (Anthropic-compatible) | /messages |
Endpoints that speak the Anthropic Messages API |
Enter the Base URL and Model manually. The API key is optional — some self-hosted servers ignore it.
OpenCode Zen is an OpenAI-compatible gateway from the OpenCode team. It currently offers MiMo-V2.5 Free, a multimodal model that accepts image input:
| Setting | Value |
|---|---|
| Provider | Custom (OpenAI-compatible) |
| Base URL | https://opencode.ai/zen/v1 |
| API Key | Zen key from opencode.ai/auth |
| Model | mimo-v2.5-free |
See Recommended Models for cost notes and caveats.
Click Test / Load Models to:
- verify the API key and base URL by contacting the provider;
- download the list of available models;
- cache the list for the selected provider and base URL for 7 days.
The picker:
- shows vision-capable models only by default (based on provider modality metadata where available, and a name heuristic otherwise);
- can be filtered with the filter box — type part of a model ID to narrow the list;
- displays the number of loaded models;
- falls back to the cached list instantly on later visits.
If the provider is offline or the key is invalid, an error message explains the problem and no list is loaded.
All adapters share one abstraction with identical prompts, JSON parsing, timeouts, and friendly error messages. OpenAI, GLM, local, and custom OpenAI-compatible endpoints share one adapter; Anthropic and custom Anthropic-compatible endpoints share the native Anthropic adapter; Gemini uses its native adapter.
Images are downscaled before upload, and responses are parsed as JSON. Models without native JSON mode still work — FindRomCover extracts JSON from the response text.
FindRomCover — find and download missing cover art for your retro gaming ROM collection.
Getting Started
User Guide
- Interface Overview
- Folders & Scanning
- Local Files Search
- Web Search (Google Web & Bing Web)
- Google Custom Search API
- Image Handling
- Missing Covers List
AI Vision Assist
- AI Vision Assist
- Providers & Models
- AI Settings
- Picking Covers
- Batch Fill
- Query History
- Recommended Models
- AI Troubleshooting
Configuration
- Settings Overview
- Themes & Appearance
- Similarity Algorithms
- Supported Extensions
- Data Storage
- Logs & Diagnostics
Reference
Development
More