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

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

Cursor با هوش مصنوعی FluxCDN

Cursor اجازه می‌دهد آدرس OpenAI را عوض کنید و مدل دلخواه اضافه کنید. این برای چت در حالت Ask و Plan کار می‌کند. حالت Agent با آدرس سفارشی قابل اعتماد نیست و تکمیل Tab همیشه با مدل‌های خود Cursor است. برای ایجنت، Cline یا Kilo Code را داخل Cursor نصب کنید (راهنمای VS Code)، یا Claude Code و Codex را در ترمینال Cursor اجرا کنید.

مجوز:
اختصاصی؛ طبق راهنماهای موجود، مدل سفارشی فقط در اشتراک پولی Cursor فعال است
سیستم‌عامل‌ها:
macOS، Linux، Windows
آدرس (سازگار با OpenAI):
https://ai.fluxcdn.cloud/api/v1

پیش از شروع

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

راه‌اندازی

  1. گام 1: متغیرهای قدیمی را پاک کنید

    اگر OPENAI_API_KEY یا OPENAI_BASE_URL را در سیستم تعریف کرده‌اید، پاکشان کنید؛ ممکن است با تنظیم Cursor تداخل کنند.

  2. گام 2: کلید و آدرس را بدهید

    Cursor Settings → Models و بعد بخش API Keys. کلید را در OpenAI API Key بگذارید و روشنش کنید. Override OpenAI Base URL را روشن کنید و به‌جای آدرس پیش‌فرض https://ai.fluxcdn.cloud/api/v1 را بنویسید، بدون /chat/completions.

  3. گام 3: مدل را اضافه کنید

    + Add Custom Model را بزنید، شناسه را دقیقاً بنویسید و روشنش کنید.

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

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

    + Add Custom Model
    anthropic/claude-sonnet-5.5
  4. گام 4: در حالت Ask چت کنید

    در پنل چت حالت Ask را بردارید و مدل را انتخاب کنید.

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

  1. گام 1: یک سؤال بپرسید

    در حالت Ask دربارهٔ یک فایل بپرسید. درخواست را در فعالیت کنسول می‌بینید.

رفع مشکل

حالت Agent خطا می‌دهد (مثلاً «model is required» یا خطای tools)
حالت Agent در Cursor با آدرس سفارشی درخواست‌هایی می‌فرستد که با این مسیر جور نیستند. از Ask یا Plan استفاده کنید، یا Cline، Kilo Code، Claude Code یا Codex را داخل Cursor به کار ببرید.
پاسخ‌ها خالی می‌آیند
Settings → Network → HTTP Compatibility Mode را روی HTTP/1.1 بگذارید.
پیام «does not work with your current plan or api key»
مدل سفارشی در اشتراک رایگان Cursor فعال نیست، یا کلید درست کپی نشده.
مدل‌های GPT خود Cursor کار نمی‌کنند
تغییر آدرس OpenAI در Cursor برای همهٔ مدل‌های OpenAI است. برای استفاده از مدل‌های خود Cursor آن را خاموش کنید.
خطای 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. حروف کوچک و نقطه‌ها مهم‌اند. شناسه را کپی کنید، تایپ نکنید.
خطای 429: rate_limit_exceeded یا budget_exceeded
یا تعداد درخواست در دقیقه از سقف گذشته (کمی صبر کنید؛ بیشتر ابزارها خودشان دوباره می‌فرستند)، یا هزینهٔ امروز یا این ماهِ همین کلید به سقفش رسیده. سقف را در کلیدهای API با دکمهٔ «سقف‌ها» ببینید.

محدودیت‌ها

  • درخواست‌ها از سرورهای Cursor فرستاده می‌شوند، نه از کامپیوتر شما؛ یعنی Cursor کلید و متن درخواست‌ها را می‌بیند. سیاست نگه‌نداشتن داده (Zero Data Retention) Cursor برای درخواست‌های با کلید شخصی اعمال نمی‌شود.
  • تکمیل Tab هرگز از کلید شما استفاده نمی‌کند و حالت Agent قابل اعتماد نیست.

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