Opening (2-4 sentences)

اگر از ایران هستید و OpenAI یا Claude API می‌خواهید، خبر خوب این است که نیازی به کارت بین‌المللی یا VPN ندارید: می‌توانید مستقیماً از 1xAi کلید تولید کنید و با تومان شارژ کنید — اما باید بدانید کدام مدل‌ها ارزان‌تر هستند و چگونه کلید را محفوظ نگه دارید تا اکانتتان ban نشود. این راهنما هر مرحله را از ثبت‌نام تا اولین درخواست API با کد قابل اجرا و نکات امنیتی پوشش می‌دهد، و قیمت‌های واقعی هر مدل را در تومان نشان می‌دهد (بر اساس داده‌های زنده 1xAi در تاریخ 2026-07-19).

TL;DR

اگر از ایران هستید و می‌خواهید OpenAI (یا Claude، Gemini) API استفاده کنید، نیاز به کارت ارزی نیست: می‌توانید مستقیماً از داشبورد 1xAi کلید تولید کنید، آن را در Python/Node SDK تنظیم کنید، و با تومان شارژ کنید — اما کلید را محفوظ نگه دارید تا اکانتتان ban نشود.

---

نویسنده: تیم فنی 1xAi | آخرین بررسی: 2026-07-19

۱. چرا 1xAi؟ دسترسی بدون VPN و بدون کارت خارجی

ما در 1xAi یک درگاه API ایرانی هستیم که توسعه‌دهندگان داخل کشور را مستقیماً به OpenAI، Anthropic (Claude) و Google (Gemini) متصل می‌کند — بدون نیاز به VPN و بدون کارت بانکی خارجی. هر SDK استاندارد OpenAI، Anthropic یا Google GenAI بدون تغییری کار می‌کند؛ تنها کافی است base URL و کلید API را از داشبورد 1xai.ir جایگزین کنید.

توسعه‌دهندگان ایرانی با مسئله‌ای روبرو هستند: OpenAI مستقیماً در ایران تراکنش نمی‌پذیرد و درخواست‌های IP ایرانی را محدود می‌کند. 1xAi این مسئله را حل می‌کند — شما داخل ایران بمانید، از کارت ملی یا حساب بانکی ایرانی استفاده کنید، و ما درخواست‌های شما را به OpenAI ارسال می‌کنیم، بدون نیاز به VPN یا حساب خارجی.

۲. قیمت‌گذاری شفاف: رسمی + ۲۰٪ حاشیه ثابت

1xAi هر مدل را با قیمت رسمی OpenAI/Anthropic/Google به اضافه یک حاشیه ثابت ۲۰٪ بر می‌فروشد، تمام‌چیز به تومان و با نرخ ۳۰۰٫۰۰۰ تومان به ازای هر دلار (بر اساس داده‌های زنده داشبورد 1xAi، آخرین بررسی: ۲۰۲۶-۰۷-۱۹). هیچ هزینه پنهان نیست و شما دقیقاً می‌دانید هر درخواست چقدر هزینه دارد.

مثال: gpt-4o قیمت رسمی ۲٫۵ دلار برای هر میلیون توکن ورودی دارد؛ از طریق 1xAi با حاشیه ۲۰٪ این ۹۰۰٫۰۰۰ تومان به ازای هر میلیون توکن ورودی می‌شود. gpt-4o-mini (مدل ارزان‌تر) فقط ۵۴٫۰۰۰ تومان برای هر میلیون توکن ورودی است. شارژ حداقل ۱٫

تولید API Key از داشبورد 1xAi بدون کارت ارزی

ثبت‌نام در 1xai.ir/dashboard فقط با ایمیل و رمز عبور کافی است — هیچ تأیید هویت یا کارت بین‌المللی لازم نیست.

ما در 1xAi این درگاه را برای توسعه‌دهندگان ایرانی طراحی کردیم تا بتوانند بدون مانع به API‌های OpenAI، Anthropic و Google دسترسی پیدا کنند. در اینجا نحوه تولید کلید خود را مرحله به مرحله شرح می‌دهیم.

