حساب اکوان و provider اکوان

اگر حساب کاربری در اکوان دارید، می‌توانید بدون کلید API جداگانه از provider اکوان استفاده کنید. اعتبار مصرف از پلن و موجودی حساب شما کسر می‌شود و مدل‌های در دسترس بر اساس پلن فعلی‌تان محدود می‌شوند.

ورود با OTP

تنظیم‌کنندهٔ مدل را اجرا کنید:

akvan model

1. provider Akvan را انتخاب کنید.
2. ایمیل یا شمارهٔ موبایل حساب اکوان را وارد کنید.
3. کد ۶ رقمی ارسال‌شده را در ترمینال وارد کنید.
4. پس از ورود، پلن و موجودی اعتبار نمایش داده می‌شود.
5. یک مدل از فهرست مجاز پلن خود انتخاب کنید.

ورود فقط در ترمینال انجام می‌شود؛ نیازی به مرورگر یا توکن session نیست.

پس از ورود

تنظیمات زیر در ~/.akvan/.env ذخیره می‌شوند:

• AKVAN_PROVIDER=akvan
• AKVAN_API_KEY=akv_... (کلید حساب اکوان شما)
• AKVAN_MODEL=... (مدل انتخاب‌شده)

درخواست‌های گفتگو از طریق سرویس اکوان ارسال می‌شوند؛ دسترسی به مدل و کسر اعتبار در سمت سرور اعمال می‌شود.

اعتبار و پلن

هر درخواست مدل از اعتبار حساب شما کسر می‌کند. اگر اعتبار کافی نباشد یا پلن مناسب نداشته باشید، پیام خطا همراه با لینک راهنما نمایش داده می‌شود:

• خرید یا ارتقای پلن: akvan.ai/plans
• شارژ اعتبار: akvan.ai/dashboard/credits

موجودی و پلن را می‌توانید در داشبورد اکوان نیز بررسی کنید.

مدل‌ها

فقط مدل‌هایی که پلن شما اجازه می‌دهد در akvan model نمایش داده می‌شوند. برای تغییر مدل پیش‌فرض دوباره akvan model را اجرا کنید.

برای تغییر موقت مدل در یک session:

akvan --model openai/gpt-4o-mini

مدل باید در پلن شما مجاز باشد؛ در غیر این صورت خطای دسترسی دریافت می‌کنید.

عیب‌یابی

برای جزئیات بیشتر: AKVAN_LOG_LEVEL=DEBUG akvan

امنیت

• AKVAN_API_KEY مانند هر کلید API محرمانه است؛ آن را commit یا در گفتگو منتشر نکنید.
• OTP فقط هنگام تنظیم اولیه یا ورود مجدد لازم است؛ در استفادهٔ روزمره فقط کلید API استفاده می‌شود.
• پیش از اشتراک لاگ، مقدار AKVAN_API_KEY را از خروجی حذف کنید.