OpenRouter
Adapter key openrouter. Native reranking and the primary rerank model catalog.
{
"publicModel": "search-reranker",
"adapterKey": "openrouter",
"upstreamModel": "cohere/rerank-4-fast",
"credentials": { "apiKey": "sk-or-..." }
}- Credentials:
apiKeyis required.baseUrland customheadersare optional. The default base URL ishttps://openrouter.ai/api/v1. - Operation: reranking only in this release. The adapter sends
POST /rerankthrough the nativeopenrouter_reranktransport. - Provider routing: the public
providerobject is preserved exactly and makes only OpenRouter deployments eligible for that request. - Model ids: use OpenRouter's complete ids, including creator and suffixes such as
:free. - Catalog: the committed catalog is generated from OpenRouter's model feed filtered by
output_modalities=rerank. No expected model count is hard-coded. - Text-only release: multimodal source capability is reported by the sync but withheld from the public profile. The NVIDIA vision reranker therefore accepts text documents only for now.
- Pricing: ambiguous zero token fields do not mark paid rerankers free. Reviewed search-unit overrides are used where available; otherwise OpenRouter's response cost is the accounting fallback.
Catalog workflow:
bun run --filter @boelabs/bifrost catalog:sync:openrouter
bun run --filter @boelabs/bifrost catalog:sync:openrouter:verify
# To update the committed snapshot after review:
bun run --filter @boelabs/bifrost catalog:sync:openrouter:writeThe report calls out multimodal capability not yet enabled, ambiguous zero pricing, orphaned reviewed overrides, and paid models without a representable local cost.
What to read next
- Reranking — public contract, routing, validation, and examples.
- Model catalog — sync ownership and schema.
- Routing — retries, fallback, health, and price strategy.