تولید محتوا با API در ۲۰۲۶

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

تولید محتوا با هوش مصنوعی با API یعنی چه و با چت چه فرقی دارد؟

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

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

خط لوله‌ی چهار مرحله‌ای

1. طرح کلی: مدل از روی موضوع تیترها را پیشنهاد می‌دهد.
2. پیش‌نویس: هر بخش جداگانه روی همان طرح نوشته می‌شود.
3. بازنویسی و برچسب‌گذاری: لحن یکدست می‌شود و دسته یا برچسب‌های پیشنهادی هم گرفته می‌شود.
4. بازبینی انسانی: تنها مرحله‌ای که خودکار نمی‌شود.

سه مرحله‌ی اول با کد این شکل می‌شود (پایتون، با نصب pip install openai):

from openai import OpenAI

client = OpenAI(api_key="1xai-...", base_url="https://1xai.ir/v1")

def ask(prompt: str, model: str = "gpt-4.1") -> str:
    r = client.chat.completions.create(
        model=model,
        messages=[{"role": "user", "content": prompt}],
    )
    return r.choices[0].message.content

topic = "راهنمای انتخاب لپ‌تاپ برای دانشجوها"
outline = ask(f"برای موضوع «{topic}» طرح کلی با تیترهای H2 به فارسی بنویس.")
draft = ask(f"بر اساس این طرح، پیش‌نویس مقاله را بنویس:\n{outline}")
final = ask(f"متن را روان‌تر بازنویسی کن و در پایان سه برچسب پیشنهاد بده:\n{draft}")
print(final)

خروجی، متن نهایی فارسی همراه با برچسب‌هاست. برای مرحله‌ی چهارم هم همین خروجی باید به آدم برسد، چون ویرایش و صحت‌سنجی پیش از انتشار کار انسان است. کد می‌نویسد، ولی تأیید انتشار با ادمین است.

اتصال از ایران

ما در 1xAi این گیت‌وی را اداره می‌کنیم. یک کلید 1xai-… و آدرس https://1xai.ir/v1 با هر SDK سازگار با OpenAI کار می‌کند، بدون VPN و بدون کارت خارجی. کلید را از داشبورد می‌گیرید و پیش از نوشتن کد می‌توانید مدل‌ها را در playground امتحان کنید.

مدل بر اساس نام مسیریابی می‌شود. برای رفتن از OpenAI به Claude، Gemini یا DeepSeek فقط پارامتر model را عوض می‌کنید؛ نام‌های موجود در فهرست مدل‌ها آمده و قیمت‌های لحظه‌ای در صفحه‌ی قیمت‌ها است.

هزینه‌ی هر مقاله و هر توضیح محصول چقدر می‌شود؟

هزینه را تعداد توکن‌های ورودی و خروجی تعیین می‌کند، نه تعداد مقاله؛ با فرمول زیر و قیمت مدل انتخابی، خودتان برآورد می‌کنید.

هزینه = (توکن ورودی × قیمت ورودی + توکن خروجی × قیمت خروجی) ÷ ۱٬۰۰۰٬۰۰۰

قیمت‌های لیست دلاری از ارائه‌دهنده است. ستون‌های تومانی داده‌ی زنده‌ی خود ما در 1xAi است و با نرخ روز محاسبه می‌شود:

مدل	لیست ورودی / خروجی (دلار، هر ۱M)	ورودی (تومان، هر ۱M)	خروجی (تومان، هر ۱M)	ورودی کش‌شده (دلار لیست، هر ۱M)
gpt-5.2	۱٫۷۵ / ۱۴	۵۵۷٬۷۶۰	۴٬۴۶۲٬۰۸۰	۰٫۱۷۵
gpt-4.1	۲ / ۸	۶۳۷٬۴۴۰	۲٬۵۴۹٬۷۶۰	۰٫۵
gpt-5.5	۵ / ۳۰	۱٬۵۹۳٬۶۰۰	۹٬۵۶۱٬۶۰۰	۰٫۵
o3	۲ / ۸	۶۳۷٬۴۴۰	۲٬۵۴۹٬۷۶۰	۰٫۵

قیمت Claude، GPT-4o و DeepSeek را اینجا نیاورده‌ایم؛ نرخ لحظه‌ای همه‌ی مدل‌ها در صفحه‌ی مدل‌ها و صفحه‌ی قیمت‌ها هست.

ساختار قیمت‌گذاری

