ساخت کلید API

قیمت و API مدل Gemini 3.7 Flash در ایران

google/gemini-3.7-flash

ورودی تصویرفراخوانی ابزاراستدلالخروجی JSONورودی فایلورودی صوت
ساخت کلیدامتحان کن
ورودی · هر ۱M توکن
۲۵۹٬۶۶۵ تومان
خروجی · هر ۱M توکن
۱٬۲۹۸٬۳۲۳ تومان
یک درخواست ۱٬۰۰۰ کلمه‌ای ≈
۲٬۰۲۵ تومان

شارژ بر اساس مصرف واقعی همان درخواست. قیمت‌ها با تغییر شرایط بازار به‌روز می‌شوند. ورودی کش‌شده: ۲۵٬۹۶۶ تومان به‌ازای هر ۱M توکن. توکن استدلال: ۱٬۲۹۸٬۳۲۳ تومان به‌ازای هر ۱M توکن. هر تصویر ورودی: ۰٫۲۶ تومان. جستجوی وب: ۴٬۸۴۷٫۰۷ تومان به‌ازای هر درخواست.قیمت‌ها و شارژ

کد آمادهٔ Gemini 3.7 Flash: خواندن تصویر و استخراج داده

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

# 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/gemini-3.7-flash",
    "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/gemini-3.7-flash",
    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/gemini-3.7-flash",
  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));

Gemini 3.7 Flash برای چه کاری خوب است؟

Gemini 3.7 Flash یکی از مدل‌های Google است و در یوتاپن با شناسهٔ «google/gemini-3.7-flash» صدا زده می‌شود. در هر فراخوانی تا ۱٬۰۴۸٬۵۷۶ توکن ورودی می‌پذیرد؛ برای متن فارسی این تقریباً ۲٬۶۲۱ صفحهٔ A4 است، پس چند فایل یا یک سند بلند را می‌شود یک‌جا داد. حداکثر طول پاسخ در هر فراخوانی ۶۵٬۵۳۶ توکن است. از نظر قیمت در دستهٔ «میان‌رده» است — ارزان‌تر از ۱۳۵ مدل و گران‌تر از ۲۵۸ مدل پولی دیگر کاتالوگ.

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

برای برآورد سرانگشتی: هر ۱٬۰۰۰ کلمه رفت‌وبرگشت با این مدل حدود ۲٬۰۲۵ تومان است (۲۵۹٬۶۶۵ تومان ورودی و ۱٬۲۹۸٬۳۲۳ تومان خروجی به‌ازای ۱M توکن). cache ورودی دارد: توکن‌های تکراری متن ورودی با ۲۵٬۹۶۶ تومان / ۱M حساب می‌شوند، که برای پرامپت سیستمی بلند تفاوت بزرگی است. هر تصویر ورودی ۰٫۲۶ تومان جدا حساب می‌شود. شارژ نهایی همیشه بر اساس مصرف واقعی همان درخواست است، نه برآورد، و درخواستی که ناموفق باشد هزینه‌ای ندارد.

نزدیک‌ترین گزینه با همین قابلیت‌ها از تأمین‌کنندهٔ دیگر Mistral Medium 3.5 (دسته‌ای) است: Gemini 3.7 Flash تقریباً هم‌قیمت آن تمام می‌شود و حداکثر طول متنش بیشتر است. هر دو با همان کلید و همان کد کار می‌کنند، پس عوض‌کردن‌شان فقط تغییر یک رشته است.

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

این شناسه با «google/gemini-3.7-flash:batch» اشتباه گرفته می‌شود، چون هستهٔ مدل یکی است. تفاوت در پسوند است: بدون پسوند (نسخهٔ استاندارد) در برابر «batch». روی یک درخواست ۱٬۰۰۰ کلمه‌ای، این نسخه حدود ۲ برابر گران‌تر از آن درمی‌آید (۲٬۰۲۵ در برابر ۱٬۰۱۳ تومان). در پارامترها این مدل temperature، top_p را دارد.

Google در کاتالوگ ما ۴۳ مدل دارد؛ ارزان‌ترین‌شان Gemma 4 26B A4B با ۵۴ تومان و گران‌ترین Gemini 3.1 Pro Preview Custom Tools با ۶٬۳۰۱ تومان برای هر ۱٬۰۰۰ کلمه. از پارامترهای کم‌تکرار، این مدل reasoning_effort را می‌پذیرد — همه از طریق همان بدنهٔ استاندارد درخواست. از نظر طول متن نزدیک‌ترین گزینه از تأمین‌کنندهٔ دیگر DeepSeek V4 Flash 0423 با ۱٬۰۴۸٬۵۷۶ توکن است.

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

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

Gemini 3.7 Flash is a multimodal model from Google for fast agentic workflows, coding, and complex multi-step reasoning. It is designed for tasks that require responsive performance and reliable multi-step...

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

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

کارتوکنهزینه
یک نوبت گفتگو با تاریخچهٔ متوسط۱٬۵۰۰ ورودی + ۴۰۰ خروجی۹۰۹ تومان
خلاصه‌کردن سند ده‌صفحه‌ای۴٬۰۰۰ ورودی + ۶۰۰ خروجی۱٬۸۱۸ تومان
دسته‌بندی هزار ردیف کوتاه۱۲۰٬۰۰۰ ورودی + ۲۰٬۰۰۰ خروجی۵۷٬۱۲۶ تومان

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

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

نسخهشناسهخروجی / ۱Mطول متن
دسته‌ایgoogle/gemini-3.7-flash:batch۶۴۹٬۱۶۱۱٬۰۴۸٬۵۷۶

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

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

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