Laguna XS 2.1 API: toman pricing and code
poolside/laguna-xs-2.1
toolsreasoningYou are billed for the usage the request actually reported. Prices follow the market. Cached input: 8,704 toman / 1M.Pricing and top-ups
Laguna XS 2.1 example: a multi-step problem with reasoning
The example is picked from this model's own capabilities. Drop in your key and it runs as is.
from openai import OpenAI
client = OpenAI(base_url="https://api.uttapen.ir/v1", api_key="sk-up-…")
resp = client.chat.completions.create(
model="poolside/laguna-xs-2.1",
messages=[{"role": "user", "content": (
"A shop has 3 warehouses. A ships 120 orders a day, B ships 85 and C ships 40. "
"If C closes and its load is split between A and B in proportion to their capacity, how many does each ship a day? "
"Work through it step by step and give just the two numbers at the end."
)}],
reasoning_effort="medium", # low | medium | high
)
print(resp.choices[0].message.content)
# reasoning tokens count as output tokens too:
print(resp.usage.completion_tokens_details)curl https://api.uttapen.ir/v1/chat/completions \
-H "Authorization: Bearer sk-up-…" \
-H "Content-Type: application/json" \
-d '{
"model": "poolside/laguna-xs-2.1",
"messages": [{"role": "user", "content": "120 and 85 daily orders split across two warehouses; work through it step by step."}],
"reasoning": {"effort": "medium"}
}'import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uttapen.ir/v1", apiKey: "sk-up-…" });
const resp = await client.chat.completions.create({
model: "poolside/laguna-xs-2.1",
messages: [{ role: "user", content: "120 and 85 daily orders are split between two warehouses; work through it step by step and give just the two numbers at the end." }],
reasoning_effort: "medium",
});
console.log(resp.choices[0].message.content);
console.log(resp.usage.completion_tokens_details);What is Laguna XS 2.1 good for?
Laguna XS 2.1 is one of Poolside's models. Put "poolside/laguna-xs-2.1" in the model field and the rest of your code stays as it is. Laguna XS 2.1 keeps 262,144 tokens in view at once, and that number is what caps the conversation history in your product. A single response can run to 32,768 tokens. On price it sits in the "very cheap" band — cheaper than 13 and dearer than 393 of the other paid models in the catalogue.
Capabilities available on this id: it supports tool calling, so it can invoke your own functions with valid arguments; 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.
For a back-of-envelope figure: about 68 toman per 1,000-word exchange (17,408 in, 34,815 out, per 1M tokens). It supports cached input: repeated context is billed at 8,704 toman per 1M, which matters a lot if your system prompt is long. 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 Solar Pro 4: Laguna XS 2.1 works out roughly 1.2× more expensive, and its context window is smaller. Both run on the same key and the same code, so trying the other one is a single string change.
To make the figure concrete: 100,000 toman of credit buys roughly 1,471 thousand-word requests on Laguna XS 2.1, and every 1,000 toman is about 14,706 words of round trip. A job with one million input tokens and one million output tokens comes to 52,223 toman in total. Filling this model's 262,144-token window costs 4,563 toman on the input side alone, which is the real reason to keep conversation history short.
This id gets confused with "poolside/laguna-xs-2.1:free", because the underlying model is the same. The difference is the suffix: no suffix (the standard variant) against "free".
Poolside has 4 models in our catalogue; the cheapest is Laguna XS 2.1 at 68 toman per thousand words and the dearest Laguna S 2.1 at 102. It does not support response_format, top_p, seed, structured_outputs, 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 Trinity Large Thinking at 262,144 tokens.
What to use it for: high-volume work such as classification, tagging and bulk summarising, logic puzzles and code review, agents that reach out to APIs and databases, analysing a long document or codebase in one request.
Laguna XS 2.1 is the latest coding agent model in the 33B-A3B category from [Poolside](https://poolside.ai/) and a step forward from their Laguna XS.2 model (released in April 2026). It combines...
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 | 40 toman |
| Summarising a ten-page document | 4,000 in + 600 out | 91 toman |
| Classifying a thousand short rows | 120,000 in + 20,000 out | 2,785 toman |
Other variants of this model
Same core model, different execution terms and different price. This page is the standard variant.
| Variant | Model id | Output / 1M | Context |
|---|---|---|---|
| free | poolside/laguna-xs-2.1:free | 0 | 262,144 |
Put the variant's id verbatim in the model field; nothing else in your code changes.
Frequently asked
- How do I call Laguna XS 2.1 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 "poolside/laguna-xs-2.1". Nothing else in your code changes.
- What does Laguna XS 2.1 cost in toman?
- 17,408 toman per 1M input tokens and 34,815 toman per 1M output tokens; a 1,000-word request is around 68 toman. You pay for the usage that request actually reported, and a failed request costs nothing.
- How much input does Laguna XS 2.1 take?
- Up to 262,144 tokens per request, roughly 197k words. A single answer can reach 32,768 tokens.
- Does Laguna XS 2.1 support streaming and tool calling?
- Streaming (stream=true) works on every model here. This one supports tool calling in the standard OpenAI shape.