قیمت هر مدل برابر است با قیمت لیست ارائه‌دهنده به‌علاوه‌ی مارک‌آپ ثابت ۲۰٪. آنچه ثابت است مارک‌آپ است، نه نرخ دلار: نرخ هر روز ساعت ۹ صبح تهران با بازار همگام می‌شود، پس قیمت تومانی ممکن است از یک روز به روز بعد تغییر کند.

شارژ کیف پول ۱۰٪ مالیات بر ارزش افزوده دارد و حداقل شارژ ۱٬۰۰۰ تومان است.

کش پرامپت

نرخ ورودی کش‌شده فقط برای توکن‌هایی اعمال می‌شود که در عمل از کش خوانده شده باشند؛ صرفِ تکرار شدن راهنمای سبک برند یا قالب توضیح محصول در هر درخواست، این نرخ را تضمین نمی‌کند. توکن‌های ورودی که از کش خوانده نشوند با نرخ ورودی عادی حساب می‌شوند، و اینکه کدام بخش از پرامپت مشمول کش شود به قواعد ارائه‌دهنده بستگی دارد. نرخ کش‌شده‌ی هر مدل در جدول بالا جداگانه آمده؛ مثلاً برای gpt-5.2 برابر ۰٫۱۷۵ دلار و برای gpt-4.1 برابر نیم دلار است. مارک‌آپ روی نرخ کش هم اعمال می‌شود و معادل تومانی آن در صفحه‌ی قیمت‌ها هست.

برای Claude، اندپوینت‌های اختصاصی /anthropic ویژگی کش پرامپت Anthropic را حفظ می‌کنند و خواندن از کش با نرخ ورودی کش‌شده‌ی خود ارائه‌دهنده حساب می‌شود. بخش ثابت را معمولاً بهتر است ابتدای پرامپت بگذارید و متغیرهای هر محصول را بعد از آن.

برای هر کار تولید محتوا کدام مدل را انتخاب کنیم؟

برای کارهای حجیم و ساده مدل سبک بردارید و فقط مرحله‌ی حساس، مثل لحن برند یا مقاله‌ی بلند، را به مدل قوی‌تر بسپارید. به جای یک برنده‌ی کلی، مدل را بر اساس مرحله‌ی کار تقسیم کنید.

جدول زیر راهنمای عمومی است، نه نتیجه‌ی بنچمارک. ما هیچ رتبه‌بندی کیفیت یا سرعتی ادعا نمی‌کنیم و مدل‌ها نمونه‌اند. سه مدل سبکی که در 1xAi پشتیبانی می‌شوند gpt-4o-mini، claude-haiku-4-5 و gemini-2.5-flash هستند.

کار	ویژگی کار	مدل کم‌هزینه (بودجه‌ی کوچک)	مدل قوی‌تر (بودجه‌ی بزرگ)	نکته‌ی انتخاب
نوشتن بلاگ	حجم کم، حساسیت بالا به لحن فارسی	gemini-2.5-flash برای طرح و پیش‌نویس	claude-sonnet-5 یا gpt-5.2	فقط نسخه‌ی نهایی و لحن برند را به مدل قوی‌تر بدهید
توصیف محصول	حجم بالا، حساسیت متوسط	gpt-4o-mini	gpt-4.1	قالب ثابت بدهید؛ مدل قوی‌تر را به دسته‌های کم‌تعداد و پرفروش محدود کنید
خلاصه‌سازی	حجم بالا، حساسیت پایین	claude-haiku-4-5	gpt-5.2	مدل قوی‌تر فقط برای اسناد بلند و حساس
تحلیل نظرات کاربران	حجم بالا، ورودی فارسی محاوره‌ای	gemini-2.5-flash	gpt-5.2	دسته‌بندی با مدل سبک؛ فقط موارد مبهم به مدل قوی‌تر

قیمت هر مدل را در صفحه‌ی مدل‌ها و قیمت‌ها ببینید. تومانِ آن‌ها هر روز با نرخ بازار به‌روز می‌شود، برای همین عدد ثابتی در جدول نیاورده‌ایم.

نکته‌ی عملی: مدل‌های نسل ۵ Claude

claude-sonnet-5، claude-fable-5 و claude-opus-5 پارامترهای temperature و top_p و همچنین پیش‌پر کردن پیام دستیار (prefill) را رد می‌کنند. اگر کدِ مشترک شما برای همه‌ی مدل‌ها دما می‌فرستد، این پارامترها را برای این مدل‌ها حذف کنید. لحن را هم باید از راه پرامپت کنترل کنید، نه با دمای نمونه‌برداری.

