راهنمای OpenRouter API key

گرفتن کلید API از OpenRouter و استفاده از مدل‌های رایگان

از OpenRouter کلید API بگیرید، سقف مدل‌های رایگان را ببینید، خطاهای 401، 402 و 429 را رفع کنید و OpenRouter را در iPhone، Android یا وب به کار ببرید.

به‌روزرسانی
  • برای گرفتن کلید API از OpenRouter، در openrouter.ai وارد شوید، openrouter.ai/keys را باز کنید و یک کلید بسازید؛ این کلید با «sk-or-v1-» شروع می‌شود. ساختن کلید رایگان است، مدل‌هایی که شناسه‌شان به «:free» ختم می‌شود در سقف روزانه رایگان‌اند و هزینه‌ی بقیه‌ی مدل‌ها از اعتبار پیش‌پرداخت کم می‌شود.
  • OpenRouter یک حساب و یک کلید برای مدل‌های شرکت‌های مختلف هوش مصنوعی است. خودش برنامه‌ی چتی برای iPhone یا Android منتشر نکرده است؛ پس روی گوشی باید از یک برنامه‌ی چت استفاده کنید که کلید OpenRouter را بپذیرد، مثل Oriveo.
  • تا 18 نوامبر 2026، سقف مدل‌های رایگان 20 درخواست در دقیقه و 50 درخواست در روز است؛ اگر در مجموع دست‌کم 10 واحد اعتبار (credits) خریده باشید، سقف روزانه 1,000 درخواست می‌شود. خطای 402 یعنی اعتبارتان تمام شده است.
Oriveo روی iPhone: صفحه ارائه‌دهندگان که ارائه‌دهندگان متصل‌شده و هزینه این ماه را فهرست می‌کند.

OpenRouter چیست و کلید API یعنی چه؟

OpenRouter سرویسی است که مدل‌های شرکت‌های مختلف هوش مصنوعی را از طریق یک حساب در اختیارتان می‌گذارد. به‌جای ثبت‌نام جداگانه نزد هر شرکت، یک بار در OpenRouter اعتبار می‌خرید و از فهرست آن مدل انتخاب می‌کنید.

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

OpenRouter برای برنامه‌ها و توسعه‌دهندگان ساخته شده است. برنامه‌ی چت خودش را برای iPhone یا Android منتشر نکرده است و برای همین مردم دنبال «برنامه‌ی OpenRouter» می‌گردند. چیزی که واقعاً لازم دارند، یک برنامه‌ی چت است که کلید OpenRouter را بپذیرد.

چطور از OpenRouter کلید API بگیرم؟

در سایت OpenRouter چند دقیقه بیشتر طول نمی‌کشد.

  • به openrouter.ai بروید و حساب بسازید یا وارد شوید.
  • صفحه‌ی کلیدها را در openrouter.ai/keys باز کنید و یک کلید تازه بسازید. اسمش را مطابق برنامه یا دستگاهی بگذارید که قرار است با آن کار کنید.
  • کلید را کپی کنید. کلیدهای OpenRouter با «sk-or-v1-» شروع می‌شوند و 73 نویسه دارند؛ پس مطمئن شوید همه‌اش را کپی کرده‌اید.
  • اگر مدل‌های غیررایگان می‌خواهید، در صفحه‌ی Credits اعتبار اضافه کنید.
  • کلید را جای امنی نگه دارید، مثلاً در یک برنامه‌ی مدیریت رمز عبور. اگر لو رفت، آن را در صفحه‌ی کلیدها حذف کنید و کلید تازه بسازید.

آیا OpenRouter API رایگان است؟

تا حدی. ساختن حساب و کلید هزینه‌ای ندارد و OpenRouter مدل‌های رایگانی دارد که شناسه‌شان به «:free» ختم می‌شود. بقیه‌ی مدل‌ها با اعتبار پیش‌پرداخت کار می‌کنند. OpenRouter همچنین می‌گوید کاربران تازه مقدار کمی اعتبار رایگان می‌گیرند، اما نمی‌گوید چقدر.

مدل‌های رایگان سقف مصرف دارند. سقف‌های اعلام‌شده‌ی OpenRouter تا 18 نوامبر 2026 این‌هاست:

  • به گفته‌ی OpenRouter، اگر موجودی شما زیر صفر برود، حتی مدل‌های رایگان هم ممکن است خطا بدهند.
  • سایت OpenRouter نشان می‌دهد کدام مدل‌ها در حال حاضر نسخه‌ی «:free» دارند؛ پیش از اینکه به یکی تکیه کنید، آنجا را بررسی کنید.
آیا OpenRouter API رایگان است؟
حساب شمادرخواست به مدل‌های رایگان در دقیقهدرخواست به مدل‌های رایگان در روز
در مجموع کمتر از 10 واحد اعتبار خریده‌اید2050
در مجموع دست‌کم 10 واحد اعتبار خریده‌اید201,000

