برنامه هوش مصنوعی برای سایت و اپ

اگر می‌خواهید هوش مصنوعی را به سایت یا اپ خودتان اضافه کنید، چیزی که لازم دارید اپلیکیشن موبایل نیست، بلکه یک API با یک کلید است. اپ‌هایی مثل ChatGPT در Google Play یا دستیارهای فارسی برای کاربر نهایی ساخته شده‌اند و خودِ اپ جایگزین API برای اتصال به محصول شما نیست. برای کارهایی مثل چت‌بات پشتیبانی، تولید خودکار محتوا و جستجوی هوشمند، معمولاً باید مدل را از کد خودتان صدا بزنید. در ایران این کار با هر SDK استاندارد OpenAI و بدون VPN و کارت بانکی خارجی شدنی است، و ما در 1xAi که این مسیر را اداره می‌کنیم، در ادامه سه کاربرد عملی را همراه با قیمت تومانی مدل‌ها توضیح می‌دهیم.

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

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

اپ‌های هوش مصنوعی برای کاربر نهایی

این‌ها چند اپ هوش مصنوعی برای استفاده‌ی شخصی‌اند:

• ChatGPT: اپ رسمی ChatGPT در Google Play رایگان است و تولید تصویر و حالت صوتی دارد. صفحه‌اش در مهر ۱۴۰۵ امتیاز ۴٫۷ از حدود ۶۲٫۸ میلیون مرور را نشان می‌دهد، ولی برچسب «آگهی دارد» و خرید درون‌برنامه‌ای هم دارد. ایران در فهرست کشورهای پشتیبانی‌شده‌ی OpenAI نیست، پس این اپ از داخل ایران بدون VPN کار نمی‌کند.
• چت فارسی 1xAi: در چت فارسی 1xAi از داخل ایران و بدون VPN با GPT، Claude و Gemini گفتگو می‌کنید. پلن رایگان (با ساخت حساب) هر ۳۰ روز ۱۰۰٬۰۰۰ تومان اعتبار چت، با سقف مصرف هفتگی، روی gpt-4o-mini، claude-haiku-4-5 و gemini-2.5-flash می‌دهد. اپ جداگانه در استورها نداریم، اما نسخه‌ی وب نصب‌شدنی مثل اپ روی گوشی نصب می‌شود.
• افزونه‌ی چندمدلی: Monica هم افزونه‌ی Chrome و Edge است و هم اپ موبایل و دسکتاپ.
• فهرست اپ‌های مایکت: مایکت اپ‌های هوش مصنوعی اندروید، از چت‌بات تا ابزار عکس و ویدیو، را در یک صفحه فهرست کرده است.

مرز کار مصرف‌کننده و کار توسعه‌دهنده

این اپ‌ها مصرف‌کننده را هدف گرفته‌اند. خودِ اپ معمولاً راهی برای گذاشتنش داخل سایت شما، پاسخ دادن به مشتری‌هایتان از طریق آن یا کنترل رفتارش در اختیارتان نمی‌گذارد. برای این کارها معمولاً به API هوش مصنوعی نیاز دارید.

«رایگان» هم همین‌جا حد دارد: نسخه‌ی رایگان این اپ‌ها اغلب سقف مصرف، آگهی یا خرید درون‌برنامه‌ای دارد و پایه‌ی مطمئنی برای یک محصول نیست.

با یک کلید 1xAi و آدرس https://1xai.ir/v1 می‌توانید بدون VPN و کارت خارجی مدل‌های OpenAI، Claude، Gemini و DeepSeek را صدا بزنید. فهرست مدل‌ها در 1xai.ir/models است. اگر ساخت چت‌بات پشتیبانی یا اتصال به تلگرام را خودتان نمی‌خواهید انجام دهید، درخواست را از صفحه‌ی تماس ثبت کنید.

کدام مدل برای کدام کاربرد؟ OpenAI، Claude، Gemini یا DeepSeek

