APIsRouter را به‌عنوان یک provider API در OpenCat اضافه کنید.

Updated 2026-07-29

OpenCat یک کلاینت native bring-your-own-key برای Mac، iPhone، و iPad است، و provider های سفارشی یک ویژگی داخلی‌اند: یک entry با API Host تنظیم‌شده روی https://api.apisrouter.com/v1 باعث می‌شود Claude، GPT، DeepSeek، GLM، و Kimi در همان اپ زیر یک کلید تکی قرار بگیرند.

پاسخ سریع: یک entry provider در Settings.

Settings را باز کنید، به API Providers بروید، و یک provider اضافه کنید (یا provider موجود OpenAI را ویرایش کنید). چهار فیلد کار را انجام می‌دهند: یک نام نمایشی به انتخاب خود، پروتکل تنظیم‌شده روی OpenAI، API Host تنظیم‌شده روی https://api.apisrouter.com/v1 با /v1 شامل، و کلید API. این کل یکپارچگی است؛ OpenCat chat completions استاندارد را به هر host ای که entry provider نام می‌برد صحبت می‌کند. وقتی provider ذخیره شود، OpenCat مدل‌هایی که endpoint سرویس می‌دهد را فهرست می‌کند. اگر مدلی که می‌خواهید در فهرست خودکارپرشده ظاهر نشود، آن را دستی با id دقیقش اضافه کنید، اپ id های تایپ‌شده را دقیقاً برای همین حالت می‌پذیرد. از آن به بعد، هر مکالمه و دستیار در اپ می‌تواند هر id کاتالوگ را مثل یک گزینه native انتخاب کند.

Name:      APIsRouter
Protocol:  OpenAI
API Host:  https://api.apisrouter.com/v1
API Key:   sk-APIsRouter-...

models auto-list from the endpoint;
add ids manually if one is missing

OpenCat چطور با provider ها و دستیارها رفتار می‌کند.

OpenCat یکی از قدیمی‌ترین کلاینت‌های native AI در اکوسیستم اپل است، یک اپ Mac، iPhone، و iPad با دنبال‌کننده قوی در سرتاسر آسیا، ساخته‌شده حول ایده bring-your-own-key: اپ interface است، کلیدهای شما دسترسی است، و هیچ واسطه هر-پیامی وجود ندارد. توسعه‌دهنده آن خود اپ را می‌فروشد، یک tier رایگان به‌علاوه یک خرید یک‌باره Pro که در opencat.app از جولای ۲۰۲۶ به قیمت ۹.۹۹ دلار فهرست شده، که شکل اقتصادی متفاوتی از محصولات چت اشتراکی است و دقیقاً به همین دلیل یک کلید gateway اندازه‌گیری‌شده با آن خوب جفت می‌شود. مکانیزم‌هایی که اهمیت دارند: provider ها و دستیارها لایه‌های جدا هستند. یک provider یک پروتکل، یک host، و یک کلید است. یک دستیار یک شخصیت است، یک system prompt به‌علاوه یک انتخاب مدل، و OpenCat تشویق می‌کند چندین‌تا نگه دارید. با یک provider gateway، این به یک الگوی واقعاً مفید تبدیل می‌شود: یک دستیار نویسندگی روی claude-sonnet-4-6، یک دستیار پاسخ-سریع روی claude-haiku-4-5-20251001، یک دستیار دوزبانه روی glm-5.2 یا kimi-k2.6، همه در یک اپ، قابل‌سوییچ به ازای هر مکالمه، صورت‌حساب‌شده به یک کلید. اپ همچنین چت، ترجمه، مکالمه صوتی، و بحث تصویر را در همان interface می‌گنجاند، و هرکدام از این ویژگی‌ها روی مدلی سوار می‌شود که دستیار فعلی انتخاب می‌کند. provider را به یک endpoint چند-vendor اشاره دهید و هر ویژگی بی‌صدا انتخاب مدل هم می‌گیرد.