اعتبار (credits) در OpenRouter چطور کار می‌کند؟

OpenRouter پیش‌پرداختی است. در صفحه‌ی Credits با کارت یا یکی از روش‌های پرداخت دیگری که آنجا آمده اعتبار می‌خرید و هزینه‌ی هر درخواست از آن کم می‌شود. تا 18 نوامبر 2026، طبق شرایط استفاده‌ی OpenRouter حداقل مبلغ هر خرید 5 دلار است، روی هر خرید کارمزد پرداخت هم گرفته می‌شود و اعتبار مصرف‌نشده ممکن است 365 روز پس از خرید منقضی شود. جزئیات فعلی را در openrouter.ai/terms ببینید.

هر مدل قیمت خودش را به‌ازای توکن دارد که در صفحه‌ی همان مدل در OpenRouter آمده است. قیمت‌ها را اینجا نقل نمی‌کنیم، چون تغییر می‌کنند. Oriveo برای هر پاسخ هزینه‌ی تخمینی نشان می‌دهد؛ صفحه‌های فعالیت (Activity) و صورت‌حساب (Billing) در OpenRouter سند نهایی‌اند.

چطور OpenRouter را در iPhone، Android یا وب به کار ببرم؟

چون OpenRouter برنامه‌ی موبایل رسمی ندارد، باید یک برنامه‌ی کلاینت انتخاب کنید. در Oriveo، OpenRouter یکی از 15 ارائه‌دهنده‌ی داخلی است و زیر «تجمیع‌کننده‌ها» آمده؛ پس نشانی‌ای تایپ نمی‌کنید.

  • «ارائه‌دهندگان» را باز کنید: در iPhone و Android یکی از زبانه‌هاست و در وب در نوار کناری است.
  • دکمه‌ی + («افزودن ارائه‌دهنده») را بزنید و OpenRouter را انتخاب کنید. دکمه‌ی «تجمیع‌کننده‌ها» فهرست را کوتاه‌تر می‌کند.
  • کلید را زیر «اتصال به OpenRouter» جای‌گذاری کنید و «ادامه» را بزنید.
  • صبر کنید تا مرحله‌ی «در حال اعتبارسنجی اتصال و همگام‌سازی مدل‌ها...» (در Android: «در حال بررسی اتصال و همگام‌سازی مدل‌ها…») تمام شود. Oriveo فهرست مدل‌های OpenRouter را بارگیری می‌کند.
  • یک مدل انتخاب کنید و گفت‌وگو را شروع کنید. اگر اعتبار ندارید، مدلی را بردارید که شناسه‌اش به «:free» ختم می‌شود.
صفحه‌ی اصلی Oriveo با کادر پیام، مدل انتخاب‌شده در زیر آن و گفت‌وگوهای امروز همراه با هزینه‌ی هرکدام
پس از وصل کردن کلید، مدل را زیر کادر پیام انتخاب کنید. کنار هر گفت‌وگو در فهرست، هزینه‌ی تخمینی آن دیده می‌شود.

کلید OpenRouter من کجا می‌رود؟

در iPhone و Android، درخواست‌ها مستقیم از دستگاه شما به ارائه‌دهنده می‌روند و کلید در فضای امن گوشی نگه داشته می‌شود (Keychain در iPhone و Keystore در Android). در برنامه‌ی وب، درخواست‌ها از یک نقطه‌ی واسط بی‌درنگ روی سرور Oriveo می‌گذرند: کلید شما فقط برای همان درخواست به کار می‌رود و به‌عنوان رکورد حساب ذخیره نمی‌شود، و گفت‌وگوهای BYOK (با کلید خودتان) به‌صورت سابقه‌ی گفت‌وگو نگه داشته نمی‌شوند. کلیدها با همگام‌سازی ابری بارگذاری نمی‌شوند. برای استفاده از OpenRouter روی دستگاه دوم، کلید را آنجا هم جای‌گذاری کنید یا برای آن دستگاه کلید جداگانه بسازید.

هزینه را مستقیم و به قیمت‌های خود OpenRouter به آن می‌پردازید. Oriveo هیچ مبلغی روی آن اضافه نمی‌کند.

چرا کلید OpenRouter من کار نمی‌کند؟

صفحه‌ی خطاهای OpenRouter (openrouter.ai/docs/api-reference/errors) معنای هر کد را آورده است. رایج‌ترین‌ها تا 18 نوامبر 2026:

  • در Oriveo، خطای 402 با عنوان «سهمیه ارائه‌دهنده تمام شد» نمایش داده می‌شود و خطای 429 در وب با «محدودیت نرخ درخواست» و در iPhone و Android با «ارائه‌دهنده محدودیت نرخ اعمال کرده است».
  • مدلی در فهرستتان نیست: فهرست مدل‌ها را دوباره همگام‌سازی کنید و بررسی کنید که OpenRouter هنوز آن را ارائه می‌دهد.