هر چهار خانواده، یعنی OpenAI، Claude، Gemini و DeepSeek، در 1xAi با یک کلید و یک base URL در دسترس‌اند و انتخاب بینشان به کاربرد و هزینه بستگی دارد. جدول زیر فقط دسترسی را مقایسه می‌کند.

مورد	وضعیت در 1xAi
OpenAI، Claude، Gemini، DeepSeek	یک کلید 1xai-… و یک base URL (https://1xai.ir/v1)، مسیریابی بر اساس نام مدل
SDKها	OpenAI SDK استاندارد. SDKهای Anthropic و Google GenAI هم روی اندپوینت‌های اختصاصی /anthropic و /gemini بدون تغییر کار می‌کنند
ویژگی‌های اختصاصی	کش پرامپت Anthropic روی اندپوینت اختصاصی حفظ می‌شود
محدودیت مدل‌های Claude نسل ۵	claude-sonnet-5 و claude-fable-5 پارامترهای temperature و top_p و prefill پیام assistant را رد می‌کنند

راهنمای عمومی انتخاب

این بخش یک راهنمای عمومی است و بنچمارک نیست. ما برای این چهار خانواده عدد کیفیت یا سرعت منتشر نمی‌کنیم و ادعای «بهترین» هم نداریم.

• کارهای پرحجم مثل تحلیل نظرات یا دسته‌بندی متن: از مدل ارزان‌تر شروع کنید و فقط در صورت افت کیفیت به مدل بزرگ‌تر بروید.
• استدلال چندمرحله‌ای و کدنویسی: مدل‌های سنگین‌تر را روی نمونه‌ی واقعی خودتان امتحان کنید.
• پرامپت‌های طولانی تکراری: برای مدل‌های Claude از اندپوینت اختصاصی /anthropic استفاده کنید تا کش پرامپت حفظ شود؛ مدل‌های OpenAI روی /v1 خودکار کش می‌شوند.

مقایسه را روی هزینه و دسترسی بنا کنید، چون رتبه‌ی برتری به داده‌ی خود شما بستگی دارد. فاصله‌ی قیمت درون یک خانواده هم بزرگ است: قیمت رسمی ورودی gpt-5.5 برابر ۵ دلار و gpt-5 برابر ۱٫۲۵ دلار به‌ازای هر یک میلیون توکن است. معادل تومانی آن‌ها با مارک‌آپ ۲۰ درصدی حدود ۱٬۵۴۳٬۸۰۰ و ۳۸۵٬۹۵۰ تومان است و با نرخ روزانه‌ی بازار به‌روز می‌شود.

فهرست زنده‌ی مدل‌ها و قیمت‌ها را در /models ببینید. در پلی‌گراند وب هم می‌توانید پیش از نوشتن کد، مدل‌ها را با ورودی خودتان امتحان کنید.

چطور بدون VPN و کارت خارجی متصل شویم؟

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

سه گام

1. ساخت کلید: در داشبورد 1xai.ir کلیدی با پیشوند 1xai- بسازید. همین کلید با base URL برابر https://1xai.ir/v1 برای مدل‌های OpenAI، Claude، Gemini و DeepSeek کار می‌کند و مسیر درخواست را نام مدل تعیین می‌کند.
2. تست در playground: پیش از نوشتن کد، مدل‌ها را در playground وب امتحان کنید. نام مدل‌های موجود در صفحه‌ی مدل‌ها آمده است.
3. شارژ پیش‌پرداخت: موجودی را به تومان و با زرین‌پال شارژ کنید. حداقل مبلغ شارژ و قیمت هر مدل روی صفحه‌ی قیمت‌ها آمده است. هنگام شارژ ۱۰٪ مالیات بر ارزش افزوده به مبلغ اضافه می‌شود.

نمونه‌کد Python

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-5",
    messages=[
        {"role": "user", "content": "API را در یک جمله توضیح بده."}
    ],
)

print(response.choices[0].message.content)

همان درخواست با curl

