# Dots 3 Note Preview (free)

Model id on AIHubMix: `dots-3-note-preview-free`
Create an API key: https://console.aihubmix.com/

> Dots3-Note Preview is an open-weight mixture-of-experts model developed by Dots Studio, featuring 16B active parameters out of 280B total. As the lightest model in the Dots 3 family, it is designed for efficient performance while supporting an expansive context length of 512,000 tokens. This preview version provides an accessible way to experience the capabilities of the Dots 3 architecture.

- Developer: Dots Studio
- Context window: 512,000 tokens
- Input modalities: text, image
- Capabilities: Thinking, Tool calling, Document input
- Pricing: free tier / see model page

## 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":"dots-3-note-preview-free","messages":[{"role":"user","content":"Hello"}]}'
```

## Response

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

```json
{"id":"...","object":"chat.completion","model":"dots-3-note-preview-free","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/), 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/dots-3-note-preview-free
- Try in browser: https://playground.aihubmix.com/?model=dots-3-note-preview-free
- Compare with another model (human-facing, side-by-side specs and pricing): https://aihubmix.com/compare/dots-3-note-preview-free/{other_model_id}
- Full parameter schema (machine-readable, authoritative): https://aihubmix.com/model-data/models/dots-3-note-preview-free.e37d34c0.json — per-protocol parameters with types, ranges, enums and defaults. Refreshed together with this page; if it ever 404s, re-resolve via `https://aihubmix.com/model-data/index.json` (find this id, fetch its `path`)
- 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/dots-3-note-preview-free/llms.txt