پرش به محتوا
FluxCDNFluxCDN
esc
ورود
در این صفحه

مستنداتراهنمای ابزارها

IDEهای JetBrains با هوش مصنوعی FluxCDN

AI Assistant در IDEهای JetBrains ارائه‌دهندهٔ «OpenAI-compatible» می‌پذیرد و برای آن اشتراک JetBrains AI لازم نیست. کلید روی کامپیوتر شما می‌ماند. Claude Code، Cline و Continue هم افزونهٔ JetBrains دارند.

مجوز:
اختصاصی؛ افزونهٔ AI Assistant رایگان است
سیستم‌عامل‌ها:
macOS، Linux، Windows
آدرس (سازگار با OpenAI):
https://ai.fluxcdn.cloud/api/v1
آدرس (آدرس کامل درخواست):
https://ai.fluxcdn.cloud/api/v1/chat/completions

پیش از شروع

  • یک کلید API بسازید. در صفحهٔ کلیدهای API دکمهٔ «ساخت کلید» را بزنید و کلید را همان لحظه کپی کنید؛ با flux_live_ شروع می‌شود و دوباره کامل نشان داده نمی‌شود.
  • برای ایجنت‌ها کلید جدا بسازید و با دکمهٔ «سقف‌ها» برایش سقف هزینهٔ روزانه یا ماهانه بگذارید. ایجنت‌ها خودشان پشت هم درخواست می‌فرستند؛ سقف جلوی هزینهٔ پیش‌بینی‌نشده را می‌گیرد.
  • کمی اعتبار در حساب داشته باشید (صورت‌حساب).
  • در نمونه‌ها به‌جای flux_live_YOUR_KEY کلید خودتان را بگذارید.

AI Assistant

  1. گام 1: ارائه‌دهنده را اضافه کنید

    Settings → Tools → AI Assistant → Providers & API keys، بخش Third-party AI providers: OpenAI-compatible را بردارید، آدرس و کلید را بدهید، Tool calling را روشن کنید (برای ایجنت‌ها لازم است) و Test Connection و بعد Apply را بزنید.

  2. گام 2: مدل‌ها را به قابلیت‌ها بدهید

    مدل‌های سفارشی خودکار به قابلیت‌ها داده نمی‌شوند. در همان صفحه، Models Assignment: مدل اصلی را به Core features و یک مدل سریع را به Instant helpers بدهید.

    یک ترکیب انتخاب کنید؛ تنظیم‌های زیر با آن عوض می‌شوند. هر شناسه‌ای از صفحهٔ مدل‌ها را هم می‌شود جایشان گذاشت.

    قیمت هر میلیون توکن. قیمت‌های طرح رایگان، به تومان با نرخ امروز. مسیریاب‌ها (router/auto و مانند آن) برای ایجنت‌ها پیشنهاد نمی‌شوند: ایجنت به مدلی نیاز دارد که حتماً ابزار را پشتیبانی کند.

    Providers & API keys · Models Assignment
    URL:              https://ai.fluxcdn.cloud/api/v1
    API Key:          flux_live_YOUR_KEY
    Core features:    anthropic/claude-sonnet-5.5
    Instant helpers:  anthropic/claude-haiku-5.5

Junie CLI

  1. گام 1: یک پروفایل مدل بسازید

    Junie چیزی به آدرس اضافه نمی‌کند، پس آدرس کامل درخواست را بدهید. کلید را در FLUXCDN_API_KEY بگذارید؛ اگر این متغیر تعریف نشده باشد، پروفایل بار نمی‌شود. بعد junie --model custom:fluxcdn را اجرا کنید، یا مدل را در زبانهٔ Custom منوی /model بردارید.

    ~/.junie/models/fluxcdn.json
    {
      "baseUrl": "https://ai.fluxcdn.cloud/api/v1/chat/completions",
      "id": "anthropic/claude-sonnet-5.5",
      "apiType": "OpenAICompletion",
      "apiKey": "${FLUXCDN_API_KEY}",
      "displayName": "FluxCDN Claude Sonnet 5.5",
      "fasterModel": { "id": "anthropic/claude-haiku-5.5" }
    }

