{"uid":"cap_7-T5fye5M9v-BXVgBEZyp","slug":"vektorwerk-similarity-scorer-e6af4354","name":"Vektorwerk Similarity Scorer","description":"Embeds one query and up to 64 candidates locally, then returns cosine scores and stable descending ranks.","url":"https://vektor.halowerk.com/similarity","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"model":{"enum":["nomic","bge_m3"],"type":"string","default":"nomic"},"query":{"type":"string"},"candidates":{"type":"array","items":{"type":"string"},"maxItems":64,"minItems":1}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_n56_SC-G-j10e7eR87Wua","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Embeds a query and up to 64 candidate strings locally, then returns cosine similarity scores and stable descending ranks for each candidate.","exampleAgentPrompt":"Score and rank these 5 candidate answers against my query 'how do I reset my password?' using the nomic model: 'click forgot password on the login page', 'update your profile settings', 'contact support by email', 'use the reset link sent to your inbox', 'log out and log back in'.","exampleUseCases":[{"title":"FAQ routing for support chatbot","prompt":"I have a user question 'why was I charged twice?' and a list of 20 FAQ entries — can you rank those FAQ entries by how closely they match the question using the bge_m3 model so I can surface the top answer?"},{"title":"Semantic product search reranking","prompt":"I've retrieved 30 product titles from my catalog and I want to rank them by how relevant they are to the search query 'lightweight running shoes for hot weather' — use the nomic model to score and rank them for me."},{"title":"Best-match candidate selection for RAG","prompt":"I have a query 'what are the side effects of ibuprofen?' and 15 document chunks — score each chunk by cosine similarity to the query using the nomic model so I can pick the top 3 to pass to the language model."}],"resultDescription":"Returns a list of candidate strings paired with their cosine similarity scores relative to the query, sorted in stable descending order by score, so the most semantically relevant candidate appears first.","failureModes":["More than 64 candidates provided — API rejects with validation error","Empty candidates array (below minItems of 1) — validation error returned","Invalid model name outside 'nomic' or 'bge_m3' enum — request rejected","Query string is empty or missing — request fails validation","Service unavailable or local Ollama runtime down — connection error or 5xx response"],"whenToPreferThis":"Prefer this endpoint when you need fast, local semantic similarity scoring or reranking of up to 64 candidates against a single query without relying on a third-party cloud embedding provider. Ideal for RAG pipelines needing a cheap ($0.001/call) reranking step, FAQ matching, or any scenario where cosine similarity over a small fixed candidate set is sufficient and data privacy or latency matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:34:11.708Z","isFirstParty":false}