OpenRouter دسترسی به کاتالوگ گستردهای از مدلها را از طریق یک کلید API واحد فراهم میکند. برای استفاده در اکوان، یک حساب در openrouter.ai بسازید و کلید API دریافت کنید.
راهاندازی
تنظیمکنندهٔ مدل را اجرا کنید:
bash
akvan model- provider OpenRouter را انتخاب کنید.
- کلید API خود را وارد کنید.
- یک مدل از فهرست انتخاب کنید.
یا بهصورت دستی در ~/.akvan/.env تنظیم کنید:
env
AKVAN_PROVIDER=openrouter
OPENROUTER_API_KEY=sk-or-...
AKVAN_MODEL=openai/gpt-4o-miniنامگذاری مدل
مدلهای OpenRouter معمولاً با فرمت provider/model-name مشخص میشوند؛ برای مثال anthropic/claude-sonnet-4 یا openai/gpt-4o-mini. همین مقدار مستقیم به OpenRouter ارسال میشود، پس prefix اضافهای مثل openrouter/ نگذارید. نام دقیق مدل را از فهرست OpenRouter بگیرید.
برای تغییر موقت مدل در یک session:
bash
akvan --model anthropic/claude-sonnet-4عیبیابی
| مشکل | اقدام |
|---|---|
| خطای احراز هویت | کلید OPENROUTER_API_KEY را در ~/.akvan/.env بررسی کنید |
| مدل در دسترس نیست | نام مدل و دسترسی حساب OpenRouter خود را بررسی کنید |
| خطای اعتبار | موجودی حساب OpenRouter را شارژ کنید |
| خطای اتصال | اتصال اینترنت را بررسی کنید؛ AKVAN_LOG_LEVEL=DEBUG akvan را اجرا کنید |
امنیت
OPENROUTER_API_KEYرا commit یا در گفتگو منتشر نکنید.- پیش از اشتراک لاگ، مقدار کلید را از خروجی حذف کنید.