MindsHub Inference

Chat, embeddings, and decisions, on one MindsHub key and one bill.

Call Claude, GPT, Gemini, Kimi, DeepSeek, Qwen, Grok and more from a single endpoint, using whichever request format your code already speaks. Same key, same models, same features through all three, and any chat model works behind any of these three chat APIs: drive Claude Fable from the OpenAI SDK, or GPT 5.6 Sol from the Anthropic SDK, and neither client knows the difference.

Chat Completions

POST /v1/chat/completions. OpenAI SDKs and most of the ecosystem. Start here.

Responses

POST /v1/responses. OpenAI SDKs, server-side conversation state, Codex.

Messages

POST /v1/messages. Anthropic SDKs and Claude Code.

For classification, scoring, and yes/no judgments, use Jev decision models through POST /v1/decisions. Start with the three-question example.

The one-minute version

Get a key at console.mindshub.ai, export it as MINDSHUB_API_KEY, and point the SDK you already use at https://api.mindshub.ai/v1. New organizations get a recurring weighted allowance on mindshub_air, so their first calls cost nothing.

Python
TypeScript

from openai import OpenAI
import os

client = OpenAI(base_url="https://api.mindshub.ai/v1", api_key=os.environ["MINDSHUB_API_KEY"])
response = client.chat.completions.create(
    model="mindshub_air",
    messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.mindshub.ai/v1", apiKey: process.env.MINDSHUB_API_KEY });
const response = await client.chat.completions.create({
  model: "mindshub_air",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(response.choices[0].message.content);

The same call in curl, and the same request through all three APIs, is in Getting started.

Start here

Getting started

Key to working app: one request, three ways, then switch models by editing one string.

Choosing an API

Choose between chat, embeddings, and decisions, then pick a request format.

Models

The catalog and its aliases.

Capability matrix

Every feature and parameter, per API and per model, generated from the code.

Guides

The decision-model guide explains Jev and its typed answers. The chat guides below show each feature across the three chat APIs.

Why teams use it

Keep your SDK. No MindsHub SDK to learn, no wrapper to install. Point the official openai or @anthropic-ai/sdk client at our base URL and your existing code runs.

Switch models by editing one string. "model": "sonnet" becomes "model": "kimi". No new client, no new credential, no re-plumbing. Benchmark Claude Opus 5 against DeepSeek V4-Pro-0813 on your real prompts in an afternoon.

One bill for everything. Paid usage draws the same prepaid balance; promotions and included allowances apply as described in Billing. Check consumption and balance through the account endpoints, coding agents included.

Chat parameters are adapted. Chat models disagree about what they accept. Rather than 400-ing because one model dislikes top_k, MindsHub drops or clamps what the target model can't take and tells you in a response header. How that works.

Your coding agents come along. Claude Code points at MindsHub with two environment variables and runs on chat models in the catalog. Codex does the same with one config block.