راه‌اندازی کامل: provider، مدل‌ها، دستیارها.

provider را روی هر دستگاهی که در دسترس است اضافه کنید؛ OpenCat مکالمات و تنظیمات را بین دستگاه‌ها از طریق iCloud در tier پولی خود همگام می‌کند، پس یک provider پیکربندی‌شده روی Mac معمولاً به iPhone هم می‌رود بدون نیاز به ورود مجدد. اگر tier رایگان را به ازای هر دستگاه اجرا می‌کنید، همان چهار فیلد را روی هرکدام وارد کنید. سپس دستیارها را حول مدل‌ها بسازید نه اینکه انتخاب‌گر مدل را یک تفکر ثانویه در نظر بگیرید. یک دستیار بسازید، یک system prompt به آن بدهید، و آن را به یک id کاتالوگ متصل کنید. تقسیم کار عملی: id های سریع برای دستیاری که تمام روز با آن صحبت می‌کنید، یک id frontier برای آنی که چیزهایی که اهمیت دارند را پیش‌نویس می‌کند، و یک id دوزبانه برای آنی که متن چینی، ژاپنی، یا کره‌ای را مدیریت می‌کند. چون OpenCat اجازه می‌دهد چند دستیار همزیستی کنند، مسیردهی مدل به ازای هر وظیفه را بدون فکرکردن وسط مکالمه می‌گیرید. برای ویژگی‌های ترجمه و صدا، مدل پشت دستیار فعلی کار زبانی را انجام می‌دهد، که tier سریع را پیش‌فرض درست آنجا می‌کند: نوبت‌های ترجمه کوتاه، مکرر، و حساس-به-latency هستند، دقیقاً پروفایلی که deepseek-v4-flash و claude-haiku-4-5-20251001 برای آن قیمت‌گذاری شده‌اند.

Writer     -> claude-sonnet-4-6        (drafts, long answers)
Quick      -> claude-haiku-4-5-20251001 (default chatter)
Bilingual  -> glm-5.2                   (zh/en mixed threads)
Translate  -> deepseek-v4-flash         (short, frequent turns)

all four assistants -> one provider -> one key

انتخاب مدل‌ها برای یک کلاینت native.

اتصال به ازای هر-دستیار مقایسه را بی‌زحمت می‌کند: یک دستیار را کپی کنید، فقط مدل را تغییر دهید، و هر دو را در برابر سؤالات واقعی خود برای یک روز اجرا کنید. usage log مقایسه را به ازای هر id قیمت‌گذاری می‌کند در حالی که مکالمات به شما می‌گویند کدام‌یک را بیشتر باز کردید.

  • استفاده phone-first استفاده latency-first است. claude-haiku-4-5-20251001 و deepseek-v4-flash به‌اندازه کافی سریع پاسخ می‌دهند که اپ native احساس شود نه شبکه‌ای.
  • اقتصاد خرید-یک‌باره کلیدهای اندازه‌گیری‌شده را پاداش می‌دهد: بدون هزینه seat یعنی تنها هزینه تکرارشونده شما token هاست، پس گذاشتن ترافیک اتفاقی روی id های سریع یک ماه سنگین را کوچک نگه می‌دارد.
  • claude-sonnet-4-6 دستیاری را کسب می‌کند که برایتان می‌نویسد، جایی که قیمت هر-پیام کیفیت قابل‌مشاهده می‌خرد.
  • glm-5.2 و kimi-k2.6 انتخاب‌های درجه‌یک برای ترافیک چینی-انگلیسی هستند که سهم بزرگی از پایگاه کاربری OpenCat واقعاً دارد؛ از طریق gateway در همان انتخاب‌گر Claude می‌نشینند به‌جای نیاز به حساب‌های vendor جدا.
  • نوبت‌های ترجمه و صدا کوتاه و ثابت‌اند؛ آن‌ها را روی tier سریع نگه دارید و ویژگی‌ها رایگان احساس می‌شوند.

