راهنمای اتصال ابزارها به API هوش مصنوعی از ایران
هر ابزاری که Base URL سفارشی بپذیرد، با 1xAi کار میکند. این راهنماها برای محبوبترینها گامبهگام نوشته شدهاند — از ادیتور کد تا اتوماسیون و رابط چت سلفهاست؛ همه با یک کلید 1xai-* و صورتحساب تومانی.
اتصال Cursor
Cursor بهصورت پیشفرض به API رسمی OpenAI وصل میشود که از داخل ایران در دسترس نیست. راهحل، قابلیت رسمی خود Cursor است: Override کردن Base URL. با دو فیلد در تنظیمات — کلید 1xAi و آدرس پایهٔ سازگار با OpenAI — چتِ داخل ادیتور با کلید خودت کار میکند؛ بدون ویپیان و بدون کارت ارزی.
راهنمای کامل ←
اتصال Claude Code
Claude Code — ایجنت کدنویسی ترمینالی Anthropic — بهصورت پیشفرض به api.anthropic.com وصل میشود. با دو متغیر محیطی میتوانی آن را روی مسیر نیتیو Anthropic در 1xAi بیاوری: همان Messages API رسمی، اما با کلید ایرانی و کسر هزینه به تومان. نه حساب Anthropic لازم است، نه کارت ارزی.
راهنمای کامل ←
اتصال n8n
در n8n هر نود هوش مصنوعی — از نود OpenAI تا AI Agent و زنجیرههای LLM — با یک Credential کار میکند. آن Credential یک فیلد Base URL دارد؛ کافی است بهجای آدرس رسمی OpenAI، آدرس 1xAi را بگذاری تا کل ورکفلوهایت از داخل ایران و با صورتحساب تومانی اجرا شوند.
راهنمای کامل ←
اتصال Cline
Cline افزونهٔ متنباز ایجنت کدنویسی برای VS Code است: فایل میسازد، ویرایش میکند و دستور اجرا میکند. برای مدل، کافی است ارائهدهندهٔ OpenAI Compatible را انتخاب کنی و Base URL و کلید 1xAi را بدهی — از داخل ایران و بدون هیچ واسطهٔ دیگری کار میکند.
راهنمای کامل ←
اتصال Open WebUI
Open WebUI محبوبترین رابط چت سلفهاست است — یک ChatGPT شخصی روی سرور یا لپتاپ خودت. با دو متغیر محیطی میتوانی آن را به 1xAi وصل کنی تا همهٔ مدلهای OpenAI، Anthropic، Gemini و DeepSeek با یک کلید تومانی در همان رابط در دسترس باشند.
راهنمای کامل ←
اتصال Continue
Continue دستیار کدنویسی متنباز برای VS Code و JetBrains است و پیکربندیاش یک فایل ساده است: config.yaml. هر مدل یک بلوک است و فیلد apiBase همانجایی است که آدرس 1xAi را میگذاری — میتوانی چند مدل از چند سرویسدهنده را کنار هم تعریف کنی و همه با یک کلید تومانی کار کنند.
راهنمای کامل ←
آدرس سازگار با OpenAI
در هر ابزاری که کلاینت OpenAI دارد، آدرس پایه را عوض کن:
https://1xai.ir/v1
مسیر نیتیو Anthropic
ابزارهای مخصوص Claude — مثل Claude Code — به مسیر نیتیو وصل میشوند:
https://1xai.ir/anthropic
یک کلید، چهار سرویسدهنده
مسیریابی با نام مدل است: claude-* به Anthropic، gemini-* به Google، deepseek-* به DeepSeek و بقیه به OpenAI.
ابزارت اینجا نیست؟
اگر ابزارت Base URL سفارشی میپذیرد، همین حالا کار میکند — مستندات کامل API را ببین یا از ما بپرس.
این ابزارها چطور بدون ویپیان به مدلهای هوش مصنوعی وصل میشوند؟
همهٔ این ابزارها جایی برای تغییر آدرس پایه (Base URL) دارند. کافی است بهجای آدرس رسمی سرویسدهنده، آدرس سازگار با OpenAI 1xAi یعنی https://1xai.ir/v1 را بگذاری و کلید 1xai-* را وارد کنی — درخواستها از داخل ایران کار میکنند و هزینه به تومان از حسابت کسر میشود.
آیا یک کلید برای همهٔ این ابزارها کافی است؟
بله؛ یک کلید 1xai-* به مدلهای OpenAI، Anthropic، Gemini و DeepSeek دسترسی میدهد و میتوانی همان کلید را در چند ابزار بگذاری. با این حال بهتر است برای هر ابزار یک کلید جدا با نام و سقف هزینهٔ مشخص بسازی تا مصرف هرکدام در داشبورد تفکیک شود.
شروع کار چقدر هزینه دارد؟
هدیهٔ ۱۰۰٬۰۰۰ تومانی پس از ثبتنام با یک کلیک از داشبورد دریافت میشود و برای راهاندازی و تست همهٔ این ابزارها کافی است. پس از آن، حداقل شارژ ۱۰۰٬۰۰۰ تومان از طریق زرینپال است و قیمت هر مدل، قیمت لیست سرویسدهنده بهعلاوهٔ مارکآپ ثابت ۲۰٪ است.