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_...",
})

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 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 models, filter free/paid
Error Handling	Typed exceptions, error codes, retries

​Installation

​Initialize the client

​What’s covered

Installation

Initialize the client

What’s covered