چرا کلید OpenRouter من کار نمی‌کند؟
خطامعنیچه کنید
401 Invalid credentialsکلید اشتباه، غیرفعال یا حذف‌شده استهمه‌ی کلید را دوباره کپی کنید یا کلید تازه بسازید
401 «this is not an OpenRouter API key»کلید یک ارائه‌دهنده‌ی دیگر را جای‌گذاری کرده‌ایدکلیدی از openrouter.ai/keys به کار ببرید؛ با sk-or-v1- شروع می‌شود
402 insufficient creditsاعتبار حساب شما یا این کلید تمام شده استاعتبار اضافه کنید یا سقف کلید را بالا ببرید؛ صبر کردن فایده ندارد
403 Forbiddenبه‌دلیل مجوزها، نظارت بر محتوا (moderation)، یک محافظ (guardrail) یا سقف بودجه مسدود شده استتنظیمات و سقف‌های کلید را بررسی کنید یا پیامتان را تغییر دهید
429 rate limitedدرخواست‌ها برای OpenRouter یا برای ارائه‌دهنده‌ی آن مدل بیش از حد استصبر کنید و دوباره امتحان کنید؛ با مدل‌های رایگان، سقف‌های بالا را بررسی کنید
502 یا 503مدل یا ارائه‌دهندگانش در حال حاضر در دسترس نیستندبعداً دوباره امتحان کنید یا مدل دیگری انتخاب کنید

OpenRouter یا کلید جداگانه از هر ارائه‌دهنده؟

وقتی مدل‌های زیادی را با یک کلید و یک موجودی می‌خواهید، OpenRouter کار را راحت می‌کند. کلیدی که مستقیم از ارائه‌دهنده‌ای مثل OpenAI یا Anthropic می‌گیرید، وقتی مناسب است که حساب و صورت‌حساب خود آن ارائه‌دهنده را بخواهید. Oriveo هر دو را می‌پذیرد؛ پس می‌توانید OpenRouter را کنار کلیدهای مستقیم نگه دارید و در همان گفت‌وگو مدل‌ها را یکی پس از دیگری عوض کنید.

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

آیا OpenRouter رایگان است؟
تا حدی. کلید رایگان است و مدل‌هایی که شناسه‌شان به «:free» ختم می‌شود، در سقف روزانه هزینه‌ای ندارند: تا 18 نوامبر 2026، روزی 50 درخواست، یا 1,000 درخواست اگر دست‌کم 10 واحد اعتبار خریده باشید. مدل‌های دیگر به اعتبار پیش‌پرداخت نیاز دارند.
کلید API را از کجای OpenRouter بگیرم؟
پس از ورود، در openrouter.ai/keys. یک کلید بسازید، اسمی برایش بگذارید و همه‌ی آن را کپی کنید؛ با «sk-or-v1-» شروع می‌شود.
OpenRouter برای iPhone یا Android برنامه دارد؟
OpenRouter برنامه‌ی چت موبایل خودش را منتشر نکرده است. از یک برنامه‌ی چت استفاده کنید که کلید OpenRouter را بپذیرد: در Oriveo، «ارائه‌دهندگان» را باز کنید، + را بزنید، OpenRouter را انتخاب کنید، کلید را جای‌گذاری کنید و «ادامه» را بزنید.
خطای 402 در OpenRouter یعنی چه؟
اعتبار حساب شما یا کلیدی که به کار می‌برید کافی نیست. در OpenRouter اعتبار اضافه کنید، یا اگر برای کلید سقف گذاشته‌اید آن را بالا ببرید، و دوباره امتحان کنید. این خطا خودبه‌خود برطرف نمی‌شود.
چرا کلید API در OpenRouter کار نمی‌کند؟
به شماره‌ی خطا نگاه کنید. 401 یعنی کلید اشتباه است یا کلید OpenRouter نیست؛ 402 یعنی اعتبار ندارید؛ 429 یعنی درخواست‌ها زیاد بوده یا به سقف مدل‌های رایگان رسیده‌اید. راهنمای خطاهای کلید API ما همه‌ی این کدها را توضیح می‌دهد.
کلید OpenRouter چه شکلی دارد؟
با «sk-or-v1-» شروع می‌شود و بعد از آن 64 حرف و رقم می‌آید؛ در مجموع 73 نویسه. اگر کلید شما کوتاه‌تر است، بخشی از آن کپی نشده است.

مطالب مرتبط

کلید OpenRouter را روی گوشی‌تان به کار ببرید

برنامه‌ی وب را باز کنید یا Oriveo را برای iPhone یا Android دانلود کنید، کلید OpenRouter را جای‌گذاری کنید و مدل‌ها را با هزینه‌ی تخمینی برای هر پاسخ عوض کنید.

هنوز کلید API ندارید؟ با Oriveo Free بدون آن شروع کنید.