curl https://1xai.ir/v1/chat/completions \
  -H "Authorization: Bearer $ONEXAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5",
    "messages": [
      {"role": "user", "content": "API را در یک جمله توضیح بده."}
    ]
  }'

خروجی مورد انتظار: در Python یک جمله‌ی فارسی چاپ می‌شود، مثلاً «API رابطی است که برنامه‌ها از طریق آن با هم تبادل داده می‌کنند.» متن دقیق در هر اجرا فرق می‌کند. curl همان پاسخ را در قالب JSON استاندارد چت برمی‌گرداند و متن در choices[0].message.content قرار دارد.

SDK رسمی Anthropic

اگر SDK رسمی Anthropic را ترجیح می‌دهید، به یکی از اندپوینت‌های اختصاصی ما وصل شوید:

import os
import anthropic

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

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=200,
    messages=[{"role": "user", "content": "سلام"}],
)
print(message.content[0].text)

مدل‌های نسل ۵ Claude (claude-sonnet-5 و claude-fable-5) پارامترهای temperature و top_p و همچنین prefill پیام دستیار را رد می‌کنند. این پارامترها را در درخواست نگذارید.

حریم خصوصی

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

هر کاربرد را در سایت یا اپ چطور پیاده کنیم؟

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

چت‌بات پشتیبانی

الگو این است: system prompt شامل اطلاعات کسب‌وکار (ساعت کاری، قوانین بازگشت کالا، لحن پاسخ)، پاسخ به‌صورت streaming و تاریخچه‌ی گفتگو در بک‌اند. برای شروع ارزان، gpt-5-mini را امتحان کنید و اگر کیفیت پاسخ کافی نبود به gpt-5 بروید. نرخ ورودی فعلی gpt-5-mini ۷۷٬۱۹۰ و gpt-5 ۳۸۵٬۹۵۰ تومان به ازای هر ۱ میلیون توکن است. gpt-5 طبق آمار ۳۰ روزِ منتهی به ۹ مهر ۱۴۰۵ در گیت‌وی ما، ۵۷۷ درخواست با ۱۰۰٪ موفقیت داشته است.

import os
from fastapi import FastAPI
from fastapi.responses import StreamingResponse
from pydantic import BaseModel
from openai import AsyncOpenAI

app = FastAPI()
client = AsyncOpenAI(
    api_key=os.environ["ONEXAI_API_KEY"],  # فقط در متغیر محیطی سرور
    base_url="https://1xai.ir/v1",
)

SYSTEM_PROMPT = "تو پشتیبان فروشگاه نمونه هستی. فقط با اطلاعات زیر پاسخ بده: ..."
histories: dict[str, list[dict]] = {}  # در تولید: Redis یا پایگاه داده

class ChatIn(BaseModel):
    session_id: str
    message: str

@app.post("/chat")
async def chat(chat_in: ChatIn):
    history = histories.setdefault(chat_in.session_id, [])
    history.append({"role": "user", "content": chat_in.message})
    messages = [{"role": "system", "content": SYSTEM_PROMPT}] + history[-20:]

    async def stream():
        parts = []
        resp = await client.chat.completions.create(
            model="gpt-5-mini", messages=messages, stream=True
        )
        async for chunk in resp:
            if chunk.choices and chunk.choices[0].delta.content:
                text = chunk.choices[0].delta.content
                parts.append(text)
                yield text
        history.append({"role": "assistant", "content": "".join(parts)})

    return StreamingResponse(stream(), media_type="text/plain; charset=utf-8")

هشدار: کلید 1xai-… را هرگز در کد فرانت‌اند یا اپ موبایل نگذارید. هر کسی می‌تواند آن را استخراج کند و از موجودی شما خرج کند. اگر چت‌بات اختصاصی یا اتصال سایت و تلگرام می‌خواهید، تیم 1xAi آن را می‌سازد؛ درخواست را از صفحه‌ی تماس بفرستید.

خودکارسازی محتوا

