دستیار هوش مصنوعی ۱۴۰۵: راهنمای انتخاب برای API، دانش‌آموز و تصویر

انتخاب دستیار هوش مصنوعی به نقش شما بستگی دارد، نه به نام مدل: توسعه‌دهنده و استارتاپ کلید API می‌خواهد، دانش‌آموز پنل آموزشی و تولیدکننده محتوا استودیوی تصویر. اگر باید خروجی مدل را داخل کد یا سایت خودتان ببرید، مسیر درست API است. اگر فقط چت فارسی ساده لازم دارید، سراغ کلید و SDK نروید. ما در 1xAi هر سه محصول را اداره می‌کنیم؛ پس نگاه این مقاله نگاه فروشنده است.

کدام دستیار هوش مصنوعی به کار شما می‌خورد؟ چک‌لیست سه سناریو

اگر خروجی باید وارد کد یا سایت شما شود، API لازم دارید؛ برای پرسش و تمرین چت فارسی کافی است و برای عکس، استودیوی تصویر. این جدول بر پایه معرفی محصولات 1xAi نوشته شده و راهنمایی عمومی است، نه نتیجه یک آزمون مقایسه‌ای.

نقش	نیاز اصلی	مسیر پیشنهادی	مثال عملی
توسعه‌دهنده یا استارتاپ	وصل کردن مدل به محصول یا سایت	API سازگار با OpenAI با base_url برابر https://1xai.ir/v1	ربات پشتیبانی که در سایت یا تلگرام به مشتری جواب می‌دهد
دانش‌آموز یا والد	برنامه مطالعه و تمرین از روی کتاب درسی	پنل یادگیری و کنکور	پرسش از متن کتاب با شماره صفحه، و برنامه‌ای که روزهای جاافتاده را دوباره می‌چیند
خلاق یا کسب‌وکار کوچک	تصویر محصول یا پست مناسبتی	استودیوی تصویر	عکس محصول با نسبت ۴:۵ برای پست اینستاگرام

سه سوال، سه تصمیم

• [ ] خروجی را در کد می‌خواهید یا در چت؟ اگر برنامه شما باید پاسخ مدل را بخواند، سراغ API بروید. اگر خودتان پاسخ را می‌خوانید، چت کافی است.
• [ ] به کتاب درسی مشخص تکیه دارید؟ در این حالت پنل یادگیری مناسب‌تر است، چون «از کتاب بپرس» از خود کتاب جواب می‌دهد، شماره صفحه را می‌آورد و اگر کتاب موضوع را پوشش نداده باشد همین را می‌گوید.
• [ ] خروجی عکس است یا متن؟ برای عکس، هر تصویر جدا از کیف پول تومانی پرداخت می‌شود و قیمت تخمینی پیش از ساخت نمایش داده می‌شود. متن فارسی کوتاه داخل عکس روی GPT Image 2.5 Sunburst و Nano Banana Pro بهتر درمی‌آید و متن بلند ممکن است غلط ساخته شود.

چت فارسی ساده یا API؟

چت فارسی برای کسی است که فقط سوال می‌پرسد و جواب را خودش می‌خواند. چت فارسی 1xAi یک دستیار هوش مصنوعی فارسی با مدل‌های GPT، Claude و Gemini گوگل است. پلن رایگانش هر ۳۰ روز سهمیه اعتبار چت می‌دهد، با سقف هفتگی، روی gpt-4o-mini، claude-haiku-4-5 و gemini-2.5-flash؛ مقدار دقیق سهمیه را در همان صفحه چت فارسی ببینید. این مسیر برای سوال از هوش مصنوعی آنلاین و رایگان کافی است و به کد نیاز ندارد.

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

دستیار هوش مصنوعی برای کسب‌وکار: API تومانی بدون VPN

یک کلید 1xai-… و base_url برابر https://1xai.ir/v1 برای OpenAI، Claude، Gemini و DeepSeek کافی است؛ پرداخت پیش‌پرداخت تومانی و از طریق زرین‌پال انجام می‌شود، بدون VPN و کارت خارجی. هر درخواست با نام مدل به ارائه‌دهنده درست مسیریابی می‌شود، پس برای ساخت دستیار هوش مصنوعی فارسی در محصول خودتان فقط یک اتصال لازم دارید.

نمونه کد اجرایی

کتابخانه رسمی OpenAI با نسخه openai>=1.0 لازم است. کلید را در متغیر محیطی نگه دارید و در کد ننویسید.

