# AIHubMix

> AIHubMix is a unified AI model gateway: 500+ models from OpenAI, Anthropic, Google, and leading open-source providers behind one API key, speaking four wire protocols (OpenAI Chat Completions, OpenAI Responses, Anthropic Messages, Google Gemini). Officially authorized model reseller, deployed on Google Cloud (US).

Base URL: https://aihubmix.com (alias: https://api.aihubmix.com)

## Start here (for agents)

- [Agent onboarding](https://aihubmix.com/agents.md): step-by-step setup for coding agents — auth, endpoints, end-to-end verification
- [Docs index for LLMs](https://docs.aihubmix.com/llms.txt): full documentation index; every docs page is also available as plain markdown by appending `.md`
- [Quick start](https://docs.aihubmix.com/en/quick-start.md): create an API key and make your first call

## Machine-readable data (no auth required)

- [Model catalog](https://aihubmix.com/api/v1/models?type=llm&sort_by=order): live model list with pricing and metadata (JSON)
- [Model schemas index](https://aihubmix.com/model-data/index.json): per-model capability and parameter schemas (follow each entry's `path` for the per-model JSON)
- Per-model guide: `https://aihubmix.com/model/{model_id}/llms.txt` — pricing, verified capabilities, endpoints, and a runnable example. Models not yet verified serve a short notice pointing back at the catalog and schemas above instead of unverified claims

## API endpoints

- `POST /v1/chat/completions` — OpenAI Chat Completions protocol (`Authorization: Bearer <key>`)
- `POST /v1/responses` — OpenAI Responses protocol (`Authorization: Bearer <key>`)
- `POST /v1/messages` — Anthropic Messages protocol (`x-api-key: <key>` + `anthropic-version: 2023-06-01`)
- `POST /gemini/v1beta/models/{model}:generateContent` — Google Gemini protocol (`x-goog-api-key: <key>`; use `:streamGenerateContent?alt=sse` for streaming)
- [Image generation](https://docs.aihubmix.com/en/api/Image-Gen.md): unified image API across providers
- [Async tasks](https://docs.aihubmix.com/en/api/async-tasks.md): media task lifecycle (create, poll, download, webhook) and interrupted-response recovery

## Gateway features

- [Model mapping & fallback](https://docs.aihubmix.com/en/api/Model-Mapping-Fallback.md): per-key model aliasing with automatic failover, zero client changes
- [Smart routing](https://docs.aihubmix.com/en/api/llm-router.md): set `model` to `auto` and the gateway picks the best model (cost / quality / latency strategies)
- [Structured output repair](https://docs.aihubmix.com/en/api/structured-output-repair.md): malformed JSON responses repaired at the gateway, zero client changes

## Tools for agents

- [AIHubMix Skills](https://docs.aihubmix.com/en/skills.md): agent skill for live model discovery, integration setup, runnable examples, and troubleshooting ([repo](https://github.com/AIhubmix/skills))
- [`@aihubmix/codegen`](https://www.npmjs.com/package/@aihubmix/codegen) (npm): programmatic code generation, 4 protocols × 7 languages, media included — same wire-body source as the Playground's real requests; [`@aihubmix/model-schema`](https://www.npmjs.com/package/@aihubmix/model-schema) turns canon parameter schemas into codegen input
- [Playground](https://playground.aihubmix.com/): try any model in the browser; deep link with `?model={model_id}`
- [Console](https://console.aihubmix.com/): API keys, billing, usage