اتصال Open WebUI به API هوش مصنوعی از ایران
Open WebUI محبوبترین رابط چت سلفهاست است — یک ChatGPT شخصی روی سرور یا لپتاپ خودت. با دو متغیر محیطی میتوانی آن را به 1xAi وصل کنی تا همهٔ مدلهای OpenAI، Anthropic، Gemini و DeepSeek با یک کلید تومانی در همان رابط در دسترس باشند.
راهاندازی در چند دقیقه
- 01
ساخت حساب و دریافت کلید 1xAi
در 1xai.ir ثبتنام و ایمیلت را تأیید کن. هدیهٔ ۱۰۰٬۰۰۰ تومانی پس از ثبتنام با یک کلیک از داشبورد دریافت میشود. سپس از داشبورد یک کلید 1xai-* بساز و همان لحظه یک نسخه از آن کپی کن — کلید فقط یک بار نمایش داده میشود.
- 02
اجرای کانتینر با متغیرهای محیطی
هنگام اجرای Docker، دو متغیر OPENAI_API_BASE_URL=https://1xai.ir/v1 و OPENAI_API_KEY را با کلید 1xai-* ست کن. متغیرها باید قبل از استارت کانتینر تعریف شده باشند.
- 03
یا: تنظیم از پنل ادمین
اگر Open WebUI از قبل بالا است، از مسیر Admin Panel → Settings → Connections بخش OpenAI API را باز کن و آدرس و کلید را همانجا وارد و ذخیره کن.
- 04
انتخاب مدل
فهرست مدلها بهصورت خودکار از /v1/models خوانده میشود. از انتخابگر بالای صفحهٔ چت مدل موردنظر را بردار — مثلاً gpt-5 یا claude-sonnet-4-6.
- 05
اولین گفتگو
یک پیام بفرست تا اتصال را تأیید کنی. هزینهٔ تومانی هر تماس در گزارش مصرف داشبورد 1xAi ثبت میشود.
تنظیمات آماده برای کپی
docker run -d -p 3000:8080 \
-e OPENAI_API_BASE_URL=https://1xai.ir/v1 \
-e OPENAI_API_KEY=1xai-XXXXXXXXXXXXXXXX \
-v open-webui:/app/backend/data \
--name open-webui \
ghcr.io/open-webui/open-webui:main
# سپس در مرورگر: http://localhost:3000مدل پیشنهادی و هزینه
پیشنهاد: gpt-5 — و برای هزینهٔ کمتر: gpt-4o-mini
برای گفتگوی اصلی، یک مدل قوی مثل gpt-5 یا claude-sonnet-4-6 بگذار و برای کارهای روزمره و پرتکرار به gpt-4o-mini یا gemini-2.5-flash سوئیچ کن — انتخابگر مدل Open WebUI جابهجایی را یککلیکه میکند.
هزینهٔ تقریبی به حجم توکن مصرفیات بستگی دارد: قیمت تومانی هر مدل، قیمت لیست سرویسدهنده بهعلاوهٔ مارکآپ ثابت ۲۰٪ است و نرخ دلار هر روز ساعت ۰۹:۰۰ بهوقت تهران بهصورت خودکار با بازار همگام میشود. عدد دقیق برای مصرف خودت را در محاسبهگر هزینه ببین.
اگر کار نکرد
- فهرست مدلها خالی است
- متغیرهای محیطی باید قبل از استارت کانتینر ست شده باشند؛ بعد از هر تغییر، کانتینر را ریاستارت کن. مطمئن شو آدرس /v1 را در انتها دارد و در Connections فعال (روشن) است.
- 401 — کلید نامعتبر
- کلید اشتباه است، منقضی شده یا باطلش کردهای. کلید را دوباره از داشبورد کپی کن یا یک کلید تازه بساز. فاصله یا خط جدیدِ اضافی هنگام paste رایجترین علت این خطاست.
- 402 — موجودی کافی نیست
- اعتبار تومانی حسابت تمام شده. حداقل شارژ ۱۰۰٬۰۰۰ تومان از طریق زرینپال است و بلافاصله پس از پرداختِ موفق، تماسهای بعدی کار میکنند. شارژ حساب ←
- خطای نام مدل / مسیریابی
- 1xAi بر اساس نام مدل مسیریابی میکند: claude-* به Anthropic، gemini-* به Google، deepseek-* به DeepSeek و بقیهٔ نامها به OpenAI میروند. نام مدل را دقیقاً از صفحهٔ مدلها کپی کن — یک حرف اشتباه یعنی خطای مدلِ ناشناخته. فهرست مدلها و قیمت تومانی ←
با اعتبار هدیهٔ ۱۰۰٬۰۰۰ تومانی شروع کن
هدیه پس از ثبتنام با یک کلیک از داشبورد دریافت میشود — بدون ویپیان و بدون کارت ارزی؛ حداقل شارژ بعدی ۱۰۰٬۰۰۰ تومان از طریق زرینپال است.
آیا میتوانم چند مدل از چند سرویسدهنده را همزمان داشته باشم؟
بله، با همان یک اتصال. 1xAi همهٔ مدلهای قیمتگذاریشده را از /v1/models برمیگرداند و بر اساس نام مدل به سرویسدهندهٔ درست مسیریابی میکند — GPT، Claude، Gemini و DeepSeek کنار هم در انتخابگر مدل ظاهر میشوند.
آیا متن گفتگوهای من جایی ذخیره میشود؟
تاریخچهٔ چت روی سرور خودت (والیوم Open WebUI) میماند. 1xAi درخواست را به سرویسدهندهٔ همان مدل میرساند و فقط متادیتای حداقلی (مدل، توکن، وضعیت، زمان) را برای گزارش مصرف نگه میدارد.
- مدلها و قیمت تومانی
فهرست کامل مدلها با نرخ لحظهای هر ۱ میلیون توکن
- محاسبهگر هزینه
برآورد هزینهٔ ماهانه بر پایهٔ مصرف واقعی خودت
- خرید API هوش مصنوعی
شروع کار با کلید بومی و پرداخت تومانی
- مستندات کامل
مرجع API، مسیرهای نیتیو، استریم و کدهای خطا
- وضعیت سرویس
سلامت لحظهای اتصال به هر سرویسدهنده