# pip install "openai>=1.0"
# export ONEXAI_API_KEY="1xai-..."
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ONEXAI_API_KEY"],
    base_url="https://1xai.ir/v1",
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {
            "role": "user",
            "content": "در یک جمله فارسی بگو دستیار هوش مصنوعی برای یک فروشگاه آنلاین چه کمکی می‌کند.",
        }
    ],
)
print(response.choices[0].message.content)

خروجی یک جمله فارسی است و متن دقیقش در هر اجرا فرق می‌کند. اگر مدل دیگری می‌خواهید، نامش را از فهرست مدل‌ها بردارید؛ معیار انتخاب میان مدل‌ها را در راهنمای انتخاب مدل برای API هوش مصنوعی توضیح داده‌ایم.

قیمت به تومان

قیمت هر مدل برابر قیمت رسمی ارائه‌دهنده به‌علاوه مارک‌آپ همان مدل است و پلکان مارک‌آپ ما بسته به مدل بین ۱۵ تا ۳۰٪ قرار می‌گیرد. برای نمونه مارک‌آپ gpt-4o-mini برابر ۳۰٪ و مارک‌آپ o4-mini برابر ۲۰٪ است. هر ۱M توکن ورودی gpt-4o-mini حدود ۵۲٬۵۳۳ تومان و o4-mini حدود ۳۵۵٬۶۰۸ تومان است.

مدل	ورودی هر ۱M توکن (تومان)	خروجی هر ۱M توکن (تومان)	مارک‌آپ
gpt-4o-mini	۵۲٬۵۳۳	۲۱۰٬۱۳۲	۳۰٪
o4-mini	۳۵۵٬۶۰۸	۱٬۴۲۲٬۴۳۲	۲۰٪

قیمت‌های تومانی با نرخ دلار بازار هر صبح ساعت ۹ به وقت تهران هماهنگ می‌شوند. هنگام شارژ کیف پول ۱۰٪ مالیات بر ارزش افزوده هم اضافه می‌شود. اگر پروژه‌تان اتصال سفارشی می‌خواهد، مثل چت‌بات پشتیبانی یا اتصال به تلگرام، از صفحه تماس درخواست دهید.

بهترین دستیار هوش مصنوعی برای دانش‌آموز و کنکور چه ویژگی‌هایی دارد؟

دستیار آموزشی خوب از روی کتاب درسی کار می‌کند و دانش‌آموز را به تمرین وا می‌دارد. اگر فقط جواب بدهد و برود، چیزی یاد نمی‌گیرید.

پنل «یادگیری و کنکور» در 1xAi روی همین منطق ساخته شده و کنار مدرسه و مؤسسه کار می‌کند، نه جای آن‌ها:

• کتاب‌ها: ۹۱ کتاب رسمی پایه‌های ۷ تا ۱۲ در سه گروه تجربی، ریاضی و فیزیک و علوم انسانی.
• از کتاب بپرس: جواب را با شماره صفحه می‌دهد و اگر کتاب پاسخ را نداشته باشد، همین را صریح می‌گوید.
• معلم هوشمند: تا دانش‌آموز تلاش نکرده، جواب نمی‌دهد و قدم‌به‌قدم راهنمایی می‌کند.
• بانک سوال: بیش از ۳٬۷۰۰ سوال تأییدشده با پاسخ تشریحی و راهنمای سه‌مرحله‌ای. سوال‌های ساخته‌شده با هوش مصنوعی برچسب «تولید هوش مصنوعی» دارند.
• آزمون تشریحی: روی کاغذ پاسخ می‌دهید، عکس می‌گیرید و تصحیح بر اساس بارم انجام می‌شود.
• آزمون آزمایشی جمعه: برای کنکور، نهایی و پایه‌های ۱۰ و ۱۱.

محدودیت‌ها

• سوال‌های رسمی سنجش فقط مربوط به کنکور تجربی و فقط دروس تخصصی است؛ برای ریاضی، انسانی و دروس عمومی سوال رسمی نداریم.
• درس‌های تعاملی فقط برای کتاب‌های پایه ۷ تا ۱۰ است. برای پایه ۱۱ و ۱۲ تمرین، معلم هوشمند و آزمون کاغذی در دسترس است.
• ابزارهای هوشمند (کتاب، معلم، راهنما و تصحیح) سهمیه روزانه رایگان دارند و نامحدود نیستند.

اگر می‌خواهید دستیارهای عمومی‌تر را هم مقایسه کنید، راهنمای ابزارهای هوش مصنوعی در ایران نقطهٔ شروع خوبی است.

با دستیار هوش مصنوعی برای کسب‌وکار کوچک چه تصویری بسازیم؟

