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

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

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

Zed ارائه‌دهندهٔ سازگار با OpenAI را مستقیم می‌پذیرد. ایجنت Zed، دستیار درون‌خطی، پیام‌های commit و خلاصهٔ گفت‌وگوها از آن استفاده می‌کنند. کلید در keychain سیستم می‌ماند.

مجوز:
GPL-3.0 (بخش‌هایی Apache-2.0)
سیستم‌عامل‌ها:
macOS، Linux، Windows
آدرس (سازگار با OpenAI):
https://ai.fluxcdn.cloud/api/v1
مستندات خود ابزار ↗

پیش از شروع

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

راه‌اندازی

  1. گام 1: یک ترکیب مدل انتخاب کنید و تنظیم‌ها را بنویسید

    Zed → Settings → Open Settings File و این بخش را اضافه کنید. یا از Settings → AI → LLM Providers → Add Provider همین مقدارها را بدهید. max_tokens در Zed یعنی پنجرهٔ متن.

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

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

    Zed: settings.json
    {
      "language_models": {
        "openai_compatible": {
          "fluxcdn": {
            "api_url": "https://ai.fluxcdn.cloud/api/v1",
            "available_models": [
              {
                "name": "anthropic/claude-sonnet-5.5",
                "display_name": "Claude Sonnet 5.5 (FluxCDN)",
                "max_tokens": 1000000,
                "max_output_tokens": 32000,
                "capabilities": { "tools": true, "images": true, "parallel_tool_calls": false, "prompt_cache_key": false }
              }
            ]
          }
        }
      }
    }
  2. گام 2: کلید را بدهید

    کلید را در صفحهٔ ارائه‌دهنده وارد کنید، یا در متغیر FLUXCDN_API_KEY بگذارید. کلید را در settings.json ننویسید.

    ~/.zshrc · ~/.bashrc
    export FLUXCDN_API_KEY="flux_live_YOUR_KEY"

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

  1. گام 1: از ایجنت بخواهید فایلی را بخواند

    پنل Agent را باز کنید، مدل FluxCDN را از فهرست بردارید و بخواهید یک فایل را بخواند. اگر ابزار صدا زده شد، درست کار می‌کند.

رفع مشکل

مدل در فهرست مدل‌های Zed نیست
Zed فقط مدل‌هایی را نشان می‌دهد که در available_models نام برده‌اید. برای هر مدل یک بلوک اضافه کنید و شناسه را دقیقاً از صفحهٔ مدل‌ها کپی کنید.
خطای 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
سرویس سازندهٔ مدل لحظه‌ای در دسترس نبوده. دوباره بفرستید؛ بیشتر ابزارها خودشان این کار را می‌کنند. درخواستی که پیش از پاسخ شکست بخورد هزینه‌ای ندارد. اگر طول کشید، موقتاً مدل دیگری انتخاب کنید.

محدودیت‌ها

  • پیش‌بینی ویرایش (edit predictions، تکمیل Tab) از FluxCDN استفاده نمی‌کند.

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