from openai import OpenAI

client = OpenAI(base_url="https://1xai.ir/v1", api_key="1xai-YOUR_KEY")

resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[
        {"role": "system", "content": "تو نویسنده‌ی بلاگ یک فروشگاه اینترنتی هستی. لحن: صمیمی ولی حرفه‌ای، جمله‌های کوتاه، بدون اغراق تبلیغاتی."},
        {"role": "user", "content": "یک مقدمه‌ی ۸۰ کلمه‌ای برای مقاله‌ی «راهنمای خرید قهوه‌ساز» بنویس."},
    ],
)
print(resp.choices[0].message.content)

خروجی یک مقدمه‌ی فارسی با همان لحنی است که در پیام سیستم نوشته‌اید.

چطور خودتان سه مدل را روی متن فارسی خودتان مقایسه کنید؟

با یک اسکریپت کوتاه، یک پرامپت یکسان را روی چند مدل اجرا کنید و تأخیر و مصرف توکن هر کدام را کنار هم ببینید. ما در 1xAi عمداً قیمتی داخل کد نگذاشته‌ایم، چون قیمت‌ها با نرخ روزانه بازار عوض می‌شوند و فقط در صفحه قیمت‌ها و فهرست مدل‌ها به‌روزند.

اسکریپت پایتون

کلید را از متغیر محیطی ONEXAI_API_KEY می‌خواند (پکیج openai نصب باشد). نام مدل‌ها را با نام‌های فهرست مدل‌ها عوض کنید. پارامتر temperature را عمداً نفرستاده‌ایم، چون مدل‌های نسل ۵ Claude آن را نمی‌پذیرند و همین اسکریپت روی آن‌ها هم کار می‌کند.

import os
import time
from openai import OpenAI

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

MODELS = ["gpt-4.1", "gpt-5.2", "gpt-5.5"]
PROMPT = "یک توضیح محصول ۱۰۰ کلمه‌ای با لحن صمیمی برای یک فروشگاه آنلاین لوازم قهوه بنویس."

for model in MODELS:
    start = time.perf_counter()
    try:
        resp = client.chat.completions.create(
            model=model,
            messages=[{"role": "user", "content": PROMPT}],
        )
    except Exception as exc:
        print(f"{model} | خطا: {exc}")
        continue
    elapsed = time.perf_counter() - start
    usage = resp.usage
    print(
        f"{model} | latency={elapsed:.2f}s | "
        f"prompt_tokens={usage.prompt_tokens} | "
        f"completion_tokens={usage.completion_tokens}"
    )
    with open(f"out_{model}.txt", "w", encoding="utf-8") as f:
        f.write(resp.choices[0].message.content)

خروجی هر مدل یک خط با همین قالب است و متن کامل در فایل out_<model>.txt ذخیره می‌شود. همین درخواست با curl:

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

محاسبه هزینه و ارزیابی

قیمت ورودی و خروجی هر مدل را از جدول قیمت‌ها بردارید و در این فرمول بگذارید:

هزینه = (prompt_tokens ÷ 1,000,000 × قیمت ورودی) + (completion_tokens ÷ 1,000,000 × قیمت خروجی)

برای ارزیابی:

• ۱۰ تا ۲۰ نمونه واقعی از سایت خودتان انتخاب کنید، مثل توضیح محصول، پاسخ پشتیبانی یا مقدمه مقاله.
• هر خروجی را دستی از ۱ تا ۵ برای روانی فارسی و رعایت لحن برند امتیاز بدهید.
• هزینه هر خروجی را ثبت کنید و مجموع هزینه را بر تعداد خروجی‌های قابل‌قبول (مثلاً امتیاز ۴ به بالا) تقسیم کنید.

مدل ارزان‌تر فقط وقتی واقعاً ارزان‌تر است که هزینه هر خروجی قابل‌قبول‌اش کمتر باشد، نه هزینه هر درخواستش.

روتینگ پیشنهادی

پیش‌نویس‌ها را به مدل ارزان‌تر بدهید و فقط بازنویسی نهایی را به مدل قوی‌تر. چون هر دو با یک کلید و یک base_url کار می‌کنند، جابه‌جایی فقط تغییر مقدار model است.

