اتصال Cline به API هوش مصنوعی از ایران
Cline افزونهٔ متنباز ایجنت کدنویسی برای VS Code است: فایل میسازد، ویرایش میکند و دستور اجرا میکند. برای مدل، کافی است ارائهدهندهٔ OpenAI Compatible را انتخاب کنی و Base URL و کلید 1xAi را بدهی — از داخل ایران و بدون هیچ واسطهٔ دیگری کار میکند.
راهاندازی در چند دقیقه
- 01
ساخت حساب و دریافت کلید 1xAi
در 1xai.ir ثبتنام و ایمیلت را تأیید کن. هدیهٔ ۱۰۰٬۰۰۰ تومانی پس از ثبتنام با یک کلیک از داشبورد دریافت میشود. سپس از داشبورد یک کلید 1xai-* بساز و همان لحظه یک نسخه از آن کپی کن — کلید فقط یک بار نمایش داده میشود.
- 02
نصب افزونهٔ Cline
در VS Code از بخش Extensions افزونهٔ Cline را نصب کن و آیکون آن را در نوار کناری باز کن.
- 03
انتخاب ارائهدهندهٔ OpenAI Compatible
در تنظیمات Cline، فیلد API Provider را روی OpenAI Compatible بگذار — نه OpenAI؛ گزینهٔ Compatible است که اجازهٔ Base URL سفارشی میدهد.
- 04
وارد کردن Base URL و کلید
Base URL را https://1xai.ir/v1 بگذار و در فیلد API Key کلید 1xai-* را وارد کن.
- 05
تعیین Model ID
در فیلد Model ID نام دقیق مدل را بنویس — مثلاً claude-sonnet-4-6 برای کدنویسی. نام مدل را از صفحهٔ مدلهای 1xAi کپی کن.
- 06
اولین تسک
یک تسک ساده بده (مثلاً «این فایل را توضیح بده») تا اتصال را تأیید کنی. هزینهٔ تومانی هر تماس در داشبورد 1xAi ثبت میشود.
تنظیمات آماده برای کپی
; Cline (VS Code) → Settings → API Configuration
API Provider = OpenAI Compatible
Base URL = https://1xai.ir/v1
API Key = 1xai-XXXXXXXXXXXXXXXX
Model ID = claude-sonnet-4-6مدل پیشنهادی و هزینه
پیشنهاد: claude-sonnet-4-6 — و برای هزینهٔ کمتر: gpt-4o-mini
ایجنتهای کدنویسی مثل Cline در هر تسک چندین تماس پشتسرهم میزنند؛ claude-sonnet-4-6 کیفیت ویرایش چندفایله را بالا نگه میدارد و برای تسکهای کوچک، gpt-4o-mini هزینه را پایین میآورد.
هزینهٔ تقریبی به حجم توکن مصرفیات بستگی دارد: قیمت تومانی هر مدل، قیمت لیست سرویسدهنده بهعلاوهٔ مارکآپ ثابت ۲۰٪ است و نرخ دلار هر روز ساعت ۰۹:۰۰ بهوقت تهران بهصورت خودکار با بازار همگام میشود. عدد دقیق برای مصرف خودت را در محاسبهگر هزینه ببین.
اگر کار نکرد
- مصرف بالاتر از انتظار
- ایجنتها برای هر تسک چند تماس میزنند و کل فایلهای زمینه را میفرستند. هنگام ساخت کلید در داشبورد میتوانی سقف هزینه برای همان کلید تعیین کنی تا مصرف Cline از حد مشخصی عبور نکند.
- 401 — کلید نامعتبر
- کلید اشتباه است، منقضی شده یا باطلش کردهای. کلید را دوباره از داشبورد کپی کن یا یک کلید تازه بساز. فاصله یا خط جدیدِ اضافی هنگام paste رایجترین علت این خطاست.
- 402 — موجودی کافی نیست
- اعتبار تومانی حسابت تمام شده. حداقل شارژ ۱۰۰٬۰۰۰ تومان از طریق زرینپال است و بلافاصله پس از پرداختِ موفق، تماسهای بعدی کار میکنند. شارژ حساب ←
- خطای نام مدل / مسیریابی
- 1xAi بر اساس نام مدل مسیریابی میکند: claude-* به Anthropic، gemini-* به Google، deepseek-* به DeepSeek و بقیهٔ نامها به OpenAI میروند. نام مدل را دقیقاً از صفحهٔ مدلها کپی کن — یک حرف اشتباه یعنی خطای مدلِ ناشناخته. فهرست مدلها و قیمت تومانی ←
با اعتبار هدیهٔ ۱۰۰٬۰۰۰ تومانی شروع کن
هدیه پس از ثبتنام با یک کلیک از داشبورد دریافت میشود — بدون ویپیان و بدون کارت ارزی؛ حداقل شارژ بعدی ۱۰۰٬۰۰۰ تومان از طریق زرینپال است.
چرا باید OpenAI Compatible را انتخاب کنم و نه OpenAI؟
گزینهٔ OpenAI در Cline به آدرس رسمی api.openai.com قفل است. گزینهٔ OpenAI Compatible همان پروتکل را با Base URL دلخواه میپذیرد — و چون 1xAi دقیقاً با همین استاندارد ارائه میشود، فقط آدرس و کلید را عوض میکنی.
آیا با یک کلید میتوانم بین Claude و GPT جابهجا شوم؟
بله. فقط Model ID را عوض کن — claude-* به Anthropic و gemini-* به Google مسیریابی میشود و بقیهٔ نامها به OpenAI. کلید، آدرس و صورتحساب تومانی ثابت میمانند.
- مدلها و قیمت تومانی
فهرست کامل مدلها با نرخ لحظهای هر ۱ میلیون توکن
- محاسبهگر هزینه
برآورد هزینهٔ ماهانه بر پایهٔ مصرف واقعی خودت
- خرید API هوش مصنوعی
شروع کار با کلید بومی و پرداخت تومانی
- مستندات کامل
مرجع API، مسیرهای نیتیو، استریم و کدهای خطا
- وضعیت سرویس
سلامت لحظهای اتصال به هر سرویسدهنده