گرفتن کلید 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 یعنی اعتبارتان تمام شده است.

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» دارند؛ پیش از اینکه به یکی تکیه کنید، آنجا را بررسی کنید.
| حساب شما | درخواست به مدلهای رایگان در دقیقه | درخواست به مدلهای رایگان در روز |
|---|---|---|
| در مجموع کمتر از 10 واحد اعتبار خریدهاید | 20 | 50 |
| در مجموع دستکم 10 واحد اعتبار خریدهاید | 20 | 1,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» ختم میشود.

کلید 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 هنوز آن را ارائه میدهد.
| خطا | معنی | چه کنید |
|---|---|---|
| 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 رایگان است؟
کلید API را از کجای OpenRouter بگیرم؟
OpenRouter برای iPhone یا Android برنامه دارد؟
خطای 402 در OpenRouter یعنی چه؟
چرا کلید API در OpenRouter کار نمیکند؟
کلید OpenRouter چه شکلی دارد؟
مطالب مرتبط
کلید OpenRouter را روی گوشیتان به کار ببرید
برنامهی وب را باز کنید یا Oriveo را برای iPhone یا Android دانلود کنید، کلید OpenRouter را جایگذاری کنید و مدلها را با هزینهی تخمینی برای هر پاسخ عوض کنید.
هنوز کلید API ندارید؟ با Oriveo Free بدون آن شروع کنید.