# Embeddings

> Convert text into numeric vectors for semantic search, clustering, recommendations, and RAG pipelines.

- Canonical: https://tchavi.com/en/docs/embeddings

---


<Endpoint method="POST" path="/v1/embeddings" />

Embeddings convert text into a numeric vector that captures its semantic meaning. Use them for **semantic search** (find content by meaning, not keywords), **clustering** similar documents, **recommendations**, and **RAG** (retrieval-augmented generation) pipelines.

## Example

<CodeTabs>

```tchavi
import Tchavi from '@tchavi/sdk';

const client = new Tchavi({ apiKey: 'YOUR_API_KEY' });

const response = await client.embeddings.create({
  model: 'text-embedding-3-small',
  input: 'Tchavi is the best AI API gateway in Africa.',
});

console.log(response.data[0].embedding);
```

```openai
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://tchavi.com/api/v1",
)

response = client.embeddings.create(
    model="text-embedding-3-small",
    input="Tchavi is the best AI API gateway in Africa.",
)

print(response.data[0].embedding)
```

```javascript
const response = await fetch('https://tchavi.com/api/v1/embeddings', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
  },
  body: JSON.stringify({
    model: 'text-embedding-3-small',
    input: 'Tchavi is the best AI API gateway in Africa.',
  }),
});

const data = await response.json();
console.log(data.data[0].embedding);
```

```python
import requests

response = requests.post(
    "https://tchavi.com/api/v1/embeddings",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_API_KEY",
    },
    json={
        "model": "text-embedding-3-small",
        "input": "Tchavi is the best AI API gateway in Africa.",
    },
)

data = response.json()
print(data["data"][0]["embedding"])
```

```curl
curl -X POST https://tchavi.com/api/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "Tchavi is the best AI API gateway in Africa."
  }'
```

</CodeTabs>