پرداخت بر اساس مصرف · پایین‌تر از قیمت رسمی

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

مدلقیمت رسمیقیمت ما
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
Claude Haiku 4.5 20251001$1.00 / $5.00 per M$0.80 / $4.00 per M
DeepSeek V4 Flash$0.14 / $0.28 per M$0.10 / $0.30 per M
GLM-5.2$1.14 / $4.00 per M$1.10 / $4.00 per M
Kimi K2.6$0.95 / $4.00 per M$1.00 / $4.00 per M

حالت‌های شکست مختص OpenCat.

درخواست‌هایی که هنوز بعد از راه‌اندازی به api.openai.com می‌روند یعنی مکالمه از provider جدید شما استفاده نمی‌کند. provider ها در OpenCat همزیستی می‌کنند، و یک دستیار یا مکالمه ساخته‌شده قبلاً اتصال provider اصلی خود را نگه می‌دارد؛ به‌جای فرض‌کردن entry جدید به‌طور جهانی جایگزین شده، provider و مدل دستیار را سوییچ کنید. یک API Host بدون /v1 وقتی اپ مسیرهای درخواست را اضافه می‌کند شکست می‌خورد؛ شکل کارآمد، همان‌طور که راهنماهای gateway برای OpenCat به‌طور مداوم نشان می‌دهند، base با /v1 شامل است، https://api.apisrouter.com/v1. یک فهرست مدل خالی یا جزئی بن‌بست نیست. فهرست خودکار به فهرست مدل endpoint وابسته است، و OpenCat id های دستی‌تایپ‌شده را برای هر چیز گمشده می‌پذیرد؛ خروجی /v1/models با کلید شما نگارش معتبر برای آنچه تایپ می‌کنید است. کلیدها به ازای هر entry provider هستند، پس کلیدی که روی gateway چرخانده شده باید در تنظیمات provider به‌روزرسانی شود؛ اپی که بعد از ماه‌ها سکوت ناگهان شکست می‌خورد معمولاً یک کلید منقضی یا چرخانده‌شده است، نه یک مشکل اپ. و اگر دستگاه‌ها با هم مخالف باشند، یکی کار می‌کند و دیگری شکست می‌خورد، مرز sync تنظیمات اولین مظنون است: تأیید کنید دستگاه شکست‌خورده واقعاً entry provider و کلید را دارد.

چه کسانی OpenCat را از طریق یک gateway مسیردهی می‌کنند.

  • کاربران BYOK که اپ را خریدند تا از اشتراک‌ها فرار کنند و می‌خواهند سمت کلید هم به همان اندازه ساده باشد: یک موجودی، هر مدل، بدون کارت روی فایل.
  • کاربران دوزبانه در سرتاسر چینی و انگلیسی، که برای آن‌ها GLM و Kimi کنار Claude در یک انتخاب‌گر همان workflow روزانه است، نه یک novelty.
  • افراد چند-دستگاهی، Mac روی میز و iPhone در سفر، که یک entry provider سرویس‌دهنده به هر دو می‌خواهند به‌جای اپ‌ها و login های جدا هر-vendor.
  • مترجمان سنگین که از ویژگی‌های ترجمه OpenCat استفاده می‌کنند، جایی که نوبت‌های کوتاه مکرر روی id های کاتالوگ سریع عادت را ارزان نگه می‌دارد.
  • توسعه‌دهندگان بدون دسترسی به صورت‌حساب یک vendor خاص. دسترسی مبتنی بر شارژ بدون الزام کارت وابستگی ثبت‌نام هر-provider را حذف می‌کند.

endpoint را تأیید کنید و اولین چت را عیب‌یابی کنید.

