
API OpenAI دسترسی برنامهنویسی به مدلهای OpenAI است — نه یک اشتراک چت، بلکه زیرسازی برای ادغام چتبات پشتیبانی، جستوجوی هوشمند یا تحلیل نظرات در محصول واقعی شما. مسئله تیمهای ایرانی تاریخی یک چیز بوده: کلید API بدون کارت بانکی خارجی و بدون VPN دریافت کنند.
API OpenAI چگونه کار میکند؟ شما حسابی ثبت میکنید، کلید API دریافت میکنید، و سپس در کد خود آن را با base URL اندپوینت تنظیم میکنید. برای مثال، 1xAi یک گیتوی OpenAI-compatible اداره میکند که توسعهدهندگان ایرانی میتوانند از آن استفاده کنند تا به جای OpenAI مستقیم، از کلاینت کنند — کلید از داشبورد 1xai.ir صادر میشود و پرداخت از درگاههای ایرانی با تومان انجام میشود.
https://1xai.ir/v1
آیا API رایگان است؟ خیر. مدل پرداخت بر اساس مصرف توکن است و هیچ لایه رایگان نامحدود وجود ندارد. اشتراک ChatGPT — نسخه رایگان یا پولی — جایگزین API نیست؛ چون برای استفاده شخصی طراحی شده و مجوز ادغام تجاری ندارد. API برای برنامهنویسی و نرمافزار است.
مسیر عملی چگونه است؟ چهار مرحله: اول، ثبتنام و دریافت کلید API از پنل 1xAi. دوم، تست در محیط آزمایشی (playground یا curl). سوم، اتصال SDK رسمی OpenAI یا هر کلاینت سازگار با تنظیم base_url روی چهارم، انتقال کلید به محیط امن (متغیر محیطی یا secret manager) و استقرار در Production.
https://1xai.ir/v1
حساب چگونه سازمانیافته است؟ ساختار سه لایه دارد: یک Organization در بالا، چند Project زیرش، و کلیدهای API که هرکدام به یک Project متصل میشوند. بهترین روش این است که یک Project برای هر محیط (development، staging، production) داشته باشید تا اگر خطایی در یکی رخ داد، بقیه بدون وقفه کار کند. درون هر Project میتوانید چند کلید داشته باشید — مثلاً یک برای بکاند و یک برای تستها — و اگر کلیدی لو رفت، فقط آن کلید را ابطال میکنید.
قیمتگذاری چطور کار میکند؟ قیمت هر روز ساعت ۹ صبح با نرخ بازار همگام میشود و 1xAi یک مارکآپ ثابت ۲۰% روی نرخ رسمی OpenAI اضافه میکند. قیمت تومانی جاری هر مدل را باید در ببینید، نه از اینجا استخراج کنید.
https://1xai.ir/pricing
نمونه کد ساده با پایتون:
from openai import OpenAI
client = OpenAI(
base_url="https://1xai.ir/v1",
api_key="YOUR_1XAI_KEY"
)
response = client.chat.completions.create(
model="o4-mini",
messages=[{"role": "user", "content": "سلام"}]
)
1xAi این زیرساخت را برای توسعهدهندگان ایرانی اداره میکند تا بتوانند بدون کارت خارجی یا VPN، مستقیم از درگاههای داخلی استفاده کنند. مدلهای در دسترس همیشه در بهروز هستند.
https://1xai.ir/models
جزئیات کامل، نمونههای بیشتر و مقایسههای قیمتی:
https://1xai.ir/blog/api-openai-iran-developers-2026