بررسی کنید که کار می‌کند

  1. گام 1: اتصال را امتحان کنید

    Test Connection در تنظیمات، بعد پنجرهٔ AI Chat: مدل‌های ارائه‌دهنده در بخش جدایی از فهرست مدل‌ها آمده‌اند. یک سؤال بپرسید.

رفع مشکل

قابلیت‌ها هنوز مدل‌های JetBrains را به کار می‌برند
مدل‌ها را در Models Assignment به قابلیت‌ها بدهید (گام 2).
خطای 401 یا invalid_api_key
کلید کامل کپی نشده، باطل شده یا جای دیگری گذاشته شده. کلید با flux_live_ شروع می‌شود و فاصلهٔ اضافه ندارد. اگر ابزار کلید را از متغیر محیطی می‌خواند، پس از تنظیم آن یک ترمینال یا پنجرهٔ تازه باز کنید.
خطای 402، insufficient_credit (در Codex: insufficient_quota) با اینکه اعتبار دارید
پیش از هر درخواست، بیشترین هزینه‌ای که آن درخواست ممکن است داشته باشد از اعتبارتان کنار گذاشته می‌شود. وقتی پاسخ تمام شد فقط هزینهٔ واقعی برداشته می‌شود و بقیه برمی‌گردد. ابزاری که برای هر درخواست خروجی خیلی بلندی می‌خواهد، مبلغ بزرگی کنار می‌گذارد. سقف خروجی ابزار را کمتر کنید (مثلاً 32000 توکن) یا اعتبار اضافه کنید.
خطای 404 یا model_not_found
شناسهٔ مدل باید دقیقاً همان باشد که در صفحهٔ مدل‌ها آمده، با پیشوند سازنده: anthropic/claude-sonnet-5.5، نه claude-sonnet-5.5. حروف کوچک و نقطه‌ها مهم‌اند. شناسه را کپی کنید، تایپ نکنید.
خطای 404 که از مدل حرفی نمی‌زند
آدرس پایه درست نیست. بیشتر ابزارها https://ai.fluxcdn.cloud/api/v1 را می‌خواهند و خودشان بقیه را اضافه می‌کنند؛ /chat/completions را دو بار ننویسید و /v1 را جا نیندازید. جدول کدام آدرس را ببینید.
ایجنت ابزاری صدا نمی‌زند یا مدل در فهرست ایجنت نیست
مدلی انتخاب کنید که ابزار (tools) را پشتیبانی کند؛ در صفحهٔ مدل‌ها برچسب Tools دارد. در بعضی ابزارها باید این قابلیت را برای مدل روشن کنید (گام‌های بالا). مسیریاب‌ها برای ایجنت‌ها پیشنهاد نمی‌شوند.
خطای 429: rate_limit_exceeded یا budget_exceeded
یا تعداد درخواست در دقیقه از سقف گذشته (کمی صبر کنید؛ بیشتر ابزارها خودشان دوباره می‌فرستند)، یا هزینهٔ امروز یا این ماهِ همین کلید به سقفش رسیده. سقف را در کلیدهای API با دکمهٔ «سقف‌ها» ببینید.
خطای 502، 503، 504 یا 529
سرویس سازندهٔ مدل لحظه‌ای در دسترس نبوده. دوباره بفرستید؛ بیشتر ابزارها خودشان این کار را می‌کنند. درخواستی که پیش از پاسخ شکست بخورد هزینه‌ای ندارد. اگر طول کشید، موقتاً مدل دیگری انتخاب کنید.

محدودیت‌ها

  • تکمیل کد حین تایپ و next edit از این مدل‌ها استفاده نمی‌کنند. JetBrains می‌گوید همهٔ قابلیت‌ها با مدل‌های ارائه‌دهندهٔ دیگر تضمین نمی‌شوند.
  • AI Assistant فقط آدرس سازگار با OpenAI را می‌پذیرد، نه آدرس Anthropic.

آنچه از این راه کار نمی‌کند →