مرحله اول: ثبت‌نام و ورود

به 1xai.ir/dashboard بروید و روی "ثبت‌نام" کلیک کنید. فقط ایمیل و رمز عبور وارد کنید — بیش از آن نیازی نیست. پس از تأیید ایمیل، می‌توانید وارد داشبورد شوید. هیچ مدرک شناسایی یا کارت بانکی در این مرحله درخواست نمی‌شود.

مرحله دوم: ایجاد کلید جدید

پس از ورود، به قسمت "API Keys" یا "کلیدهای API" بروید (معمولاً در منوی سمت چپ یا در تب‌های بالای صفحه). دکمه "Create Key" یا "ایجاد کلید جدید" را کلیک کنید. سیستم شما را به فرم ایجاد کلید هدایت خواهد کرد.

مرحله سوم: نام‌گذاری و ذخیره

هر کلید را برای پروژه‌ی خاص نام‌گذاری کنید — مثلاً my-chatbot-prod یا data-scraper-test یا translation-api-dev. این نام‌گذاری بعداً کمک می‌کند تا بتوانید کلیدهای متعدد را مدیریت و ردیابی کنید.

پس از کلیک روی "ایجاد" یا "تأیید"، 1xAi یک رشته‌ی تصادفی تولید می‌کند که با sk-1xai- شروع می‌شود — مثلاً:

sk-1xai-a7f3b9c2d5e1f8g4h6j2k9m1n3p5q7r9

فوری این رشته را کپی کنید و در جای امن ذخیره کنید. بهترین راه‌ها:

• فایل .env محلی (در ریشه پروژه‌ی خود):

  1XAI_API_KEY=sk-1xai-a7f3b9c2d5e1f8g4h6j2k9m1n3p5q7r9
  

• مدیر رمز عبور (مثل Bitwarden، 1Password یا KeePass)
• متغیر محیطی سیستم‌عامل (در Linux/Mac یا Windows)

تنظیم کلید در SDK های Python و Node.js

هر دو SDK استاندارد OpenAI و Anthropic را بدون تغییر قبول می‌کنند — فقط base_url را به https://1xai.ir/v1 تغییر دهید و کلید 1xAi را وارد کنید.

Python

pip install openai را اجرا کنید، سپس:

from openai import OpenAI

client = OpenAI(
    api_key="sk-1xai-YOUR_KEY_HERE",
    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)

این کد درست‌مانند OpenAI رسمی کار می‌کند. کلید خود را از داشبورد 1xai.ir کپی کنید — هر کلید با پیشوند sk-1xai- شروع می‌شود. gpt-4o-mini هزینه‌ای ۵۴,۰۰۰ تومان به ازای هر میلیون توکن ورودی دارد؛ اگر مدل‌های گران‌تر مثل gpt-4o (۹۰۰,۰۰۰ تومان/۱M توکن ورودی) را بخواهید، نام مدل را تغییر دهید.

Node.js

npm install openai را اجرا کنید، سپس:

import OpenAI from "openai";

const client = new OpenAI({
    apiKey: "sk-1xai-YOUR_KEY_HERE",
    baseURL: "https://1xai.ir/v1"
});

const response = await client.chat.completions.create({
    model: "gpt-4o-mini",
    messages: [{ role: "user", content: "سلام" }]
});
console.log(response.choices[0].message.content);

توجه: baseURL (بزرگ‌نویسی U) در Node.js است، نه base_url. کلید و مدل را مثل Python تغییر دهید. هزینه‌ها یکسان هستند — gpt-4o-mini ۲۱۶,۰۰۰ تومان به ازای هر میلیون توکن خروجی هزینه دارد.

Claude (Anthropic)

SDK Anthropic را نصب کنید:

pip install anthropic  # Python
npm install @anthropic-ai/sdk  # Node.js

Python:

from anthropic import Anthropic

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

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

