# Cohere API

**Provider:** Cohere
**Category:** ai
**Base URL:** `https://api.cohere.com/v2`
**Auth:** bearer — `Authorization: Bearer YOUR_COHERE_API_KEY`
**Rate Limit:** 100 API calls/min (trial) · Higher on production
**Free Tier:** Yes — [object Object]
**Pricing:** Pay per use (pay-as-you-go)
**Docs:** https://docs.cohere.com

## Description

Cohere provides production-ready language AI for enterprise teams. Command R+ leads on RAG benchmarks, making it ideal for grounded enterprise search. The Embed v3 model produces high-quality text embeddings for semantic search and retrieval. The Rerank endpoint improves search accuracy by reordering candidate results. All models have built-in tool use (function calling) and citation support for RAG pipelines.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `https://api.cohere.com/v2/chat` | Chat with Command R / R+ with optional tool use and RAG |
| POST | `https://api.cohere.com/v2/embed` | Generate embeddings for semantic search and classification |
| POST | `https://api.cohere.com/v2/rerank` | Rerank search results by relevance to a query |
| POST | `https://api.cohere.com/v2/classify` | Classify text into predefined categories |

## Authentication

Create an API key at dashboard.cohere.com. Pass it as a Bearer token in the Authorization header.

```
Authorization: Bearer YOUR_COHERE_API_KEY
```

## Sample Request

```bash
curl "https://api.cohere.com/v2/chat" \
  -H "Authorization: Bearer $COHERE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"command-r-plus","messages":[{"role":"user","content":"Summarize the benefits of RAG for enterprise AI."}]}'
```

## Sample Response

```json
{
  "id": "abc123",
  "message": {
    "role": "assistant",
    "content": [{"type":"text","text":"RAG (Retrieval-Augmented Generation) benefits include..."}]
  },
  "finish_reason": "COMPLETE",
  "usage": { "billed_units": { "input_tokens": 24, "output_tokens": 112 } }
}
```

## Pricing Details

Command R+: $2.50/M in, $10/M out. Command R: $0.15/M in, $0.60/M out. Command R7B: $0.0375/M in, $0.15/M out. Embed: $0.10/M tokens. Rerank: $2/1k queries.

---

*Source: [API Map](https://apimap.dev/apis/cohere/) — CC BY 4.0*