چطور با Gemma 4 31B (free) در ایران کار کنم؟

در یوتاپن ثبتنام کن، کیف پول را تومانی شارژ کن، کلید API بساز و در SDK رسمی OpenAI فقط base_url را به https://api.uttapen.ir/v1 و model را به «google/gemma-4-31b-it:free» تغییر بده. بقیهٔ کدت دستنخورده میماند.

قیمت Gemma 4 31B (free) به تومان چقدر است؟

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

Gemma 4 31B (free) چند توکن ورودی میگیرد؟

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

آیا Gemma 4 31B (free) استریم و tool calling را پشتیبانی میکند؟

استریم (stream=true) روی همهٔ مدلها فعال است. این مدل tool calling را با همان قالب OpenAI پشتیبانی میکند. ورودی تصویر با image_url (data URI یا آدرس عمومی) پذیرفته میشود. خروجی ساختیافته با response_format هم کار میکند.

محدودیت مدل رایگان چیست؟

مدلهای رایگان سقف روزانه بهازای هر کاربر دارند و ظرفیتشان بین همهٔ کاربران مشترک است؛ وقتی ظرفیت مشترک تمام شود، درخواست با خطای مشخص رد میشود و کیف پولت دستنخورده میماند.

قیمت و API مدل Gemma 4 31B (free) در ایران

google/gemma-4-31b-it:free

رایگان · ظرفیت محدودvisiontoolsreasoningjson

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

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

0 تومان

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

0 تومان

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

0 تومان

شارژ بر اساس مصرف واقعی همان درخواست. قیمت‌ها با تغییر شرایط بازار به‌روز می‌شوند.قیمت‌ها و شارژ

کد آمادهٔ Gemma 4 31B (free): خواندن تصویر و استخراج داده

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

# 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": "google/gemma-4-31b-it:free",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "شمارهٔ فاکتور و مبلغ کل را فقط به‌صورت 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="google/gemma-4-31b-it:free",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "شمارهٔ فاکتور، تاریخ و مبلغ کل را در 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: "google/gemma-4-31b-it:free",
  messages: [{
    role: "user",
    content: [
      { type: "text", text: "شمارهٔ فاکتور، تاریخ و مبلغ کل را در 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));

Gemma 4 31B (free) برای چه کاری خوب است؟

Gemma 4 31B (free) یکی از مدل‌های Google است و در یوتاپن با شناسهٔ «google/gemma-4-31b-it:free» صدا زده می‌شود. در هر فراخوانی تا ۲۶۲٬۱۴۴ توکن ورودی می‌پذیرد؛ برای متن فارسی این تقریباً ۶۵۵ صفحهٔ A4 است، پس چند فایل یا یک سند بلند را می‌شود یک‌جا داد. حداکثر طول پاسخ در هر فراخوانی ۳۲٬۷۶۸ توکن است. استفاده از آن هزینه‌ای ندارد؛ در عوض ظرفیت مشترک است، پس در ساعت‌های شلوغ ممکن است پاسخ نگیری.

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

برای برآورد سرانگشتی: هر ۱٬۰۰۰ کلمه رفت‌وبرگشت با این مدل حدود ۰ تومان است (۰ تومان ورودی و ۰ تومان خروجی به‌ازای ۱M توکن). شارژ نهایی همیشه بر اساس مصرف واقعی همان درخواست است، نه برآورد؛ درخواست ناموفق صفر تومان.

نزدیک‌ترین گزینه با همین قابلیت‌ها از تأمین‌کنندهٔ دیگر Dots3-Note Preview (free) است و پنجرهٔ context آن کوچک‌تر است. هر دو با همان کلید و همان کد کار می‌کنند، پس عوض‌کردن‌شان فقط تغییر یک رشته است.

این شناسه با «google/gemma-4-31b-it» اشتباه گرفته می‌شود، چون هستهٔ مدل یکی است. تفاوت در پسوند است: «free» در برابر نسخهٔ استاندارد. حداکثر طول پاسخ هم فرق دارد: ۳۲٬۷۶۸ در برابر ۱۶٬۳۸۴ توکن. در پارامترها آن یکی frequency_penalty، logit_bias، logprobs، min_p را.

Google در کاتالوگ ما ۴۵ مدل دارد؛ ارزان‌ترین‌شان Gemma 3 4B با ۵۷ تومان و گران‌ترین Google Gemini Pro Latest با ۵٬۲۸۰ تومان برای هر ۱٬۰۰۰ کلمه. در عوض structured_outputs را که بیشتر مدل‌ها دارند پشتیبانی نمی‌کند، پس اگر کدت به آن‌ها تکیه دارد قبل از جابه‌جایی تست کن. از نظر اندازهٔ context نزدیک‌ترین گزینه از تأمین‌کنندهٔ دیگر Trinity Large Thinking با ۲۶۲٬۱۴۴ توکن است.

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

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

Gemma 4 31B Instruct is Google DeepMind's 30.7B dense multimodal model supporting text and image input with text output. Features a 256K token context window, configurable thinking/reasoning mode, native function...

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

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

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

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

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

نسخه	شناسه	خروجی / ۱M	context
استاندارد	google/gemma-4-31b-it	98,643	262,144
batch (ارزان‌تر، کندتر)	google/gemma-4-31b-it:batch	281,421	262,144

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

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

چطور با Gemma 4 31B (free) در ایران کار کنم؟: در یوتاپن ثبت‌نام کن، کیف پول را تومانی شارژ کن، کلید API بساز و در SDK رسمی OpenAI فقط base_url را به https://api.uttapen.ir/v1 و model را به «google/gemma-4-31b-it:free» تغییر بده. بقیهٔ کدت دست‌نخورده می‌ماند.
قیمت Gemma 4 31B (free) به تومان چقدر است؟: هر ۱ میلیون توکن ورودی ۰ تومان و هر ۱ میلیون توکن خروجی ۰ تومان؛ یک درخواست ۱٬۰۰۰ کلمه‌ای تقریباً ۰ تومان. شارژ بر اساس مصرف واقعی همان درخواست است و درخواست ناموفق صفر تومان.
Gemma 4 31B (free) چند توکن ورودی می‌گیرد؟: تا ۲۶۲٬۱۴۴ توکن در هر درخواست؛ برای متن فارسی حدود ۱۹۷ هزار کلمه. حداکثر طول پاسخ هم ۳۲٬۷۶۸ توکن است.
آیا Gemma 4 31B (free) استریم و tool calling را پشتیبانی می‌کند؟: استریم (stream=true) روی همهٔ مدل‌ها فعال است. این مدل tool calling را با همان قالب OpenAI پشتیبانی می‌کند. ورودی تصویر با image_url (data URI یا آدرس عمومی) پذیرفته می‌شود. خروجی ساخت‌یافته با response_format هم کار می‌کند.
محدودیت مدل رایگان چیست؟: مدل‌های رایگان سقف روزانه به‌ازای هر کاربر دارند و ظرفیت‌شان بین همهٔ کاربران مشترک است؛ وقتی ظرفیت مشترک تمام شود، درخواست با خطای مشخص رد می‌شود و کیف پولت دست‌نخورده می‌ماند.