Kilo Gateway API رایگان

هدف استفاده و نیت جست‌وجو

Kilo Gateway برای دسترسی OpenAI-compatible به مدل‌های متعدد و استفاده از مسیر پویا `kilo-auto/free` مناسب است. مدل‌های رایگان می‌توانند برای کاربر ناشناس هم قابل استفاده باشند، اما تخصیص مدل بالادستی پویاست و محدودیت IP یا Provider اعمال می‌شود؛ برای حساب، کنترل مصرف یا مدل‌های پولی باید API Key جداگانه ساخت.

مراحل ثبت‌نام

1. برای تست ناشناس، ابتدا فهرست رسمی مدل‌ها و `kilo-auto/free` را بررسی کنید؛ مدل‌های رایگان و Provider زیرساختی می‌توانند بدون اطلاع قبلی تغییر کنند و داده حساس نباید به مسیر free ارسال شود.
2. برای استفاده احراز‌شده، در app.kilo.ai حساب بسازید و API Key شخصی را از Profile دریافت کنید. مقدار را فقط در KILO_API_KEY نگهداری کنید و آن را در مرورگر، URL، log یا مخزن قرار ندهید.
3. پیش از بار واقعی، GET /models را بررسی کنید و یک درخواست کوتاه بفرستید. برای free route محدودیت ۲۰۰ درخواست در ساعت به‌ازای IP ثبت شده و محدودیت Provider بالادستی نیز می‌تواند زودتر اعمال شود.

نمونه اولین درخواست API

curl -X POST https://api.kilo.ai/api/gateway/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"kilo-auto/free","messages":[{"role":"user","content":"سلام! در یک جمله پاسخ بده."}],"stream":false}'

این نمونه مسیر anonymous free را نشان می‌دهد و Secret ندارد. برای حساب احراز‌شده، هدر Authorization با KILO_API_KEY اضافه شود. مدل واقعی پشت kilo-auto/free پویاست و ممکن است سیاست پردازش داده متفاوتی داشته باشد.

منبع رسمی نمونه درخواست — بررسی‌شده در 2026-07-16

خطاهای رایج و رفع اشکال

• 400 — مدل یا پارامتر درخواست معتبر نیست

  شناسه مدل را از GET /models بگیرید، ساختار messages را حداقلی کنید و context را از پنجره مدل بزرگ‌تر نفرستید. برای Auto Free به مدل ثابت و cache‌شده تکیه نکنید. منبع رسمی (2026-07-16)

• 401/402 — کلید نامعتبر یا اعتبار حساب کافی نیست

  برای مدل احراز‌شده، KILO_API_KEY و هدر Bearer را کنترل کنید. 402 مربوط به موجودی است؛ برای مسیر رایگان از مدل مشخصاً free استفاده کنید و درخواست پولی را به‌اشتباه retry نکنید. منبع رسمی (2026-07-16)

• 429/502/503 — محدودیت IP یا خطای Provider بالادستی

  برای 429 نرخ ارسال را کم و backoff اعمال کنید. برای خطای Provider یا unavailable، پس از تأخیر محدود دوباره تلاش کنید یا مدل رایگان دیگری انتخاب کنید؛ loop سریع retry هم محدودیت را تشدید می‌کند و هم خروجی ناپایدار می‌سازد. منبع رسمی (2026-07-16)

چه زمانی این Provider انتخاب مناسبی نیست؟

• زمانی که prompt یا خروجی حاوی داده شخصی، محرمانه یا مالکیتی است؛ Auto Free می‌تواند درخواست را به Providerهایی با سیاست logging یا بهبود مدل هدایت کند.
• زمانی که پروژه به مدل ثابت، latency قابل پیش‌بینی یا SLA تولیدی نیاز دارد؛ مدل پشت kilo-auto/free و ظرفیت Providerهای رایگان پویاست.
• زمانی که وابستگی به Gateway چندارائه‌دهنده‌ای یا تفاوت خطاهای Provider بالادستی برای معماری پروژه پذیرفتنی نیست.

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

• openai-sdk-custom-base-url
• free-tier-vs-trial-vs-credit
• free-coding-api

آخرین بازبینی محتوای این صفحه: 2026-07-16