خانه / راهنماها / استفاده از Aider با یک API رایگان LLM

استفاده از Aider با یک API رایگان LLM

Aider یک برنامه‌نویس جفتی متن‌باز برای ترمینال است. فایل‌های مخزن git شما را ویرایش می‌کند و کامیت می‌سازد. این راهنما Aider را از طریق FreeLLMAPI به مدل‌های رایگان وصل می‌کند. همچنین تنظیماتی از Aider را نشان می‌دهد که برای مدل‌های رایگان مهم هستند: قالب ویرایش، مدل ضعیف و اندازه نقشه مخزن.

کد، نام مدل‌ها و برچسب‌های زندهٔ کاتالوگ به زبان انگلیسی نمایش داده می‌شوند.

مرحله 1: نصب FreeLLMAPI

FreeLLMAPI یک دروازه متن‌باز است. در Docker روی رایانه شما اجرا می‌شود. سطوح رایگان 45 ارائه‌دهنده را پشت یک کلید سازگار با OpenAI گردآوری می‌کند.

نصب روی macOS یا Linux

curl -fsSL https://freellmapi.co/install.sh | bash

http://localhost:3001 را باز کنید. حداقل دو کلید رایگان ارائه‌دهنده را در صفحه Keys اضافه کنید. کلید یکپارچه خود را از همان صفحه کپی کنید.

مرحله 2: اتصال Aider

دستور راه‌اندازی ~/.aider.conf.yml را می‌نویسد. ابتدا از فایل موجود نسخه پشتیبان می‌گیرد.

یک دستور

npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key>
aider

فایلی که این دستور می‌نویسد به این شکل است:

~/.aider.conf.yml

openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"

پیشوند openai/ لازم است. به Aider می‌گوید نام مدل را به یک API سازگار با OpenAI بفرستد. برای استفاده از متغیرهای محیطی و بدون فایل، این کار را انجام دهید:

فقط متغیرهای محیطی

export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/auto

Aider به دنبال .aider.conf.yml در پوشه خانگی شما می‌گردد، سپس در ریشه مخزن git و بعد در پوشه جاری. فایلی که آخر بارگذاری می‌شود اولویت دارد. بنابراین یک فایل پروژه می‌تواند مدل را برای یک مخزن تغییر دهد.

مرحله 3: انتخاب مدل‌ها

Aider در هر درخواست فایل‌های شما و یک نقشه مخزن می‌فرستد. برای حلقه اصلی ویرایش به فراخوانی ابزار نیاز ندارد، چون ویرایش‌ها را از متن مدل می‌خواند. پنجره زمینه بزرگ و پیروی خوب از دستورالعمل مهم‌تر هستند. جدول مدل‌های رایگان با حداقل 128K زمینه را امروز نشان می‌دهد.

مدل‌های رایگان برای Aider: زمینه 128K+، بر اساس هوش
مدلرایگان درمتن ورودیمحدودیت‌های رایگان (بهترین پیشنهاد)ابزارهابینایی
GLM 5.3APINex, UnoRouter1M5 درخواست در دقیقه
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
بلهخیر
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM +1 مورد دیگر1M40 درخواست در دقیقه
40 RPM
بلهبله
Gemini 3.8 FlashAPINex, Google AI Studio1M5 درخواست در دقیقه
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
بلهبله
Qwen3.8 Flash NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowanceبلهخیر
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditبلهبله
Deepseek V4.1 FlashAPINex1M5 درخواست در دقیقه
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
خیرخیر
Gemini 3.7 FlashGoogle AI Studio1M10 درخواست در دقیقه
20 درخواست در روز
250,000 توکن در دقیقه
~3M
بلهبله
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditبلهبله
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 درخواست در دقیقه
50 درخواست در روز
50 req/day account-wide (1,000 after a $10 purchase)
بلهبله
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 درخواست در دقیقه
50 درخواست در روز
Shared rate limit
بلهخیر
DeepSeek V4 Flash 0731ElectronHub, Router91M10,000 credits/month (~$1), shared; account-anniversary resetخیرخیر
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo +3 مورد دیگر262K30 درخواست در دقیقه
250 درخواست در روز
70,000 توکن در دقیقه
~6M
بلهبله