Node.js:

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
    apiKey: "sk-1xai-YOUR_KEY_HERE",
    baseURL: "https://1xai.ir/v1"
});

const response = await client.messages.create({
    model: "claude-3-5-sonnet-20240620",
    max_tokens: 1024,
    messages: [{ role: "user", content: "سلام" }]
});
console.log(response.content[0].text);

کلید و مدل را مثل Python تغییر دهید. هزینه Claude از داشبورد 1xai.ir قابل مشاهده است.

شارژ حساب با تومان و مدیریت بودجه

1xAi از Zarinpal برای پرداخت تومانی پشتیبانی می‌کند — حداقل شارژ ۱٬۰۰۰ تومان، و نرخ عملیاتی ۳۰۰٬۰۰۰ تومان به ازای ۱ دلار برای کل پروژه‌های شما.

ما در 1xAi یک درگاه پرداخت یکپارچه برای توسعه‌دهندگان ایرانی فراهم می‌کنیم؛ هیچ کارت خارجی یا VPN لازم نیست. داشبورد 1xai.ir شما را مستقیماً به صفحه شارژ هدایت می‌کند — بخش Billing را باز کنید و Top-up را انتخاب نمایید تا پنجره Zarinpal ظاهر شود.

روش پرداخت و حداقل شارژ

حداقل شارژ ۱٬۰۰۰ تومان است (حدود ۰٫۰۰۳ دلار)، اما برای پروژه‌های واقعی توصیه می‌کنیم حداقل ۵۰٬۰۰۰ تومان شارژ کنید تا بدون نگرانی از تمام شدن موجودی کار کنید. پس از تأیید پرداخت در Zarinpal، موجودی فوراً به حساب شما اضافه می‌شود و می‌توانید بلافاصله درخواست‌های API را ارسال کنید.

نرخ تبدیل ثابت و قابل پیش‌بینی

در زمان نگارش، 1xAi با نرخ عملیاتی ۳۰۰٬۰۰۰ تومان به ازای ۱ دلار کار می‌کند — این نرخ در داشبورد نمایش داده می‌شود. این به معنی آن است که هزینه‌های شما قابل پیش‌بینی هستند: اگر GPT-4o mini ۰٫۱۵ دلار برای ۱ میلیون توکن ورودی هزینه دارد، شما دقیقاً ۴۵٬۰۰۰ تومان (۰٫۱۵ × ۳۰۰٬۰۰۰) پلاس ۲۰% افزوده ما را پرداخت خواهید کرد — یعنی ۵۴٬۰۰۰ تومان.

قیمت‌گذاری مدل‌ها با افزوده ۲۰ درصد

1xAi هر مدل را با قیمت رسمی OpenAI، Anthropic یا Google بعلاوه ۲۰% افزوده ارائه می‌دهد. مثال‌های زیر براساس نرخ ۳۰۰٬۰۰۰ تومان/دلار محاسبه شده‌اند:

| مدل | نرخ رسمی (دلار/۱M) | نرخ 1xAi با ۲۰% (تومان/۱M) |

نگهداری امن کلید و جلوگیری از ban شدن اکانت

کلید API را هرگز در کد منتشر نکنید — متغیرهای محیطی (.env) یا سرویس‌های مدیریت رمز عبور مانند AWS Secrets Manager استفاده کنید تا اکانتتان در دقایق اول هک نشود.

اگر کلید شما به GitHub، Docker Hub یا هر مخزن عمومی درز کند، بات‌های خودکار OpenAI و رقبای شما آن را در ثانیه‌های اول تشخیص می‌دهند و برای درخواست‌های غیرقانونی یا پرهزینه استفاده می‌کنند. ما در 1xAi این خطر را می‌دانیم و توصیه می‌کنیم کلید را در فایل .env (که در .gitignore است) یا در سرویس‌های رمز‌نگاری مانند HashiCorp Vault ذخیره کنید.

کلید جداگانه برای هر پروژه

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