اگر دم دست است ابتدا endpoint را از یک ترمینال تأیید کنید: مدل‌ها را با کلید خود فهرست کنید و id هایی که قصد استفاده دارید را چک کنید. روی راه‌اندازی‌های فقط-iPhone، مستقیم به مسیر داخل-اپ بروید: provider را ذخیره کنید، تماشا کنید آیا فهرست مدل پر می‌شود، و یک پیام کوتاه بفرستید. دسته‌بندی شکست کوتاه است. یک خطای authentication فیلد کلید است. یک خطای اتصال یا not-found API Host است، تقریباً همیشه /v1 گمشده. یک خطای مدل یعنی id متفاوت از فهرست endpoint تایپ شده. و یک مکالمه‌ای که مثل provider قدیمی رفتار می‌کند به provider قدیمی متصل است؛ تنظیمات دستیار را چک کنید، نه فهرست provider. وقتی پیام‌ها جاری شوند، کنسول APIsRouter مدل، شمارش token، و هزینه هر-درخواست را نشان می‌دهد. برای یک اپ bring-your-own-key، آن log کل تصویر مالی است، هر دستگاه و هر دستیار روی یک صفحه، که دقیقاً همان قابلیت‌دیدی است که اپ‌های چت اشتراکی هرگز به شما نمی‌دهند.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

پرسش‌های پرتکرار

کجا یک provider سفارشی سازگار با OpenAI را در OpenCat اضافه کنم؟

Settings، API Providers، Add Provider (یا entry موجود OpenAI را ویرایش کنید). پروتکل را روی OpenAI تنظیم کنید، API Host را روی https://api.apisrouter.com/v1، و کلید خود را بچسبانید. مدل‌ها خودکار فهرست می‌شوند، با ورود دستی id برای هر چیز گمشده.

آیا API Host باید شامل /v1 باشد؟

بله. شکل کارآمد نشان‌داده‌شده در راهنماهای راه‌اندازی gateway برای OpenCat شامل /v1 است: https://api.apisrouter.com/v1. بدون آن، درخواست‌ها وقتی اپ مسیر chat-completions را اضافه می‌کند شکست می‌خورند.

آیا OpenCat می‌تواند Claude، GLM، و Kimi را از طریق یک provider اجرا کند؟

بله. OpenCat id مدل انتخاب‌شده را به‌عنوان رشته ساده به host provider فوروارد می‌کند، پس هر id ای که endpoint سرویس دهد کار می‌کند: claude-sonnet-4-6، glm-5.2، kimi-k2.6، و deepseek-v4-flash همه در همان انتخاب‌گر زیر یک کلید می‌نشینند.

مدلی که می‌خواهم در فهرست OpenCat نیست. گیر افتاده‌ام؟

خیر. فهرست خودکار از فهرست مدل endpoint می‌آید، و OpenCat id های مدل دستی‌اضافه‌شده را می‌پذیرد. id را دقیقاً همان‌طور که در خروجی /v1/models ظاهر می‌شود تایپ کنید و مثل هر مدل فهرست‌شده قابل‌انتخاب می‌شود.

آیا برای استفاده از یک provider سفارشی به OpenCat Pro نیاز دارم؟

OpenCat یک tier رایگان و یک خرید یک‌باره Pro عرضه می‌کند، که در opencat.app از جولای ۲۰۲۶ به قیمت ۹.۹۹ دلار فهرست شده، با Pro که راحتی‌هایی مثل sync iCloud اضافه می‌کند. استفاده bring-your-own-key طراحی اصلی اپ است؛ تقسیم فعلی ویژگی‌ها را در opencat.app چک کنید چون tier ها تکامل می‌یابند.

چرا یکی از دستگاه‌های من کار می‌کند در حالی که دیگری شکست می‌خورد؟

entry های provider و کلیدها از طریق sync تنظیمات به دستگاه‌های دیگر می‌رسند، که به tier و وضعیت iCloud شما بستگی دارد. تنظیمات provider دستگاه شکست‌خورده را باز کنید و تأیید کنید entry و کلید واقعاً حاضرند، سپس اگر نیستند دوباره واردشان کنید.