چطور با Laguna XS 2.1 در ایران کار کنم؟

در یوتاپن ثبتنام کن، کیف پول را تومانی شارژ کن، کلید API بساز و در SDK رسمی OpenAI فقط base_url را به https://api.uttapen.ir/v1 و model را به «poolside/laguna-xs-2.1» تغییر بده. بقیهٔ کدت دستنخورده میماند.

قیمت Laguna XS 2.1 به تومان چقدر است؟

هر ۱ میلیون توکن ورودی ۱۷٬۴۰۸ تومان و هر ۱ میلیون توکن خروجی ۳۴٬۸۱۵ تومان؛ یک درخواست ۱٬۰۰۰ کلمهای تقریباً ۶۸ تومان. شارژ بر اساس مصرف واقعی همان درخواست است و درخواست ناموفق صفر تومان.

Laguna XS 2.1 چند توکن ورودی میگیرد؟

تا ۲۶۲٬۱۴۴ توکن در هر درخواست؛ برای متن فارسی حدود ۱۹۷ هزار کلمه. حداکثر طول پاسخ هم ۳۲٬۷۶۸ توکن است.

آیا Laguna XS 2.1 استریم و tool calling را پشتیبانی میکند؟

استریم (stream=true) روی همهٔ مدلها فعال است. این مدل tool calling را با همان قالب OpenAI پشتیبانی میکند.

قیمت و API مدل Laguna XS 2.1 در ایران

poolside/laguna-xs-2.1

toolsreasoning

ساخت کلید امتحان کن

ورودی · هر ۱M توکن

17,408 تومان

خروجی · هر ۱M توکن

34,815 تومان

یک درخواست ۱٬۰۰۰ کلمه‌ای ≈

68 تومان

شارژ بر اساس مصرف واقعی همان درخواست. قیمت‌ها با تغییر شرایط بازار به‌روز می‌شوند. cache ورودی: 8,704 تومان / 1M.قیمت‌ها و شارژ

کد آمادهٔ Laguna XS 2.1: حل مسئلهٔ چندمرحله‌ای با حالت استدلال

نمونه بر اساس قابلیت‌های همین مدل انتخاب شده و با کلید خودت بدون تغییر دیگری اجرا می‌شود.

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 روزی ۱۲۰ سفارش، B روزی ۸۵ و C روزی ۴۰ سفارش می‌فرستد. "
        "اگر C تعطیل شود و بارش بین A و B نسبت به ظرفیت‌شان تقسیم شود، هر کدام روزی چند سفارش می‌فرستند؟ "
        "مرحله‌به‌مرحله حساب کن و در پایان فقط دو عدد بده."
    )}],
    reasoning_effort="medium",   # low | medium | high
)
print(resp.choices[0].message.content)
# توکن‌های استدلال هم توکن خروجی حساب می‌شوند:
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": "۱۲۰ و ۸۵ سفارش روزانه بین دو انبار تقسیم می‌شود؛ مرحله‌به‌مرحله حساب کن."}],
    "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: "۱۲۰ و ۸۵ سفارش روزانه بین دو انبار تقسیم می‌شود؛ مرحله‌به‌مرحله حساب کن و در پایان فقط دو عدد بده." }],
  reasoning_effort: "medium",
});
console.log(resp.choices[0].message.content);
console.log(resp.usage.completion_tokens_details);

Laguna XS 2.1 برای چه کاری خوب است؟

Laguna XS 2.1 از Poolside می‌آید؛ در کد فقط همین رشته را در فیلد model بگذار: «poolside/laguna-xs-2.1». Laguna XS 2.1 تا ۲۶۲٬۱۴۴ توکن را در یک درخواست نگه می‌دارد (نزدیک ۱۹۷ هزار کلمهٔ فارسی)، و همین عدد سقف تاریخچهٔ گفتگو در محصول تو را تعیین می‌کند. حداکثر طول پاسخ در هر فراخوانی ۳۲٬۷۶۸ توکن است. از نظر قیمت در دستهٔ «بسیار ارزان» است — ارزان‌تر از ۱۳ مدل و گران‌تر از ۳۹۳ مدل پولی دیگر کاتالوگ.

قابلیت‌هایی که در همین شناسه فعال است: tool calling دارد، یعنی می‌تواند تابع‌های خودت را با آرگومان درست صدا بزند؛ حالت استدلال دارد و روی مسئلهٔ چندمرحله‌ای، ریاضی و دیباگ بهتر جواب می‌دهد. همهٔ این‌ها با همان پارامترهای استاندارد SDK رسمی OpenAI کار می‌کنند و کد اختصاصی لازم ندارند. توجه کن که توکن‌های استدلال هم توکن خروجی محسوب می‌شوند و در صورتحساب می‌آیند.

۱۷٬۴۰۸ تومان برای هر ۱M توکن ورودی و ۳۴٬۸۱۵ تومان برای هر ۱M توکن خروجی؛ در دستهٔ «بسیار ارزان» کاتالوگ می‌نشیند و یک درخواست ۱٬۰۰۰ کلمه‌ای ≈ ۶۸ تومان. cache ورودی دارد: توکن‌های تکراری context با ۸٬۷۰۴ تومان / ۱M حساب می‌شوند، که برای پرامپت سیستمی بلند تفاوت بزرگی است. شارژ نهایی همیشه بر اساس مصرف واقعی همان درخواست است، نه برآورد؛ درخواست ناموفق صفر تومان.

