USE CASESاتصال ابزارها

راهنمای اتصال ابزارها به API هوش مصنوعی از ایران

Q: آیا یک کلید برای همهٔ این ابزارها کافی است؟

بله؛ یک کلید 1xai-* به مدلهای OpenAI، Anthropic، Gemini و DeepSeek دسترسی میدهد و میتوانی همان کلید را در چند ابزار بگذاری. با این حال بهتر است برای هر ابزار یک کلید جدا با نام و سقف هزینهٔ مشخص بسازی تا مصرف هرکدام در داشبورد تفکیک شود.

Q: شروع کار چقدر هزینه دارد؟

گردونهٔ هدیه پس از ثبتنام یک بار از داشبورد چرخانده میشود و از ۱۰۰٬۰۰۰ تا ۱٬۰۰۰٬۰۰۰ تومان اعتبار میدهد — برای راهاندازی و تست همهٔ این ابزارها کافی است. پس از آن، حداقل شارژ ۱۰۰٬۰۰۰ تومان از طریق زرینپال است و قیمت هر مدل، قیمت لیست سرویسدهنده بهعلاوهٔ مارکآپ ثابت ۲۰٪ است.

هر ابزاری که Base URL سفارشی بپذیرد، با 1xAi کار می‌کند. این راهنماها برای محبوب‌ترین‌ها گام‌به‌گام نوشته شده‌اند — از ادیتور کد تا اتوماسیون و رابط چت سلف‌هاست؛ همه با یک کلید 1xai-* و صورت‌حساب تومانی.

IDEادیتور کد

اتصال Cursor

Cursor به‌صورت پیش‌فرض به API رسمی OpenAI وصل می‌شود که از داخل ایران در دسترس نیست. راه‌حل، قابلیت رسمی خود Cursor است: Override کردن Base URL. با دو فیلد در تنظیمات — کلید 1xAi و آدرس پایهٔ سازگار با OpenAI — چتِ داخل ادیتور با کلید خودت کار می‌کند؛ بدون وی‌پی‌ان و بدون کارت ارزی.

راهنمای کامل

CLIایجنت کدنویسی

اتصال Claude Code

Claude Code — ایجنت کدنویسی ترمینالی Anthropic — به‌صورت پیش‌فرض به api.anthropic.com وصل می‌شود. با دو متغیر محیطی می‌توانی آن را روی مسیر نیتیو Anthropic در 1xAi بیاوری: همان Messages API رسمی، اما با کلید ایرانی و کسر هزینه به تومان. نه حساب Anthropic لازم است، نه کارت ارزی.

راهنمای کامل

AUTOMATIONاتوماسیون

اتصال n8n

در n8n هر نود هوش مصنوعی — از نود OpenAI تا AI Agent و زنجیره‌های LLM — با یک Credential کار می‌کند. آن Credential یک فیلد Base URL دارد؛ کافی است به‌جای آدرس رسمی OpenAI، آدرس 1xAi را بگذاری تا کل ورک‌فلوهایت از داخل ایران و با صورت‌حساب تومانی اجرا شوند.

راهنمای کامل

VS CODEایجنت کدنویسی

اتصال Cline

Cline افزونهٔ متن‌باز ایجنت کدنویسی برای VS Code است: فایل می‌سازد، ویرایش می‌کند و دستور اجرا می‌کند. برای مدل، کافی است ارائه‌دهندهٔ OpenAI Compatible را انتخاب کنی و Base URL و کلید 1xAi را بدهی — از داخل ایران و بدون هیچ واسطهٔ دیگری کار می‌کند.

راهنمای کامل

SELF-HOSTEDرابط چت

اتصال Open WebUI

Open WebUI محبوب‌ترین رابط چت سلف‌هاست است — یک ChatGPT شخصی روی سرور یا لپ‌تاپ خودت. با دو متغیر محیطی می‌توانی آن را به 1xAi وصل کنی تا همهٔ مدل‌های OpenAI، Anthropic، Gemini و DeepSeek با یک کلید تومانی در همان رابط در دسترس باشند.