نمایش 12 مدل رایگان مطابق از 184 مدل. مشاهده همه مدل‌ها.

داده‌های زنده از کاتالوگ FreeLLMAPI (نسخه 2026.11.19، بررسی‌شده در 2026-11-19). محدودیت‌های رایگان اغلب تغییر می‌کنند. کاتالوگ هر روز بررسی می‌شود.

از openai/auto استفاده کنید تا مسیریاب مدل را انتخاب کند. از openai/auto:smart استفاده کنید تا مدل‌هایی با بالاترین هوش ترجیح داده شوند. برای ثابت کردن یک مدل، از openai/ و یک شناسه کاتالوگ از GET /v1/models استفاده کنید.

می‌توانید مدل‌های یک جلسه را هم در خط فرمان تنظیم کنید. این مثال از قوی‌ترین مدل‌ها برای ویرایش استفاده می‌کند. از مدل‌های سریع برای پیام‌های کامیت و خلاصه تاریخچه گفتگو استفاده می‌کند:

مدل‌ها برای یک جلسه

aider --model openai/auto:smart --weak-model openai/auto:fast

برای یک پروفایل از پیش برنامه‌ریزی‌شده، در داشبورد FreeLLMAPI یک زنجیره پشتیبان بسازید، برای مثال زنجیره‌ای به نام coding. سپس از --model openai/auto:coding استفاده کنید. نام پروفایل ناشناخته خطای 400 برمی‌گرداند، پس درخواست بدون اطلاع به زنجیره دیگری نمی‌رود.

تنظیمات Aider برای مدل‌های رایگان

Aider تنظیمات مدل‌های شناخته‌شده را می‌داند. نام مدل دروازه مانند auto شناخته‌شده نیست، پس این مقادیر را خودتان تنظیم کنید.

تنظیمکاری که انجام می‌دهدمقدار پیشنهادی برای مدل‌های رایگان
edit-formatقالبی که مدل برای فرستادن ویرایش‌ها استفاده می‌کند: whole، diff، diff-fenced یا udiffdiff برای مدل‌های قوی. whole برای مدل‌های ضعیف، چون ساده‌تر است اما توکن بیشتری می‌فرستد.
weak-modelمدل برای پیام‌های کامیت و خلاصه تاریخچه گفتگوopenai/auto:fast، تا کارهای کوچک سهمیه مدل قوی شما را مصرف نکنند
map-tokensتعداد توکن برای نقشه مخزن. 0 آن را خاموش می‌کند.1024 یا کمتر روی سطوح رایگان کوچک
architectیک مدل تغییر را برنامه‌ریزی می‌کند و یک مدل ویرایشگر ویرایش‌ها را می‌نویسداختیاری. تعداد درخواست‌ها را دو برابر می‌کند.

~/.aider.conf.yml با تنظیمات مدل‌های رایگان

openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"
weak-model: "openai/auto:fast"
edit-format: diff
map-tokens: 1024

برای دادن پنجره زمینه یک مدل دروازه به Aider، یک فایل .aider.model.metadata.json اضافه کنید. کلید، نام کامل مدل است. Aider این فایل را در همان جاهایی جستجو می‌کند که فایل پیکربندی را جستجو می‌کند.

~/.aider.model.metadata.json

