Plan limits

What counts against your plan, and exactly what the app does when a limit is reached.

The app shows your plan's numbers right after sign-in and keeps showing them, with what is used, on the Me screen. This page explains what each number means for your photos.

AI requests per month

The free plan and every current Opensolr plan include 500 AI requests a month; opensolr.com/pricing offers bigger allowances, and the API quota page explains how requests are counted. A request is counted only when a model really ran: a picture, words or a search Opensolr already answered come from its cache and cost nothing.

A new photo
A tenth of a request, so ten photos cost one. The words, the printed text and the search vector are all inside that tenth. Only on a plan with vector search; without it nothing is read and nothing is charged.
Changed words
A tenth of a request per photo whose search vector is made again, so tagging five hundred photos at once is fifty requests.
A typed search
A tenth of a request per search by meaning.
A Reset
A tenth of a request per photo whose search vector has to be made again; no picture is read.
When
Your edits are saved on the phone first; the charge, if any, lands on the sync that carries them up.
Vector search

Without it no photo is read: photos are indexed by date, camera, place, file name and your own words, and found by those words. See without photo recognition.

What uses it
Reading photos, and search by meaning.
Disk space

Descriptions only, never pictures.

What uses it
The photo documents in the index.
Search bandwidth

Resets every month.

What uses it
The searches you type, the one read of the whole index into the phone's own copy after an install or a reinstall, and the syncs that actually write something.
What saves it
The phone's copy of the index: browsing, Stats, the tag suggestions and the comparison a sync makes ask the index nothing. The filter lists are asked for once and kept until something is written. And the search cache reuses answers for as long as you choose.
Indexes

Creating the phone's index fails when the account has no room left.

What uses it
One per phone.
01 · Photos per month

One AI request covers ten photos, so Photos per month is the monthly AI allowance times ten, and Photos left this month does the same with what is left of it. A plan with no monthly cap shows No monthly cap.

A picture is read once

Opensolr keeps what it read: a picture it has already read comes from its cache, so a reinstall, a lost index or a Reset never pays for reading the same pictures again. A reinstall reads the whole index back into the phone's copy once, and that one read counts against search bandwidth.

On a plan without vector search, see what works and what does not.

02 · Warnings before a limit

At 90% of the disk space, of the month's search bandwidth or of the month's AI requests, and again at the limit, the app posts one notification and shows the same warning in the Account stats group of the Me screen. A plan without photo recognition is said there too: Photos are not recognised on your plan. Each notification is posted once; the monthly ones come back every month.

03 · What happens at a limit
AI requests

Nothing stops. New photos are still indexed with everything the phone knows about them (date, camera, place, file name, your words), only without being read and without a vector; the Sync screen says how many. At the first sync after the allowance resets, or after an upgrade, those photos are read. A photo already in the index keeps what was read out of it, as long as it is the same file. Search runs on words only meanwhile.

Effect
Indexing continues without words and vectors; search by meaning falls back to words.
Disk space or bandwidth

A notification that opens your Opensolr account; the Sync screen says the index reached its disk space or bandwidth. Tagging is not blocked: tags and names go on being saved on the phone while the index is closed, and go up on the first sync after the limit clears.

Effect
Opensolr closes the index to requests until it is back under the limit; sync stops.
Indexes

The setup screen says: Your Opensolr plan cannot hold another index. Remove an index you no longer use.

Effect
The phone's index cannot be created.

Nothing is lost. After an upgrade, or when the month rolls over, the next sync continues where the last one stopped. The notification and the Me screen open your Opensolr account on opensolr.com in your browser.

Your Opensolr account

Opensolr Photos is open source and MIT licensed. Questions about your Opensolr account, index or plan go to opensolr.com/contact; questions about the app itself belong on GitHub.

Opensolr Photos Documentation