راهنمای کامل

VS CODE / JETBRAINSدستیار کدنویسی

اتصال Continue

Continue دستیار کدنویسی متن‌باز برای VS Code و JetBrains است و پیکربندی‌اش یک فایل ساده است: config.yaml. هر مدل یک بلوک است و فیلد apiBase همان‌جایی است که آدرس 1xAi را می‌گذاری — می‌توانی چند مدل از چند سرویس‌دهنده را کنار هم تعریف کنی و همه با یک کلید تومانی کار کنند.

راهنمای کامل

HOW IT WORKSیک ایده، همهٔ ابزارها

آدرس سازگار با OpenAI

در هر ابزاری که کلاینت OpenAI دارد، آدرس پایه را عوض کن:

https://1xai.ir/v1

مسیر نیتیو Anthropic

ابزارهای مخصوص Claude — مثل Claude Code — به مسیر نیتیو وصل می‌شوند:

https://1xai.ir/anthropic

یک کلید، چهار سرویس‌دهنده

مسیریابی با نام مدل است: claude-* به Anthropic، gemini-* به Google، deepseek-* به DeepSeek و بقیه به OpenAI.

ابزارت اینجا نیست؟

اگر ابزارت Base URL سفارشی می‌پذیرد، همین حالا کار می‌کند — مستندات کامل API را ببین یا از ما بپرس.

مستندات API تماس با ما

STARTشروع کار

پیش از پیکربندی هر ابزاری، فقط دو چیز لازم داری: یک حساب و یک کلید 1xai-* با کمی اعتبار. مسیر رایگان برای تست، و خرید اعتبار تومانی برای استفادهٔ جدی — هر دو از همین‌جا:

خرید اعتبار API به تومان

پرداخت با کارت بانکی ایرانی از طریق زرین‌پال — بدون کارت ارزی و بدون وی‌پی‌ان. قیمت هر مدل، نرخ لیست سرویس‌دهنده به‌علاوهٔ مارک‌آپ ثابت ۲۰٪ است.

راهنمای خرید

API رایگان هوش مصنوعی

با اعتبار هدیهٔ ثبت‌نام، همین ابزارها را بدون پرداخت اولیه راه‌اندازی و تست کن — بعد اگر راضی بودی، شارژ کن.

شروع رایگان

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

این ابزارها چطور بدون وی‌پی‌ان به مدل‌های هوش مصنوعی وصل می‌شوند؟

همهٔ این ابزارها جایی برای تغییر آدرس پایه (Base URL) دارند. کافی است به‌جای آدرس رسمی سرویس‌دهنده، آدرس سازگار با OpenAI 1xAi یعنی https://1xai.ir/v1 را بگذاری و کلید 1xai-* را وارد کنی — درخواست‌ها از داخل ایران کار می‌کنند و هزینه به تومان از حسابت کسر می‌شود.

آیا یک کلید برای همهٔ این ابزارها کافی است؟

بله؛ یک کلید 1xai-* به مدل‌های OpenAI، Anthropic، Gemini و DeepSeek دسترسی می‌دهد و می‌توانی همان کلید را در چند ابزار بگذاری. با این حال بهتر است برای هر ابزار یک کلید جدا با نام و سقف هزینهٔ مشخص بسازی تا مصرف هرکدام در داشبورد تفکیک شود.

شروع کار چقدر هزینه دارد؟

گردونهٔ هدیه پس از ثبت‌نام یک بار از داشبورد چرخانده می‌شود و از ۱۰۰٬۰۰۰ تا ۱٬۰۰۰٬۰۰۰ تومان اعتبار می‌دهد — برای راه‌اندازی و تست همهٔ این ابزارها کافی است. پس از آن، حداقل شارژ ۱۰۰٬۰۰۰ تومان از طریق زرین‌پال است و قیمت هر مدل، قیمت لیست سرویس‌دهنده به‌علاوهٔ مارک‌آپ ثابت ۲۰٪ است.