نزدیک‌ترین گزینه با همین قابلیت‌ها از تأمین‌کنندهٔ دیگر Solar Pro 4 است: Laguna XS 2.1 تقریباً 1.2 برابر گران‌تر از آن تمام می‌شود و پنجرهٔ context آن کوچک‌تر است. هر دو با همان کلید و همان کد کار می‌کنند، پس عوض‌کردن‌شان فقط تغییر یک رشته است.

برای اینکه عدد قابل تصور شود: با ۱۰۰ هزار تومان اعتبار، حدود ۱٬۴۷۱ درخواست ۱٬۰۰۰ کلمه‌ای روی Laguna XS 2.1 جا می‌شود، و هر ۱٬۰۰۰ تومان تقریباً ۱۴٬۷۰۶ کلمه رفت‌وبرگشت می‌خرد. اگر پردازشی یک میلیون توکن ورودی و یک میلیون توکن خروجی داشته باشد، کل آن ۵۲٬۲۲۳ تومان می‌شود. پر کردن کامل پنجرهٔ ۲۶۲٬۱۴۴ توکنی این مدل فقط از سمت ورودی ۴٬۵۶۳ تومان هزینه دارد، پس تاریخچهٔ گفتگو را بی‌دلیل بلند نگه ندار.

این شناسه با «poolside/laguna-xs-2.1:free» اشتباه گرفته می‌شود، چون هستهٔ مدل یکی است. تفاوت در پسوند است: بدون پسوند (نسخهٔ استاندارد) در برابر «free».

Poolside در کاتالوگ ما ۴ مدل دارد؛ ارزان‌ترین‌شان Laguna XS 2.1 با ۶۸ تومان و گران‌ترین Laguna S 2.1 با ۱۰۲ تومان برای هر ۱٬۰۰۰ کلمه. در عوض response_format، top_p، seed، structured_outputs را که بیشتر مدل‌ها دارند پشتیبانی نمی‌کند، پس اگر کدت به آن‌ها تکیه دارد قبل از جابه‌جایی تست کن. از نظر اندازهٔ context نزدیک‌ترین گزینه از تأمین‌کنندهٔ دیگر Trinity Large Thinking با ۲۶۲٬۱۴۴ توکن است.

بهترین جای استفاده‌اش: کار پرحجم مثل دسته‌بندی، برچسب‌گذاری و خلاصه‌سازی انبوه، حل مسئلهٔ منطقی و بازبینی کد، ایجنت‌هایی که به API و دیتابیس وصل می‌شوند، تحلیل سند یا کدبیس بلند در یک درخواست.

توضیح رسمی تأمین‌کننده (انگلیسی)

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...

سه کار واقعی، با قیمت همین مدل

اعداد از همان قیمت‌های بالا حساب شده‌اند و با تغییر قیمت مدل تغییر می‌کنند.

کار	توکن	هزینه
یک نوبت گفتگو با تاریخچهٔ متوسط	1,500 ورودی + 400 خروجی	40 تومان
خلاصه‌کردن سند ده‌صفحه‌ای	4,000 ورودی + 600 خروجی	91 تومان
دسته‌بندی هزار ردیف کوتاه	120,000 ورودی + 20,000 خروجی	2,785 تومان

نسخه‌های دیگر همین مدل

هستهٔ مدل یکی است؛ هر نسخه شرایط اجرا و قیمت خودش را دارد. نسخهٔ فعلی: استاندارد.

نسخه	شناسه	خروجی / ۱M	context
رایگان	poolside/laguna-xs-2.1:free	0	262,144

شناسهٔ هر نسخه را عیناً در فیلد model بگذار؛ نیازی به تغییر کد دیگری نیست.

سؤال‌های پرتکرار

چطور با Laguna XS 2.1 در ایران کار کنم؟: در یوتاپن ثبت‌نام کن، کیف پول را تومانی شارژ کن، کلید API بساز و در SDK رسمی OpenAI فقط base_url را به https://api.uttapen.ir/v1 و model را به «poolside/laguna-xs-2.1» تغییر بده. بقیهٔ کدت دست‌نخورده می‌ماند.
قیمت Laguna XS 2.1 به تومان چقدر است؟: هر ۱ میلیون توکن ورودی ۱۷٬۴۰۸ تومان و هر ۱ میلیون توکن خروجی ۳۴٬۸۱۵ تومان؛ یک درخواست ۱٬۰۰۰ کلمه‌ای تقریباً ۶۸ تومان. شارژ بر اساس مصرف واقعی همان درخواست است و درخواست ناموفق صفر تومان.
Laguna XS 2.1 چند توکن ورودی می‌گیرد؟: تا ۲۶۲٬۱۴۴ توکن در هر درخواست؛ برای متن فارسی حدود ۱۹۷ هزار کلمه. حداکثر طول پاسخ هم ۳۲٬۷۶۸ توکن است.
آیا Laguna XS 2.1 استریم و tool calling را پشتیبانی می‌کند؟: استریم (stream=true) روی همهٔ مدل‌ها فعال است. این مدل tool calling را با همان قالب OpenAI پشتیبانی می‌کند.