الگوی درست، پردازش دسته‌ای است: یک قالب پرامپت ثابت، ورودی‌ها در حلقه، خروجی ساختاریافته (مثلاً JSON با فیلدهای عنوان، توضیح و برچسب) و بازبینی انسانی قبل از انتشار. مدل ممکن است ادعای نادرست بنویسد، پس خروجی را مستقیم منتشر نکنید.

بخش ثابت و طولانی پرامپت (راهنمای سبک، نمونه‌ها) را اول پیام بگذارید تا از کش پرامپت سود ببرید. نرخ لیست رسمی OpenAI برای توکن ورودی کش‌شده در این مدل‌ها این است:

• gpt-5: ۰٫۱۲۵ دلار به ازای هر ۱ میلیون توکن (در برابر ۱٫۲۵ دلار ورودی عادی)
• gpt-5.2: ۰٫۱۷۵ دلار (در برابر ۱٫۷۵ دلار)
• gpt-5.5: ۰٫۵ دلار (در برابر ۵ دلار)
• o3: ۰٫۵ دلار (در برابر ۲ دلار)

این‌ها قیمت لیست ارائه‌دهنده‌اند و مارک‌آپ ۲۰٪ روی آن‌ها اعمال می‌شود؛ تخفیف هر مدل با مدل دیگر یکی نیست.

جستجوی هوشمند

با مدل چت دو کار می‌شود کرد: بازنویسی پرسش کاربر به عبارتی روشن‌تر، و رتبه‌بندی مجدد نتایجی که موتور جستجوی فعلی شما برگردانده. فقط ۱۰ تا ۲۰ نتیجه‌ی برتر را برای رتبه‌بندی بفرستید، وگرنه هزینه و تأخیر بالا می‌رود.

اگر جستجوی معنایی می‌خواهید، مدل‌های امبدینگ مثل text-embedding-3-small و text-embedding-3-large در /models فهرست شده‌اند و از همان آدرس پایه (/v1/embeddings) صدا زده می‌شوند. این لایه را فقط وقتی اضافه کنید که بازنویسی پرسش و رتبه‌بندی مجدد کافی نباشد.

هشدار: خروجی رتبه‌بندی را در فرمت مشخص (مثلاً فهرست شناسه‌ها) بخواهید و اگر فرمت خراب بود، به ترتیب اصلی موتور جستجو برگردید.

هزینه‌ی تومانی هر کاربرد را چطور حساب کنیم؟

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

مدل	لیست رسمی (دلار، ورودی / خروجی)	تومان، هر ۱M توکن ورودی	تومان، هر ۱M توکن خروجی	۳۰ روزِ منتهی به ۹ مهر ۱۴۰۵ (گیت‌وی 1xAi)
gpt-5	۱٫۲۵ / ۱۰	۳۸۵٬۹۵۰	۳٬۰۸۷٬۶۰۰	۵۷۷ درخواست، ۱۰۰٪ موفق
gpt-5.2	۱٫۷۵ / ۱۴	۵۴۰٬۳۳۰	۴٬۳۲۲٬۶۴۰	۱٬۰۱۰ درخواست، ۱۰۰٪ موفق
gpt-5.5	۵ / ۳۰	۱٬۵۴۳٬۸۰۰	۹٬۲۶۲٬۸۰۰	۶۳۵ درخواست، ۱۰۰٪ موفق
o3	۲ / ۸	۶۱۷٬۵۲۰	۲٬۴۷۰٬۰۸۰	—

ستون قیمت دلاری همان لیست رسمی OpenAI است. دو ستون تومانی و آمار ۳۰ روزه (تا ۹ مهر ۱۴۰۵) داده‌ی عملیاتی خود 1xAi هستند.

مدل قیمت‌گذاری

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

فرمول هزینه‌ی یک کاربرد

