TEHRAN
1xAi
USE CASE · VS CODE / JETBRAINS · دستیار کدنویسی

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

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

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

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

  1. 01

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

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

  2. 02

    نصب افزونهٔ Continue

    افزونهٔ Continue را از مارکت‌پلیس VS Code یا JetBrains نصب کن و پنل آن را باز کن.

  3. 03

    باز کردن config.yaml

    از آیکون تنظیمات در پنل Continue فایل پیکربندی را باز کن — یا مستقیم فایل ~/.continue/config.yaml را ویرایش کن.

  4. 04

    افزودن بلوک models با apiBase

    برای هر مدل یک بلوک اضافه کن: provider را openai بگذار، model را نام دقیق مدل، apiBase را https://1xai.ir/v1 و apiKey را کلید 1xai-*.

  5. 05

    ذخیره و انتخاب مدل

    فایل را ذخیره کن؛ Continue تغییرات را برمی‌دارد (در صورت نیاز پنجره را Reload کن). حالا مدل را از انتخاب‌گر پایین پنل چت بردار و اولین پیام را بفرست.

CONFIG · پیکربندی

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

~/.continue/config.yamlyaml
# چند مدل از چند سرویس‌دهنده، همه با یک کلید 1xAi
models:
  - name: Claude Sonnet via 1xAi
    provider: openai
    model: claude-sonnet-4-6
    apiBase: https://1xai.ir/v1
    apiKey: 1xai-XXXXXXXXXXXXXXXX
    roles:
      - chat
      - edit

  - name: GPT-4o mini via 1xAi
    provider: openai
    model: gpt-4o-mini
    apiBase: https://1xai.ir/v1
    apiKey: 1xai-XXXXXXXXXXXXXXXX
    roles:
      - chat
MODEL · انتخاب مدل

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

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

برای نقش chat و edit یک مدل قوی مثل claude-sonnet-4-6 بگذار؛ برای نقش‌های سبک‌تر و پرسش‌های سریع، gpt-4o-mini در همان config کنارش تعریف می‌شود و انتخابش یک کلیک است.

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

TROUBLESHOOTING · رفع اشکال

اگر کار نکرد

تغییرات config اعمال نمی‌شود
YAML به تورفتگی حساس است — فاصله‌ها را دقیقاً مثل نمونه نگه دار و از Tab استفاده نکن. بعد از ذخیره، اگر مدل جدید در انتخاب‌گر نیامد، پنجرهٔ ادیتور را یک بار Reload کن.
401 — کلید نامعتبر
کلید اشتباه است، منقضی شده یا باطلش کرده‌ای. کلید را دوباره از داشبورد کپی کن یا یک کلید تازه بساز. فاصله یا خط جدیدِ اضافی هنگام paste رایج‌ترین علت این خطاست.
402 — موجودی کافی نیست
اعتبار تومانی حسابت تمام شده. حداقل شارژ ۱۰۰٬۰۰۰ تومان از طریق زرین‌پال است و بلافاصله پس از پرداختِ موفق، تماس‌های بعدی کار می‌کنند. شارژ حساب ←
خطای نام مدل / مسیریابی
1xAi بر اساس نام مدل مسیریابی می‌کند: claude-* به Anthropic، gemini-* به Google، deepseek-* به DeepSeek و بقیهٔ نام‌ها به OpenAI می‌روند. نام مدل را دقیقاً از صفحهٔ مدل‌ها کپی کن — یک حرف اشتباه یعنی خطای مدلِ ناشناخته. فهرست مدل‌ها و قیمت تومانی ←

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

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

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

config.json دارم، نه config.yaml — چه کنم؟

نسخه‌های جدید Continue از config.yaml استفاده می‌کنند؛ در نسخه‌های قدیمی همان فیلدها (provider، model، apiBase، apiKey) در config.json با ساختار JSON تعریف می‌شوند. مفهوم یکی است: provider را openai و apiBase را آدرس 1xAi بگذار.

چرا provider را openai می‌گذارم ولی مدل Claude است؟

فیلد provider در Continue فقط پروتکل تماس را مشخص می‌کند، نه سازندهٔ مدل را. 1xAi با پروتکل سازگار OpenAI کار می‌کند و بر اساس نام مدل مسیریابی می‌کند — claude-* به Anthropic و gemini-* به Google می‌رود؛ کلید و صورت‌حساب همان است.

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