برای هر کار یک نسبت تصویر و یک مدل مشخص انتخاب کنید؛ سه کار پرتکرار فروشگاه‌ها و تولیدکننده‌های محتوا این‌ها هستند. در استودیوی تصویر 1xAi شش مدل داریم: GPT Image 2.5 (در دو نسخه Sunburst و Flare)، GPT Image 2، Nano Banana 2، Nano Banana 2 Lite و Nano Banana Pro.

۱. عکس محصول روی پس‌زمینه شفاف

• نسبت و مدل: ۴:۵، با GPT Image 2.5 یا GPT Image 2. پس‌زمینه شفاف فقط روی مدل‌های GPT در دسترس است.
• پرامپت فارسی: «یک شیشه عسل با درب چوبی، نور نرم استودیویی، سایه ملایم زیر محصول، پس‌زمینه شفاف»
• English: "A glass honey jar with a wooden lid, soft studio lighting, subtle contact shadow, transparent background"

۲. پست مناسبتی یا استوری با متن کوتاه فارسی

• نسبت و مدل: ۴:۵ برای پست و ۹:۱۶ برای استوری، با GPT Image 2.5 Sunburst یا Nano Banana Pro.
• پرامپت فارسی: «تصویر استوری شب یلدا برای شیرینی‌فروشی: هندوانه و انار روی سفره قرمز، نور گرم شمع، متن فارسی «شب یلدا مبارک» بالای تصویر»
• English: "Yalda night story for a pastry shop: watermelon and pomegranate on a red tablecloth, warm candlelight, the Persian text «شب یلدا مبارک» at the top"

۳. تصویر معماری یا کاور یوتیوب

• نسبت و مدل: ۱۶:۹ با یکی از مدل‌های Nano Banana. برای کاور با عنوان کوتاه Nano Banana Pro را امتحان کنید. برای نمای معماری بدون متن، همان پرامپت را روی Nano Banana 2 هم اجرا کنید و نتیجه‌ها را کنار هم بسنجید.
• پرامپت فارسی: «نمای بیرونی ویلای مدرن دو طبقه با سنگ تراورتن و پنجره‌های بزرگ، ساعت طلایی غروب، زاویه دید هم‌سطح چشم»
• English: "Exterior of a modern two-storey villa with travertine stone and large windows, golden-hour light, eye-level view"

برای ویرایش، ماسک فقط روی مدل‌های GPT کار می‌کند. مقایسه قبل و بعد، تا ۸ تصویر مرجع (مثلاً عکس نقشه یا نمونه رنگ) و ۱۰ نسبت تصویر روی استودیو در دسترس است.

یک محدودیت را جدی بگیرید: متن بلند فارسی داخل تصویر ممکن است غلط شود، پس عنوان‌ها را کوتاه نگه دارید. پرامپت فارسی هم دقیقاً همان‌طور که تایپ شده به مدل می‌رسد و ترجمه خودکار ندارد؛ اگر نتیجه دقیق نبود، نسخه انگلیسی را هم بسنجید.

هزینه به‌ازای هر تصویر از کیف پول تومانی پرداخت می‌شود و قیمت هر تصویر پیش از تولید نمایش داده می‌شود.

رایگان کجا تمام می‌شود و پولی کجا شروع؟ تصمیم نهایی پیش از خرید

چت فارسی و تمرین یادگیری طرح رایگان دارند، اما API پیش‌پرداخت تومانی است و تصویر به‌ازای هر تصویر پولی است. «دستیار هوش مصنوعی رایگان» برای گفتگو با «API رایگان» یکی نیست. جدول زیر مرز را نشان می‌دهد.

چه چیزی	رایگان است؟	شرط
چت فارسی	بله، با سقف	اعتبار رایگان در هر ۳۰ روز با سقف هفتگی؛ روی gpt-4o-mini، claude-haiku-4-5 و gemini-2.5-flash
API	نه، پیش‌پرداخت	شارژ تومانی کیف پول؛ هدیه گردونه را می‌توان برای شروع به کار برد
یادگیری	بله، با سهمیه	تمرین (تا ۲۰۰ پاسخ در روز)، آزمون جمعه، مرور فاصله‌دار و استریک رایگان؛ ابزارهای هوشمند با سهمیه روزانه
تصویر	نه	پولی به‌ازای هر تصویر از کیف پول تومانی

