Connection guide

Bring a reference into your assistant.

Choose how you work, connect your account, then try a search. Browsing and saving on this website are free.

1. Create a personal API key

Create a named key in your workspace. Copy it when it appears; the full key is shown once.

2. Send a search request

Replace YOUR_API_KEY locally. Keep the key in your application's secrets, outside source control.

curl --get 'https://refmori.oddloaf.dev/api/v1/references/' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  --data-urlencode 'query=両手ハート' \
  --data 'kind=pose' \
  --data 'limit=3' \
  --data 'include_images=true'

JSON includes results, source notes, optional Base64 images and usage. The retrieval field identifies the search method; fallback_reason explains when keyword search was used because semantic search was unavailable. Each image's reference_id and each result's image_index identify its reference. The API defaults to links; include_images=true requests available image data. Read a selected result with GET /api/v1/references/<id>/?angle=side. Direct reads use zero search units; a missing view returns view_unavailable.

Troubleshooting and limits

The tool is missing: Save, reconnect or restart the client. Check that Refmori is enabled and authorized.
I get links instead of pictures: Some sources are link-only. Open the supplied image link; enabling images does not change a source's delivery permission.
No results match: Describe the reference another way, try a catalog keyword or remove the camera filter. If semantic search is unavailable, keyword matches remain available.
Limits and charges: API and MCP share your account allowance. Free includes 300 searches each UTC calendar month; paid allowances renew with your billing cycle. Nonempty searches use one unit, including keyword fallback results. Empty results and image retrieval failures use zero. Image-enabled searches return at most three references. Direct reads consume zero search units; all tool requests share your plan's per-minute limit. Demo illustrations are excluded unless include_demo=true. Compare plans.