Dots3-Note Preview (free) API: toman pricing and code
dots-studio/dots-3-note-preview:free
Free · shared capacityvisiontoolsreasoningjsonYou are billed for the usage the request actually reported. Prices follow the market.Pricing and top-ups
Dots3-Note Preview (free) example: reading an image into JSON
The example is picked from this model's own capabilities. Drop in your key and it runs as is.
# tip: a data URI works too — base64 the file and prefix it with data:image/jpeg;base64,
curl https://api.uttapen.ir/v1/chat/completions \
-H "Authorization: Bearer sk-up-…" \
-H "Content-Type: application/json" \
-d '{
"model": "dots-studio/dots-3-note-preview:free",
"messages": [{
"role": "user",
"content": [
{"type": "text", "text": "Return only the invoice number and the total, as JSON."},
{"type": "image_url", "image_url": {"url": "https://example.com/factor.jpg"}}
]
}]
}'import base64, json
from openai import OpenAI
client = OpenAI(base_url="https://api.uttapen.ir/v1", api_key="sk-up-…")
img = base64.b64encode(open("factor.jpg", "rb").read()).decode()
resp = client.chat.completions.create(
model="dots-studio/dots-3-note-preview:free",
messages=[{
"role": "user",
"content": [
{"type": "text", "text": "Return the invoice number, the date and the total as JSON."},
{"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{img}"}},
],
}],
response_format={"type": "json_object"},
)
print(json.loads(resp.choices[0].message.content))import OpenAI from "openai";
import { readFileSync } from "node:fs";
const client = new OpenAI({ baseURL: "https://api.uttapen.ir/v1", apiKey: "sk-up-…" });
const img = readFileSync("factor.jpg").toString("base64");
const resp = await client.chat.completions.create({
model: "dots-studio/dots-3-note-preview:free",
messages: [{
role: "user",
content: [
{ type: "text", text: "Return the invoice number, the date and the total as JSON." },
{ type: "image_url", image_url: { url: `data:image/jpeg;base64,${img}` } },
],
}],
response_format: { type: "json_object" },
});
console.log(JSON.parse(resp.choices[0].message.content));What is Dots3-Note Preview (free) good for?
Dots3-Note Preview (free) is one of Dots Studio's models. Put "dots-studio/dots-3-note-preview:free" in the model field and the rest of your code stays as it is. Dots3-Note Preview (free) keeps 512,000 tokens in view at once, and that number is what caps the conversation history in your product. A single response can run to 460,800 tokens. It is free: nothing leaves your wallet. The capacity is shared across all users and there is a daily cap per account, so treat it as a testing lane rather than a production dependency.
What it can do beyond plain text: it reads images directly, which makes it a real option for invoices, forms and screenshots; it supports tool calling, so it can invoke your own functions with valid arguments; it returns schema-valid JSON through response_format, ready to hand to your code; it has a reasoning mode that pays off on multi-step problems, maths and debugging. All of it works through the standard parameters of the official OpenAI SDK — no custom client, no wrapper. Keep in mind that reasoning tokens are output tokens and do appear on the bill.
Pricing is 0 toman per 1M input tokens and 0 per 1M output tokens. A 1,000-word round trip on Dots3-Note Preview (free) lands near 0 toman. You are always charged for the usage the request actually reported, never for the estimate, and a failed request costs nothing.
The closest alternative with the same capabilities from a different provider is Gemma 4 26B A4B (free), and its context window is larger. Both run on the same key and the same code, so trying the other one is a single string change.
It does not support seed, which most models here do, so test before switching if your code relies on them. By context size the nearest option from another provider is Grok 4.5 at 500,000 tokens.
Good fits: proving an idea works before you spend anything, logic puzzles and code review, pulling text and fields out of images, agents that reach out to APIs and databases, extracting data against a fixed schema, analysing a long document or codebase in one request.
Dots3-Note Preview is an open-weight mixture-of-experts model from Dots Studio, with 16B active parameters out of 280B total. It is the lightest model in the Dots 3 family and is...
Three real jobs, priced on this model
Each figure is derived from the prices above and moves when they do.
| Job | Tokens | Cost |
|---|---|---|
| One chat turn with a medium history | 1,500 in + 400 out | 0 toman |
| Summarising a ten-page document | 4,000 in + 600 out | 0 toman |
| Classifying a thousand short rows | 120,000 in + 20,000 out | 0 toman |
Frequently asked
- How do I call Dots3-Note Preview (free) from Iran?
- Sign up with your mobile number, top the wallet up in toman, create an API key, then in the official OpenAI SDK point base_url at https://api.uttapen.ir/v1 and set model to "dots-studio/dots-3-note-preview:free". Nothing else in your code changes.
- What does Dots3-Note Preview (free) cost in toman?
- 0 toman per 1M input tokens and 0 toman per 1M output tokens; a 1,000-word request is around 0 toman. You pay for the usage that request actually reported, and a failed request costs nothing.
- How much input does Dots3-Note Preview (free) take?
- Up to 512,000 tokens per request, roughly 384k words. A single answer can reach 460,800 tokens.
- Does Dots3-Note Preview (free) support streaming and tool calling?
- Streaming (stream=true) works on every model here. This one supports tool calling in the standard OpenAI shape. Image input is accepted through image_url, as a data URI or a public URL. Structured output through response_format works too.
- What are the limits on a free model?
- Free models have a daily per-user cap and their capacity is shared with everyone else. When the shared pool is exhausted the request is refused with a clear error and your wallet is untouched.