OpenRouter API رایگان

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

OpenRouter برای توسعه‌دهنده‌ای مناسب است که می‌خواهد از یک Endpoint سازگار با OpenAI به مدل‌ها و Providerهای متعدد دسترسی داشته باشد، مدل رایگان مشخص یا Router رایگان را آزمایش کند و امکان fallback یا تغییر مدل با کمترین تغییر کد داشته باشد. محدودیت رایگان و وضعیت ایران باید از داده و Evidence همین صفحه خوانده شود.

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

1. از صفحه رسمی OpenRouter حساب بسازید و در Settings بخش Keys یک API Key ایجاد کنید.
2. کلید را در متغیر محیطی OPENROUTER_API_KEY یا Secret Manager سمت سرور ذخیره کنید؛ کلید نباید وارد JavaScript مرورگر یا مخزن عمومی شود.
3. مدل را از Catalog رسمی انتخاب کنید؛ برای Router رایگان از openrouter/free و برای مدل رایگان مشخص از شناسه دارای پسوند :free استفاده کنید.
4. پیش از استفاده تولیدی، Limit کلید، موجودی حساب و وضعیت Providerهای بالادستی را بررسی کنید.

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

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer ${OPENROUTER_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"model":"openrouter/free","messages":[{"role":"user","content":"یک پاسخ کوتاه فارسی بنویس"}]}'

openrouter/free یک مدل رایگان موجود را به‌صورت خودکار انتخاب می‌کند و انتخاب مدل ثابت را تضمین نمی‌کند. برای کنترل مدل، شناسه رسمی یک variant رایگان را استفاده کنید.

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

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

• 401 — API Key نامعتبر، غیرفعال یا ارسال‌نشده

  هدر Authorization را بررسی کنید، کلید را از محیط صحیح بخوانید و در صورت لغو یا افشا، کلید جدید بسازید. منبع رسمی (2026-07-16)

• 402 — موجودی یا سقف اعتبار کلید کافی نیست

  وضعیت حساب و limit_remaining کلید را بررسی کنید. موجودی منفی یا سقف مصرف تمام‌شده می‌تواند حتی درخواست مدل رایگان را متوقف کند. منبع رسمی (2026-07-16)

• 429 — Rate Limit پلتفرم یا Provider بالادستی

  Retry-After را رعایت کنید، Backoff نمایی به‌کار ببرید و در صورت محدودیت Provider بالادستی، fallback model یا تنظیمات routing را بررسی کنید. منبع رسمی (2026-07-16)

• 503 — Provider واجد شرایط برای درخواست موجود نیست

  محدودیت‌های routing، مدل و قابلیت‌های درخواستی را کاهش دهید یا fallback model اضافه کنید؛ تکرار فوری بدون تغییر تنظیمات معمولاً کافی نیست. منبع رسمی (2026-07-16)

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

• وقتی در Router رایگان به انتخاب قطعی و همیشگی یک مدل مشخص نیاز دارید.
• وقتی بار تولیدی شما به SLA ثابت نیاز دارد اما فقط به ظرفیت متغیر مدل‌های رایگان تکیه می‌کنید.
• وقتی وضعیت دسترسی نمایش‌داده‌شده در همین صفحه با مسیر شبکه یا الزامات پروژه سازگار نیست.

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

• openai-sdk-custom-base-url
• free-tier-vs-trial-vs-credit
• llm-api-rate-limit-429

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