{
  "openai/auto": {
    "max_input_tokens": 128000,
    "max_output_tokens": 8192,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

محدودیت‌های نرخ و جایگزینی

سطوح رایگان محدودیت در دقیقه و در روز دارند. FreeLLMAPI استفاده از هر کلید را می‌شمارد. وقتی یک ارائه‌دهنده خطای 429 بفرستد، مسیریاب درخواست را به مدل بعدی در زنجیره شما می‌فرستد. Aider خطا را نمی‌بیند و ادامه می‌دهد.

  • کلیدهای چهار ارائه‌دهنده یا بیشتر اضافه کنید. ارائه‌دهندگان بیشتر، درخواست‌های بیشتری در روز می‌دهند.
  • فقط فایل‌هایی را که می‌خواهید تغییر دهید با /add اضافه کنید. هر فایل در هر درخواست است.
  • بین کارها از /clear استفاده کنید تا تاریخچه گفتگوی کوتاه‌تری بفرستید. تاریخچه کوتاه توکن در دقیقه را هم کم می‌کند.
  • برای حذف فایل‌هایی که دیگر لازم ندارید، از /drop استفاده کنید.

عیب‌یابی

مشکلعلتراه‌حل
«Model openai/auto: Unknown context window size and costs, using sane defaults.»Aider مدل دروازه را نمی‌شناسداین هشدار معمولاً بی‌ضرر است. برای حذف آن، .aider.model.metadata.json را اضافه کنید.
ویرایش اعمال نشدمدل از قالب ویرایش پیروی نکرداز --edit-format whole استفاده کنید، یا یک مدل قوی‌تر
401 «Invalid API key»Aider کلید دیگری می‌فرستد، برای مثال از فایل پیکربندی دیگریفایل‌های پیکربندی در پوشه خانگی، ریشه git و پوشه جاری را بررسی کنید
Aider به api.openai.com وصل می‌شودپیشوند openai/ استفاده شده، اما نشانی پایه تنظیم نشده استopenai-api-base یا OPENAI_API_BASE را تنظیم کنید
«All models rate-limited after N attempts»همه کلیدها به حد خود رسیده‌اندکلیدهای ارائه‌دهندگان بیشتری اضافه کنید، یا map-tokens را کم کنید
هر یک از این‌ها را با یک کلید استفاده کنید. FreeLLMAPI یک روتر متن‌باز و میزبانی‌شده روی سرور خودتان است. این روتر همه این سطوح رایگان را پشت یک نقطه پایانی سازگار با OpenAI قرار می‌دهد و وقتی یک سرویس به محدودیت نرخ برسد، به سرویس بعدی منتقل می‌شود. مرور کاتالوگ یا اجرای زنده.

پرسش‌های متداول

آیا می‌توانم Aider را رایگان استفاده کنم؟

بله. Aider متن‌باز است. آن را با openai-api-base و پیشوند مدل openai/ به FreeLLMAPI وصل کنید. این دروازه از سطوح رایگان ارائه‌دهنده استفاده می‌کند، پس هزینه استنتاج صفر دلار است.

چگونه Aider را با یک API سازگار با OpenAI استفاده کنم؟

OPENAI_API_BASE و OPENAI_API_KEY را تنظیم کنید، سپس aider --model openai/ را اجرا کنید. پیشوند openai/ لازم است. می‌توانید همین مقادیر را در .aider.conf.yml هم بنویسید.

با مدل‌های رایگان از کدام قالب ویرایش استفاده کنم؟

برای مدل‌های قوی از diff استفاده کنید، چون توکن کمتری می‌فرستد. اگر ویرایش‌ها اعمال نشدند، از whole استفاده کنید. این قالب برای مدل‌های ضعیف ساده‌تر است، اما هر بار کل فایل را می‌فرستد.

معنی «Unknown context window size and costs, using sane defaults» چیست؟

Aider نام مدل را نمی‌شناسد، پس از مقادیر پیش‌فرض استفاده می‌کند. این هشدار معمولاً بی‌ضرر است. برای حذف آن، فایل .aider.model.metadata.json را با پنجره زمینه اضافه کنید.

کدام مدل رایگان برای Aider بهترین است؟

از مدلی با پنجره زمینه بزرگ و پیروی خوب از دستورالعمل استفاده کنید. جدول این صفحه قوی‌ترین مدل‌های رایگان با زمینه 128K یا بیشتر را امروز نشان می‌دهد.

راهنماهای مرتبط

منابع

همه راهنماها · مرور همه مدل‌های رایگان