TEHRAN
1xAi
USE CASE · IDE · ادیتور کد

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

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

SETUP · گام‌به‌گام

راه‌اندازی در چند دقیقه

  1. 01

    ساخت حساب و دریافت کلید 1xAi

    در 1xai.ir ثبت‌نام و ایمیلت را تأیید کن. هدیهٔ ۱۰۰٬۰۰۰ تومانی پس از ثبت‌نام با یک کلیک از داشبورد دریافت می‌شود. سپس از داشبورد یک کلید 1xai-* بساز و همان لحظه یک نسخه از آن کپی کن — کلید فقط یک بار نمایش داده می‌شود.

  2. 02

    باز کردن تنظیمات مدل‌ها

    در Cursor تنظیمات را باز کن (Ctrl/Cmd + Shift + J) و به بخش Models برو.

  3. 03

    وارد کردن کلید در بخش OpenAI API Key

    کلید 1xai-* را در فیلد OpenAI API Key بچسبان — دقیقاً همان‌جایی که کلید رسمی OpenAI را می‌پذیرد.

  4. 04

    فعال‌کردن Override OpenAI Base URL

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

  5. 05

    تأیید اتصال

    دکمهٔ Verify را بزن. اگر کلید و آدرس درست باشند، اتصال تأیید می‌شود و مدل‌ها فعال می‌شوند.

  6. 06

    انتخاب مدل و اولین پیام

    از فهرست مدل‌ها یکی را فعال کن — یا با Add model نام دلخواه مثل claude-sonnet-4-6 یا gemini-2.5-flash را اضافه کن — و در چت Cursor پیام بده. هزینهٔ تومانی همان تماس در داشبورد 1xAi ثبت می‌شود.

CONFIG · پیکربندی

تنظیمات آماده برای کپی

Cursor → Settings → Modelsini
; Cursor Settings (Ctrl/Cmd + Shift + J) → Models
OpenAI API Key           = 1xai-XXXXXXXXXXXXXXXX
Override OpenAI Base URL = https://1xai.ir/v1

; مدل‌های غیر-OpenAI را با Add model اضافه کن:
;   claude-sonnet-4-6   → Anthropic
;   gemini-2.5-flash    → Google
MODEL · انتخاب مدل

مدل پیشنهادی و هزینه

پیشنهاد: claude-sonnet-4-6 — و برای هزینهٔ کمتر: gpt-4o-mini

برای چت و ویرایش کد، claude-sonnet-4-6 توازن خوبی بین کیفیت کدنویسی و هزینه دارد؛ برای پرسش‌های سبک و سریع، gpt-4o-mini به‌مراتب ارزان‌تر است.

هزینهٔ تقریبی به حجم توکن مصرفی‌ات بستگی دارد: قیمت تومانی هر مدل، قیمت لیست سرویس‌دهنده به‌علاوهٔ مارک‌آپ ثابت ۲۰٪ است و نرخ دلار هر روز ساعت ۰۹:۰۰ به‌وقت تهران به‌صورت خودکار با بازار همگام می‌شود. عدد دقیق برای مصرف خودت را در محاسبه‌گر هزینه ببین.

TROUBLESHOOTING · رفع اشکال

اگر کار نکرد

Verify ناموفق است
مطمئن شو آدرس دقیقاً https://1xai.ir/v1 است — با /v1 در انتها و بدون اسلش اضافی — و کلید بدون فاصلهٔ ابتدا/انتها چسبانده شده. سلامت لحظه‌ای سرویس را هم می‌توانی در صفحهٔ /status ببینی.
401 — کلید نامعتبر
کلید اشتباه است، منقضی شده یا باطلش کرده‌ای. کلید را دوباره از داشبورد کپی کن یا یک کلید تازه بساز. فاصله یا خط جدیدِ اضافی هنگام paste رایج‌ترین علت این خطاست.
402 — موجودی کافی نیست
اعتبار تومانی حسابت تمام شده. حداقل شارژ ۱۰۰٬۰۰۰ تومان از طریق زرین‌پال است و بلافاصله پس از پرداختِ موفق، تماس‌های بعدی کار می‌کنند. شارژ حساب ←
خطای نام مدل / مسیریابی
1xAi بر اساس نام مدل مسیریابی می‌کند: claude-* به Anthropic، gemini-* به Google، deepseek-* به DeepSeek و بقیهٔ نام‌ها به OpenAI می‌روند. نام مدل را دقیقاً از صفحهٔ مدل‌ها کپی کن — یک حرف اشتباه یعنی خطای مدلِ ناشناخته. فهرست مدل‌ها و قیمت تومانی ←

با اعتبار هدیهٔ ۱۰۰٬۰۰۰ تومانی شروع کن

هدیه پس از ثبت‌نام با یک کلیک از داشبورد دریافت می‌شود — بدون وی‌پی‌ان و بدون کارت ارزی؛ حداقل شارژ بعدی ۱۰۰٬۰۰۰ تومان از طریق زرین‌پال است.

ساخت حساب رایگانشارژ حساب
FAQ · سوالات متداول

آیا مدل‌های Claude و Gemini هم در Cursor با این روش کار می‌کنند؟

بله. 1xAi بر اساس نام مدل مسیریابی می‌کند؛ کافی است با Add model نامی مثل claude-sonnet-4-6 یا gemini-2.5-flash را اضافه کنی. همان کلید و همان Base URL برای هر چهار سرویس‌دهنده (OpenAI، Anthropic، Gemini و DeepSeek) کافی است.

شروع کار با Cursor و 1xAi چقدر هزینه دارد؟

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

RESOURCES · منابع مرتبط
MORE GUIDES · راهنماهای دیگر