در داشبورد 1xAi یا OpenAI، می‌توانید چندین کلید ایجاد کنید و برای هر محیط نام متفاوتی بگذارید — مثلاً prod-api-key-2026، dev-test-key، staging-claude. اگر یک کلید توسعه‌ای درز کند، فقط آن محیط در خطر است؛ سرویس تولید شما ادامه می‌دهد. این روش از هک‌های زنجیره‌ای جلوگیری می‌کند.

بررسی منظم و حذف کلیدهای قدیمی

هر ماه به بخش "API Keys" برگردید و کلیدهای قدیمی یا غیرفعال را حذف کنید.

در داشبورد 1xai.ir، روی "Settings" > "API Keys" کلیک کنید و هر کلیدی که دیگر استفاده نمی‌شود را حذف کنید. اگر یک پروژه تمام شد یا یک توسعه‌دهنده تیم را ترک کرد، کلید او را فوری غیرفعال کنید. این عادت سطح حمله را کاهش می‌دهد.

هشدار مصرف غیرعادی و عکس‌العمل فوری

اگر مصرف ناگهان بالا رفت (مثلاً 10 برابر معمول)، فوری کلید را غیرفعال کنید و رمز عبور داشبورد را تغییر دهید — این نشانه‌ی هک است.

1xAi و OpenAI هر دو هشدار ایمیلی برای فعالیت غیرعادی ارسال می‌کنند. اگر صبح بیدار شدید و دیدید که در شب هزینه‌ای غیرمعمول خرج شده، فوری کلید را غیرفعال کنید و رمز عبور خود را تغییر دهید.

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

چطور می‌توانم بدون کارت ارزی و VPN از ایران API OpenAI استفاده کنم؟

از داشبورد 1xai.ir کلید API تولید کنید — نیاز به تأیید هویت یا کارت خارجی ندارید، فقط ایمیل و رمز عبور کافی است. سپس کلید را در Python یا Node SDK تنظیم کنید و با تومان از طریق Zarinpal شارژ کنید.

قیمت استفاده از GPT-4o و GPT-4o-mini از ایران چقدر است؟

GPT-4o از 1xAi: 900,000 تومان برای 1 میلیون توکن ورودی و 3,600,000 تومان برای 1 میلیون توکن خروجی. GPT-4o-mini: 54,000 تومان برای 1 میلیون توکن ورودی و 216,000 تومان برای 1 میلیون توکن خروجی (شامل 20% حاشیه سود 1xAi است).

آیا می‌توانم Claude و Gemini را هم از 1xAi استفاده کنم؟

بله، یک کلید 1xAi برای OpenAI، Anthropic (Claude) و Google (Gemini) کار می‌کند — فقط نام مدل را در درخواست مشخص کنید و 1xAi آن را به سرویس صحیح هدایت می‌کند.

حداقل شارژ برای حساب 1xAi چقدر است؟

حداقل شارژ 1,000 تومان است و شما می‌توانید از طریق Zarinpal در داشبورد 1xAi تومان شارژ کنید.

کلید API من را کجا ذخیره کنم تا حساب من ban نشود؟

کلید را فوری پس از تولید کپی کنید و در یک فایل `.env` محلی یا مدیر رمز عبور ذخیره کنید — هرگز آن را در کد یا GitHub قرار ندهید. بعد از بستن پنجره داشبورد، دوباره نمی‌توانید کلید را ببینید.

چگونه کلید API را در Python تنظیم کنم؟

`pip install openai` را اجرا کنید، سپس: ```python from openai import OpenAI client = OpenAI(api_key="sk-1xai-YOUR_KEY", base_url="https://1xai.ir/v1") response = client.chat.completions.create(model="gpt-4o-mini", messages=[{"role": "user", "content": "سلام"}]) ```

آیا می‌توانم یک کلید برای تست و یک کلید برای تولید داشته باشم؟

بله، از داشبورد 1xAi چند کلید با نام‌های متفاوت (مثل `test-key` و `prod-key`) تولید کنید تا بتوانید هر کدام را جداگانه ردیابی و کنترل کنید.