خروجی در همه‌ی این مدل‌ها گران‌تر از ورودی است: ۸ برابر برای gpt-5 و gpt-5.2، ۶ برابر برای gpt-5.5 و ۴ برابر برای o3. برای چت‌بات پشتیبانی یا خلاصه‌سازی نقدها، پس طول پاسخ را هم مثل طول پرامپت زیر نظر بگیرید و در صورت امکان سقف max_tokens بگذارید. در مدل‌های استدلالی مثل gpt-5 و o3 توکن‌های «فکر کردن» هم از همین سقف کم می‌شوند؛ سقف خیلی پایین ممکن است پاسخ خالی برگرداند.

هزینه = (توکن_ورودی / 1_000_000 * نرخ_ورودی_مدل) + (توکن_خروجی / 1_000_000 * نرخ_خروجی_مدل)

نرخ‌ها را از ستون‌های تومانی جدول بردارید. توکن‌های واقعی هر درخواست هم در فیلد usage پاسخ API برمی‌گردند. مبلغی که برای شارژ می‌پردازید، هزینه × ۱٫۱ است (۱۰٪ مالیات بر ارزش افزوده).

مثال: فرض کنید چت‌بات پشتیبانی در ماه ۱٬۰۰۰ گفتگو دارد و هر گفتگو حدود ۱٬۵۰۰ توکن ورودی و ۳۰۰ توکن خروجی روی gpt-5 مصرف می‌کند. می‌شود ۱٫۵ میلیون توکن ورودی (۱٫۸۷۵ دلار) به‌علاوه‌ی ۰٫۳ میلیون توکن خروجی (۳ دلار)، یعنی ۴٫۸۷۵ دلار به قیمت لیست. با مارک‌آپ ۲۰٪ حدود ۵٫۸۵ دلار و با مالیات شارژ حدود ۶٫۴۴ دلار می‌شود؛ معادل تومانی را با ستون‌های جدول حساب کنید. gpt-5 پیش از پاسخ توکن «فکر کردن» هم مصرف می‌کند که جزو خروجی حساب می‌شود، پس عدد واقعی را از usage بخوانید.

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

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

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

آیا بدون VPN و کارت بانکی خارجی می‌شود به API دسترسی داشت؟

بله. در 1xAi با هر SDK استاندارد OpenAI و بدون VPN و کارت خارجی می‌توانید درخواست بفرستید. کلید را از [داشبورد 1xai.ir](https://1xai.ir/dashboard/keys) می‌گیرید و پیش از کدنویسی، مدل‌ها را در پلی‌گراند وب امتحان می‌کنید. آی‌پی و کوکی شما به ارائه‌دهنده نمی‌رسد.

با یک کلید به کدام مدل‌ها دسترسی دارم؟

یک کلید `1xai-…` و آدرس پایه `https://1xai.ir/v1` مدل‌های OpenAI، Claude، Gemini و DeepSeek را پوشش می‌دهد و درخواست بر اساس نام مدل مسیریابی می‌شود. SDKهای Anthropic و Google GenAI هم روی اندپوینت‌های اختصاصی `/anthropic` و `/gemini` بدون تغییر کار می‌کنند.

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

1xAi روی قیمت رسمی هر ارائه‌دهنده مارک‌آپ ثابت ۲۰٪ می‌گذارد. پرداخت پیش‌پرداخت و از طریق زرین‌پال است و حداقل مبلغ شارژ در صفحه‌ی قیمت‌ها آمده است. به مبلغ هر شارژ ۱۰٪ مالیات بر ارزش افزوده هم اضافه می‌شود. نرخ تبدیل روزانه به‌روز می‌شود؛ ارقام لحظه‌ای را در [صفحه قیمت‌ها](https://1xai.ir/pricing) ببینید.

مدل‌های Claude نسل ۵ چه محدودیتی دارند؟

مدل‌های claude-sonnet-5 و claude-fable-5 پارامترهای temperature و top_p را نمی‌پذیرند و prefill پیام دستیار را هم رد می‌کنند. اگر کد قبلی شما این پارامترها را می‌فرستد، هنگام مهاجرت به این مدل‌ها آن‌ها را حذف کنید.