Skip to main content
The Mesh API provides a unified interface for accessing various AI models through a single API key. This interactive reference allows you to explore the available endpoints, test them directly in the browser, and see code snippets in your preferred language.

​
Key Features

  • Chat Completions: OpenAI-compatible text, multimodal, tool-calling, and streaming inference.
  • Messages and Responses: Anthropic-compatible POST /v1/messages, and the Responses API for reasoning models.
  • Embeddings and RAG: Dense vectors, plus file upload, embedding, and semantic search over your own documents.
  • Images, Audio, and Video: Image generation and editing, text-to-speech, transcription and translation, and asynchronous video generation.
  • Compare and Batches: Run one prompt across several models, or submit asynchronous batch jobs and read results inline.
  • Web search, Moderations, and Evaluate: Ranked web results, content classification, and typed probability answers from evaluation models.
  • Auto Router: Ask which model best fits a request (POST /v1/router/select).
  • Model Discovery, Templates, and Memory: Browse and search the catalog, version and publish prompt templates, and attach per-user memory to requests.
  • Account: Balance, usage and rate-limit reports, audit logs, admin keys, end-user data erasure, and API versions.
Realtime audio (WebSocket) and the MCP server are documented in their own guides, not in this reference.

​
Base URL

All API requests should be made to:

​
Authentication

The Mesh API uses Bearer token authentication. You can obtain your API key from the Mesh developer dashboard.

​
Versioning

The /v1 in every endpoint path is a stable namespace, not a version. Mesh versions its contract by date, in a header. The newest version is 2026-09:
Send no header and you get your key’s pinned version, or the oldest supported version (2026-08) if the key has none. A new key copies your organization’s default version, and new organizations default to the newest version, so check the key’s API Version under API Keys before you pin it. An unsupported version is rejected with 400 invalid_api_version rather than silently downgraded. See API versioning.

​
Interactive Explorer

You can use the “Try It” button on any endpoint to send real requests to the Mesh API. Make sure to provide your API key in the authentication section.