Sawalni API
APIsDocumentationOpen portal ↗
Omneity Labs API collection ↗Integration quickstart →API keys and playgrounds →
API Reference

Embeddings API

Convert text into high-dimensional vectors for semantic search, clustering, and similarity.

Endpoint

text
POST https://api.sawalni.com/v1/embeddings

Request Body

ParameterTypeRequiredDescription
modelstringYesmadmon-beta
inputstring or arrayYesText(s) to embed

Example — Python

python
from openai import OpenAI client = OpenAI( api_key="YOUR_API_KEY", base_url="https://api.sawalni.com/v1" ) response = client.embeddings.create( model="madmon-beta", input="الذكاء الاصطناعي يغير العالم" ) embedding = response.data[0].embedding print(f"Dimensions: {len(embedding)}")

Example — curl

bash
curl https://api.sawalni.com/v1/embeddings \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "madmon-beta", "input": "الذكاء الاصطناعي يغير العالم" }'

Response

json
{ "object": "list", "data": [ { "object": "embedding", "index": 0, "embedding": [0.0023, -0.009, 0.015, ...] } ], "model": "madmon-beta", "usage": { "prompt_tokens": 8, "total_tokens": 8 } }

Batch Embedding

Pass an array of strings to embed multiple texts in a single request:

python
response = client.embeddings.create( model="madmon-beta", input=[ "أول نص", "ثاني نص", "ثالث نص" ] ) for item in response.data: print(f"Index {item.index}: {len(item.embedding)} dimensions")

Use Cases

  • Semantic search — Find similar documents by vector proximity
  • Clustering — Group related texts together
  • Classification — Use embeddings as features for ML models
  • Recommendations — Find related content based on similarity

Model Details

PropertyValue
Model IDmadmon-beta
Max Input8,000 tokens