اگر فقط می‌خواهید سؤال بپرسید، چت فارسی با طرح رایگان کافی است و برای «سوال از هوش مصنوعی رایگان» لازم نیست چیزی بخرید. سقف دقیق اعتبار رایگان و طرح‌های پولی در صفحه طرح‌ها آمده است. API برخلاف چت اعتبار ماهانه رایگان ندارد. شروع کم‌هزینه آن گردونه هدیه است: هر حساب یک چرخش دارد و مبلغ برنده‌شده به‌صورت اعتبار به کیف پول اضافه می‌شود و منقضی نمی‌شود. بعد از آن، حداقل مبلغ شارژ را خود صفحه شارژ نشان می‌دهد و هزینه هر مدل قیمت رسمی ارائه‌دهنده به‌علاوه کارمزد ۱۵ تا ۳۰٪ بسته به مدل است.

در بخش یادگیری، «رایگان» یعنی سهمیه، نه نامحدود. سقف روزانه مربوط به تمرین است (۲۰۰ پاسخ در روز)، و ابزارهای هوشمند مثل معلم هوشمند و راهنمایی مرحله‌ای هر روز سهمیه‌ی رایگان محدودی دارند.

نکته‌ی مالیات و پرداخت

شارژ کیف پول در مرحله‌ی پرداخت ۱۰٪ مالیات ارزش افزوده دارد، پس مبلغ نهایی از مبلغ شارژ بیشتر است. پرداخت از درگاه‌های ایرانی (زرین‌پال) انجام می‌شود و 1xAi با نماد اعتماد الکترونیکی enamad 727687 ثبت شده است.

دستیار هوش مصنوعی گوگل

اگر منظورتان از «دستیار هوش مصنوعی گوگل» مدل‌های Gemini است، با همان کلید 1xAi و همان base_url قابل دسترسی‌اند و فقط نام مدل را عوض می‌کنید:

curl https://1xai.ir/v1/chat/completions \
  -H "Authorization: Bearer $ONEXAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemini-2.5-flash", "messages": [{"role": "user", "content": "سلام"}]}'

SDK رسمی گوگل هم روی اندپوینت‌های اختصاصی با کلید x-goog-api-key کار می‌کند. نام مدل‌های موجود را در فهرست مدل‌ها ببینید. اگر دنبال «خرید API هوش مصنوعی» هستید، همین یک کلید OpenAI، Claude، Gemini و DeepSeek را پوشش می‌دهد و با آن نیازی به کارت خارجی یا VPN ندارید.

سوالات متداول

آیا برای استفاده از API مدل‌های OpenAI و Claude در ایران به VPN یا کارت ارزی نیاز دارم؟

خیر. توسعه‌دهندگان داخل ایران با هر SDK استاندارد OpenAI به 1xAi وصل می‌شوند، بدون VPN و بدون کارت بانکی خارجی. شارژ پیش‌پرداخت و تومانی است و از طریق زرین‌پال انجام می‌شود. کلید را هم از داشبورد 1xai.ir می‌سازید.

هزینه API به تومان چگونه حساب می‌شود؟

قیمت رسمی هر ارائه‌دهنده به‌علاوه کارمزد ۱۵ تا ۳۰٪ بسته به مدل، با نرخ روز دلار (۲۶۹٬۴۰۰ تومان) که هر صبح با بازار هماهنگ می‌شود. درصد دقیق هر مدل و قیمت زندهٔ آن در صفحه مدل‌ها آمده است. هنگام شارژ کیف پول، ۱۰٪ مالیات بر ارزش افزوده هم اضافه می‌شود.

برای اتصال به چه کلید و آدرسی نیاز دارم؟

یک کلید با پیشوند 1xai- و base URL برابر https://1xai.ir/v1. همین یک کلید OpenAI، Claude، Gemini و DeepSeek را پوشش می‌دهد و درخواست بر اساس نام مدل به مقصد درست می‌رود.

آیا SDK رسمی Anthropic و Google هم بدون تغییر کار می‌کنند؟

بله. اندپوینت‌های اختصاصی /anthropic و /gemini هدرهای x-api-key و x-goog-api-key را می‌پذیرند و قابلیت‌هایی مثل کش پرامپت را حفظ می‌کنند. فقط یک نکته: claude-sonnet-5، claude-fable-5 و claude-opus-5 پارامترهای temperature و top_p و همچنین prefill پیام assistant را رد می‌کنند.

آیا IP و اطلاعات من به ارائه‌دهنده مدل می‌رسد؟

خیر. IP، کوکی‌ها و user-agent مشتری به ارائه‌دهنده بالادستی نمی‌رسد، چون هر درخواست از زیرساخت 1xAi دوباره صادر می‌شود. اگر می‌خواهید قبل از کدنویسی مدل‌ها را بسنجید، پلی‌گراند وب هم در داشبورد هست.