മMUSIRIZMusiriz home
Waitlist

Musiriz API

Intelligence from Keralam to your apps

The Musiriz API exposes the foundation model behind Musiriz Chat as a simple REST interface. Build Malayalam-first products — assistants, search, citizen services, content tools — without leaving Malayalam behind.

Authentication

One key. Every endpoint.

Every request is authenticated with a bearer API key. Keys are issued to waitlist members at launch and can be rotated or revoked at any time. Keep your key on the server — never ship it in a mobile app or browser bundle.

Bearer token

Send your key in the Authorization header of every request.

Server-side only

Call the API from your backend so the key never reaches end users.

Scoped & revocable

Create separate keys per app or environment, and revoke them instantly.

Authorization header
Authorization: Bearer msz-your-api-key

Endpoints

A small surface, deliberately

POST/v1/chat/completions

Chat completions

Conversational Malayalam generation — the same intelligence that powers Musiriz Chat. Send a message history, receive a Malayalam-first reply.

POST/v1/completions

Text completions

Raw text generation for Malayalam prose, poetry, translation and instruction following.

POST/v1/embeddings

Embeddings

Dense vectors for Malayalam text — semantic search, clustering and retrieval over Malayalam corpora.

GET/v1/models

List models

Discover available Musiriz model versions, their dialect coverage and context limits.

Usage examples

From zero to Malayalam in minutes

cURL
curl https://api.musiriz.ai/v1/chat/completions \
  -H "Authorization: Bearer $MUSIRIZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "musiriz-guru-v1",
    "messages": [
      { "role": "system", "content": "നിങ്ങൾ ഒരു മലയാളം സഹായിയാണ്." },
      { "role": "user", "content": "ഓണത്തിന്റെ ചരിത്രം പറഞ്ഞുതരൂ" }
    ],
    "temperature": 0.7
  }'
Python
from musiriz import Musiriz

client = Musiriz(api_key="msz-...")

response = client.chat.completions.create(
    model="musiriz-guru-v1",
    messages=[
        {"role": "user", "content": "വള്ളുവനാടൻ ശൈലിയിൽ ഒരു കവിത എഴുതൂ"}
    ],
)

print(response.choices[0].message.content)
JavaScript / TypeScript
import Musiriz from "musiriz";

const client = new Musiriz({ apiKey: process.env.MUSIRIZ_API_KEY });

const completion = await client.chat.completions.create({
  model: "musiriz-guru-v1",
  messages: [
    { role: "user", content: "കേരള സർവീസ് ചോദ്യങ്ങൾക്ക് സഹായിക്കൂ" },
  ],
});

console.log(completion.choices[0].message.content);
Response
{
  "id": "chatcmpl-msz-01",
  "object": "chat.completion",
  "model": "musiriz-guru-v1",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "ഓണം കേരളത്തിന്റെ ഏറ്റവും വലിയ ഉത്സവമാണ്…"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 24, "completion_tokens": 138 }
}

Built for every dialect

From Thiruvananthapuram to Kasaragod, one API understands them all

Musiriz is trained for the full dialect range of Malayalam, so your users can write the way they actually speak. API access opens to waitlist members first — open weights are already available on Hugging Face.

Request API accessExplore the models