Cohere

The Cohere adapter is rerank-focused. It exposes one capability:

• Reranking (cohereRerank) — reorder documents by relevance to a query via rerank().

It does not support text chat(), summarize(), embeddings, or media — use OpenAI, Anthropic, or Gemini for those. The adapter talks to Cohere's /v2/rerank endpoint directly over fetch (no SDK dependency).

Installation#

npm install @tanstack/ai-cohere

Peer dependency:

npm install @tanstack/ai

Basic Usage#

import { rerank } from '@tanstack/ai'
import { cohereRerank } from '@tanstack/ai-cohere'

const { rerankedDocuments } = await rerank({
  adapter: cohereRerank('rerank-v3.5'),
  query: 'talk about rain',
  documents: ['sunny day at the beach', 'rainy afternoon in the city'],
})

console.log(rerankedDocuments[0]) // 'rainy afternoon in the city'

For the full reranking guide — object documents, RAG pipelines, options, and the result shape — see Reranking.

Models#

Configuration#

cohereRerank(model, config?) reads COHERE_API_KEY from the environment. config accepts:

Provider Options#

Per-request options are passed via modelOptions on rerank():

import { rerank } from '@tanstack/ai'
import { cohereRerank } from '@tanstack/ai-cohere'

const { ranking } = await rerank({
  adapter: cohereRerank('rerank-v3.5'),
  query: 'refund policy',
  documents: ['Returns accepted within 30 days.', 'Free shipping over $50.'],
  modelOptions: {
    maxTokensPerDoc: 512, // Cap tokens kept per document (Cohere default: 4096)
  },
})

console.log(ranking)

Explicit API Keys#

To pass an API key directly instead of reading the environment:

import { createCohereRerank } from '@tanstack/ai-cohere'

const adapter = createCohereRerank('rerank-v3.5', 'your-cohere-api-key')

Environment Variables#

COHERE_API_KEY=your-cohere-api-key

Get your API key from the Cohere dashboard.

API Reference#

cohereRerank(model, config?)#

Creates a Cohere rerank adapter for use with rerank(), reading COHERE_API_KEY from the environment.

createCohereRerank(model, apiKey, config?)#

Same as cohereRerank, but takes an explicit API key.

Limitations#

• Rerank only — Use OpenAI, Anthropic, or Gemini for chat(), summarize(), embeddings, or media generation.

Next Steps#

• Reranking Guide — full walkthrough including RAG pipelines
• OpenAI Adapter — text, embeddings, and media