# Mercury 2.5 Preview

Model id on AIHubMix: `mercury-2.5-preview`
Create an API key: https://console.aihubmix.com/?utm_source=llms-agent&utm_medium=model-llms

> Mercury 2.5 is the latest diffusion-based large language model (dLLM) released by Inception. It is the fastest inference LLM; unlike the sequential token-by-token generation approach, Mercury 2.5 can generate and optimize multiple tokens in parallel, achieving a generation speed of 1,107 tokens per second on standard GPUs. Compared to Mercury 2, its intelligence has increased by more than 10 percentage points, and its quality rivals leading cost-optimized frontier models such as GPT-5.6 Luna (Low), Gemini 3.5 Flash-Lite, and Claude Haiku 4.5.

> Capability flags (tool use, structured output, vision, reasoning, …) are **not published** for this model. AIHubMix lists them only after official confirmation and this id is not covered yet — their absence below means unverified, not unsupported. Everything else here comes from the live catalog. Verify with a minimal real call before relying on a capability (see https://aihubmix.com/agents.md — an HTTP 200 alone is not success).

- Developer: Inception
- Context window: 260,000 tokens
- Input modalities: text
- Release date: 2026-09-02
- Pricing: $0.2/M input tokens, $0.75/M output tokens, $0.02/M cached input

## Endpoints (base URL: https://aihubmix.com)

- `POST /v1/chat/completions` — OpenAI Chat Completions (`Authorization: Bearer $AIHUBMIX_API_KEY`)

## Example

```bash
curl -s https://aihubmix.com/v1/chat/completions \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"mercury-2.5-preview","messages":[{"role":"user","content":"Hello"}]}'
```

## Response

Without `stream`, `/v1/chat/completions` returns a standard Chat Completions object:

```json
{"id":"...","object":"chat.completion","model":"mercury-2.5-preview","choices":[{"message":{"role":"assistant","content":"..."}}],"usage":{"prompt_tokens":12,"completion_tokens":24,"total_tokens":36}}
```

With `"stream": true` the response is `text/event-stream`: read each `data:` JSON chunk until `data: [DONE]`. The Messages and Gemini endpoints return their protocols' native response shapes (Anthropic / Google).

## Errors

Error responses carry a `tid` (trace id) — include it when contacting support. Reference: https://docs.aihubmix.com/en/FAQs/HTTP-Codes.md

- 400 — parameter error; most are passed through from the upstream provider (media: `prompt_missing`, `size_not_supported`, `n_not_within_range`, …)
- 401 — missing `Authorization` header, or the key is invalid/expired
- 403 — `insufficient_user_quota` (top up at https://console.aihubmix.com/?utm_source=llms-agent&utm_medium=model-llms), account suspended, or this key is not allowed to use this model
- 429 — rate limited; back off and retry
- 503 — no channel can serve the request (check the model id and your access), or the upstream provider is throttling; retry later

## More

- Model page: https://aihubmix.com/model/mercury-2.5-preview
- Try in browser: https://playground.aihubmix.com/?model=mercury-2.5-preview
- Compare with another model (human-facing, side-by-side specs and pricing): https://aihubmix.com/compare — pick this model and a peer there; published pairs are listed in https://aihubmix.com/sitemap-compare.xml, unpublished pairs 404 so do not compose the path by hand
- Full parameter schema: follow `https://aihubmix.com/model-data/index.json` — find this id and fetch its `path` (filenames are content-addressed; do not compose them by hand)
- Generate runnable code programmatically: npm `@aihubmix/codegen` — the generator behind the Playground's "Get Code" (4 protocols × 7 languages, media endpoints included); the body it builds is the exact wire body the Playground sends, so generated snippets and real requests cannot diverge. `@aihubmix/model-schema` (npm) translates the parameter schema above into codegen input
- Site index for agents: https://aihubmix.com/llms.txt · Onboarding: https://aihubmix.com/agents.md

---

Canonical version of this document: https://aihubmix.com/model/mercury-2.5-preview/llms.txt