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

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

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

Aider در ترمینال کنار git کار می‌کند و تغییرها را مستقیم در فایل‌ها می‌نویسد و commit می‌کند. به فراخوانی ابزار نیاز ندارد، پس تقریباً هر مدل گفت‌وگویی از فهرست ما را می‌شود پشتش گذاشت.

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

پیش از شروع

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

راه‌اندازی

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

    ساده‌ترین جا فایل .aider.conf.yml در پوشهٔ خانه است. آن را در پوشهٔ پروژه نگذارید تا کلید همراه کد commit نشود. پیش از شناسهٔ مدل openai/ بیاید: Aider (از راه LiteLLM) اولین بخش را برمی‌دارد و بقیه را به FluxCDN می‌فرستد. weak-model پیام‌های commit و خلاصه‌ها را می‌نویسد.

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

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

    ~/.aider.conf.yml
    openai-api-base: https://ai.fluxcdn.cloud/api/v1
    openai-api-key: flux_live_YOUR_KEY
    model: openai/anthropic/claude-sonnet-5.5
    weak-model: openai/anthropic/claude-haiku-5.5

    زبانهٔ «model metadata» اختیاری است: اندازهٔ واقعی مدل را به Aider می‌گوید تا هشدار «Unknown context window» ندهد. هزینه را صفر گذاشته‌ایم؛ هزینهٔ واقعی را در فعالیت ببینید.

  2. گام 2: Aider را اجرا کنید

    در پوشهٔ پروژه (یک مخزن git) aider را اجرا کنید و فایل‌هایی را که باید عوض شوند به گفت‌وگو اضافه کنید.

    Terminal
    cd your-project
    aider

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

  1. گام 1: یک پیام بفرستید و بیرون بیایید

    Aider یک پیام می‌فرستد، پاسخ را چاپ می‌کند و بسته می‌شود.

    Terminal
    aider --message "Say hello in one sentence"

رفع مشکل

Aider کلید سرویس دیگری (مثل ANTHROPIC_API_KEY) می‌خواهد یا خطای 404 می‌دهد
openai/ پیش از شناسه جا افتاده و Aider مدل را به سرویس سازنده‌اش فرستاده. درست: openai/anthropic/claude-sonnet-5.5؛ openai/ برای Aider است و anthropic/ بخشی از شناسهٔ ما.
هشدار «Unknown context window size and costs»
بی‌خطر است. اگر می‌خواهید نیاید، فایل «model metadata» گام اول را بسازید.
خطای 401 یا invalid_api_key
کلید کامل کپی نشده، باطل شده یا جای دیگری گذاشته شده. کلید با flux_live_ شروع می‌شود و فاصلهٔ اضافه ندارد. اگر ابزار کلید را از متغیر محیطی می‌خواند، پس از تنظیم آن یک ترمینال یا پنجرهٔ تازه باز کنید.
خطای 402، insufficient_credit (در Codex: insufficient_quota) با اینکه اعتبار دارید
پیش از هر درخواست، بیشترین هزینه‌ای که آن درخواست ممکن است داشته باشد از اعتبارتان کنار گذاشته می‌شود. وقتی پاسخ تمام شد فقط هزینهٔ واقعی برداشته می‌شود و بقیه برمی‌گردد. ابزاری که برای هر درخواست خروجی خیلی بلندی می‌خواهد، مبلغ بزرگی کنار می‌گذارد. سقف خروجی ابزار را کمتر کنید (مثلاً 32000 توکن) یا اعتبار اضافه کنید.
خطای 404 که از مدل حرفی نمی‌زند
آدرس پایه درست نیست. بیشتر ابزارها https://ai.fluxcdn.cloud/api/v1 را می‌خواهند و خودشان بقیه را اضافه می‌کنند؛ /chat/completions را دو بار ننویسید و /v1 را جا نیندازید. جدول کدام آدرس را ببینید.
خطای 429: rate_limit_exceeded یا budget_exceeded
یا تعداد درخواست در دقیقه از سقف گذشته (کمی صبر کنید؛ بیشتر ابزارها خودشان دوباره می‌فرستند)، یا هزینهٔ امروز یا این ماهِ همین کلید به سقفش رسیده. سقف را در کلیدهای API با دکمهٔ «سقف‌ها» ببینید.
خطای 502، 503، 504 یا 529
سرویس سازندهٔ مدل لحظه‌ای در دسترس نبوده. دوباره بفرستید؛ بیشتر ابزارها خودشان این کار را می‌کنند. درخواستی که پیش از پاسخ شکست بخورد هزینه‌ای ندارد. اگر طول کشید، موقتاً مدل دیگری انتخاب کنید.

محدودیت‌ها

  • هزینه‌ای که Aider نشان می‌دهد از FluxCDN نیست؛ هزینهٔ واقعی را در فعالیت ببینید.

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