SDK Reference - Mesh API

MeshAPI provides official SDKs for Python, Node.js, and Go. Each SDK wraps the REST API with typed parameters, streaming helpers, and automatic retries.

Java SDK is coming soon.

Installation

Python
Node.js
Go
Java

pip install meshapi

For realtime (WebSocket) support:

pip install 'meshapi[realtime]'

Python 3.9+. Built on httpx and Pydantic v2.

npm install meshapi-node-sdk

Node 18+ is required. Node 18–21 requires npm install ws for realtime WebSocket support; Node 22+ has WebSocket built in.

go get github.com/aifiesta/meshapi-go-sdk

Go 1.21+.

Initialize the client

Python
Node.js
Go

from meshapi import MeshAPI

client = MeshAPI(
    base_url="https://api.meshapi.ai",
    token="rsk_...",
)

For async applications, use AsyncMeshAPI:

from meshapi import AsyncMeshAPI

async with AsyncMeshAPI(base_url="https://api.meshapi.ai", token="rsk_...") as client:
    ...

import { MeshAPI } from "meshapi-node-sdk";

const client = new MeshAPI({
  baseUrl: "https://api.meshapi.ai",
  token: "rsk_...",
});

import meshapi "github.com/aifiesta/meshapi-go-sdk"

client := meshapi.New(meshapi.Config{
    BaseURL: "https://api.meshapi.ai",
    Token:   "rsk_...",
})

API version

The released SDKs send no X-Mesh-Version header, so each request is served at your key’s pinned version, or the baseline 2026-08 if the key has none. A new key copies your organization’s default version, and new organizations default to the newest version, 2026-09. Check the key’s API Version under API Keys in the dashboard before you pin it. See API versioning.

What’s covered

Page	What it covers
Chat Completions	Basic chat, multi-turn, templates, async
Streaming	Streaming responses, cancellation, recovery
Structured Output	JSON schema response format
Embeddings	Single and batch embeddings
Image Generation	Generate and edit images
Audio	Text-to-speech, speech-to-text, translate to English, list voices
Video Generation	Submit tasks, poll status, list
Batches	Async batch job lifecycle
Model Compare	Fan out to multiple models
Responses API	Responses API create and stream
Prompt Templates	Create, update, delete, use in chat
RAG (Files & Search)	Upload, embed, and search documents
Realtime Audio	Bidirectional WebSocket audio sessions
Models	List, filter, search, and get models
Error Handling	Typed exceptions, error codes, retries

The SDKs also wrap content moderation (moderations.create), web search (web.search), and Auto Router model selection (router.select). Their request and response fields match the Moderations, Web search, and Router select references.

​Installation

​Initialize the client

​API version

​What’s covered

Installation

Initialize the client

API version

What’s covered