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

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

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

OpenCode در ترمینال (و اپ دسکتاپ و افزونهٔ ویرایشگرش) کد را می‌خواند و تغییر می‌دهد. FluxCDN را به شکل یک ارائه‌دهندهٔ سازگار با OpenAI به آن معرفی می‌کنید.

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

پیش از شروع

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

راه‌اندازی

  1. گام 1: کلید را به OpenCode بدهید

    در OpenCode بنویسید /connect، پایین فهرست Other را بزنید، شناسهٔ ارائه‌دهنده را fluxcdn بنویسید و کلید را بچسبانید. کلید در ~/.local/share/opencode/auth.json می‌ماند.

  2. گام 2: یک ترکیب مدل انتخاب کنید و opencode.json را بنویسید

    برای همهٔ پروژه‌ها در ~/.config/opencode/opencode.json، یا فقط برای یک پروژه در ریشهٔ همان پروژه. هر مدلی که می‌خواهید باید زیر models نام برده شود؛ limit را هم بگذارید، چون OpenCode اندازهٔ مدل‌های ارائه‌دهندهٔ سفارشی را نمی‌داند.

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

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

    ~/.config/opencode/opencode.json
    {
      "$schema": "https://opencode.ai/config.json",
      "provider": {
        "fluxcdn": {
          "npm": "@ai-sdk/openai-compatible",
          "name": "FluxCDN AI",
          "options": {
            "baseURL": "https://ai.fluxcdn.cloud/api/v1"
          },
          "models": {
            "anthropic/claude-haiku-5.5": { "name": "Claude Haiku 5.5", "limit": { "context": 1000000, "output": 32000 } },
            "anthropic/claude-sonnet-5.5": { "name": "Claude Sonnet 5.5", "limit": { "context": 1000000, "output": 32000 } }
          }
        }
      },
      "model": "fluxcdn/anthropic/claude-sonnet-5.5",
      "small_model": "fluxcdn/anthropic/claude-haiku-5.5"
    }

    به‌جای /connect می‌شود کلید را از متغیر محیطی خواند: در options این را اضافه کنید: "apiKey": "{env:FLUXCDN_API_KEY}".

  3. گام 3: مدل را انتخاب کنید

    در OpenCode بنویسید /models و یکی از مدل‌های FluxCDN را بردارید.

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

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

    اولی مدل‌های تنظیم‌شده را فهرست می‌کند و دومی یک پیام می‌فرستد. اگر خطا دیدید، --print-logs را هم اضافه کنید.

    Terminal
    opencode models fluxcdn
    opencode run "Say hello in one sentence"

رفع مشکل

خطای 401 با کلید از متغیر محیطی
اگر متغیر تعریف نشده باشد، {env:FLUXCDN_API_KEY} خالی می‌شود و درخواست بدون کلید می‌رود. متغیر را در همان ترمینال تعریف کنید، یا کلید را با /connect بدهید.
مدل در /models نیست
هر مدل باید زیر models در opencode.json نام برده شود. شناسهٔ کامل در OpenCode این شکل است: fluxcdn/deepseek/deepseek-v4-pro.
خطای 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
سرویس سازندهٔ مدل لحظه‌ای در دسترس نبوده. دوباره بفرستید؛ بیشتر ابزارها خودشان این کار را می‌کنند. درخواستی که پیش از پاسخ شکست بخورد هزینه‌ای ندارد. اگر طول کشید، موقتاً مدل دیگری انتخاب کنید.

محدودیت‌ها

  • OpenCode برای کار به فراخوانی ابزار نیاز دارد؛ مدلی با برچسب Tools انتخاب کنید.

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