API هوش مصنوعی رایگان واقعاً چقدر رایگان است؟

API هوش مصنوعی دائماً رایگان در 1xAi وجود ندارد. دو مسیر رایگان داریم: یکی چت فارسی برای آزمایش و دیگری اعتبار هدیه‌ی ثبت‌نام برای اجرای واقعی روی API.

دو مسیر رایگان

• چت فارسی: پلن رایگان چت فارسی هر ۳۰ روز ۱۰۰٬۰۰۰ تومان سهمیه می‌دهد، با سقف ۴۰٬۰۰۰ تومان در هفته. مدل‌های آن gpt-4o-mini، claude-haiku-4-5 و gemini-2.5-flash است. برای «سؤال از هوش مصنوعی آنلاین» و محک زدن پرامپت کافی است، اما کلید API نمی‌دهد. پلن‌های Base، Pro و Max در صفحه‌ی پلن‌ها هستند.
• چرخ هدیه: در /free هر حساب یک چرخش دارد و نتیجه سمت سرور تعیین می‌شود. جایزه بین ۱۰۰٬۰۰۰ تا ۱٬۰۰۰٬۰۰۰ تومان اعتبار کیف پول است و منقضی نمی‌شود. این اعتبار روی کلید 1xai-… و آدرس https://1xai.ir/v1 خرج می‌شود، پس اسکریپت تولید دسته‌ای محتوا را هم با آن می‌توان اجرا کرد.

پیش از شارژ پولی

اول با اعتبار هدیه یک نمونه‌ی ۲۰تایی از خروجی واقعی خودتان بسازید و بعد پول شارژ کنید. هزینه‌ی هر مدل را از /pricing بخوانید، چون قیمت‌های تومانی با نرخ روز بازار هماهنگ می‌شوند و عدد ثابتی نیستند. اگر بعداً شارژ کردید، حداقل مبلغ شارژ ۱٬۰۰۰ تومان است و ۱۰٪ مالیات بر ارزش افزوده هنگام پرداخت اضافه می‌شود.

گام بعدی

با بودجه‌ی کوچک، مدل سبک را برگزینید و پرامپت‌های تکراری را با کش پرامپت ارزان‌تر کنید. با بودجه‌ی بزرگ‌تر، فقط مرحله‌ی نهایی (بازنویسی و کنترل کیفیت) را به مدل قوی‌تر بسپارید و پیش‌نویس‌ها را با مدل سبک بسازید.

اگر هدفتان چت‌بات پشتیبانی است، اتصال به سایت یا تلگرام را می‌توانید از فرم درخواست سفارشی به تیم ما بسپارید.

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

تولید محتوا با هوش مصنوعی چیست؟

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

تولید محتوا با هوش مصنوعی چگونه است؟

معمولاً چهار مرحله دارد: طرح کلی، پیش‌نویس، بازنویسی و برچسب‌گذاری، سپس بازبینی انسانی. برای محتوای انبوه از مدل ارزان‌تر استفاده کنید و مدل گران‌تر را فقط برای مرحله‌ی حساس نگه دارید.

بدون VPN و کارت خارجی چگونه به API دسترسی بگیرم؟

ما در 1xAi کلید را از داشبورد می‌دهیم و هر SDK استاندارد OpenAI با base URL به نشانی `https://1xai.ir/v1` کار می‌کند. پرداخت پیش‌پرداخت و تومانی از طریق زرین‌پال است و حداقل شارژ ۱٬۰۰۰ تومان است. [فهرست مدل‌ها](https://1xai.ir/models)

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

قیمت لیست رسمی هر ارائه‌دهنده به‌علاوه‌ی ۲۰٪ مارک‌آپ ثابت. برای مثال، لیست o3 برابر ۲ دلار ورودی و ۸ دلار خروجی به ازای هر یک میلیون توکن است. نرخ تبدیل روزانه به‌روز می‌شود؛ عدد تومانی روز را در [صفحه‌ی قیمت‌ها](https://1xai.ir/pricing) ببینید.

آیا SDK خود Anthropic یا Google هم کار می‌کند؟

بله، هر دو بدون تغییر روی اندپوینت‌های اختصاصی کار می‌کنند. فقط مدل‌های نسل ۵ Claude، یعنی claude-sonnet-5، claude-fable-5 و claude-opus-5، پارامترهای temperature و top_p و همچنین prefill پیام دستیار را نمی‌پذیرند.