TypingMind

OneProvider را در TypingMind به‌صورت custom model اضافه کنید. TypingMind نشانی کامل endpoint را می‌خواهد، نه base URL.

TypingMind فیلدی برای base URL ندارد: فرم custom model نشانی کامل endpoint را می‌گیرد و درخواست‌ها را دقیقاً به همان نشانی می‌فرستد و چیزی به آن اضافه نمی‌کند. فیلد داخلی کلید API برای Claude (Anthropic) مستقیماً با Anthropic ارتباط برقرار می‌کند، پس کلید OneProvider در TypingMind فقط به‌صورت custom model کار می‌کند.

1. افزودن custom model

1. در TypingMind از نوار کناری چپ Models را باز کنید، روی Add custom model بزنید و روی Create Manually بمانید.
2. Name: هر نامی، مثلاً OneProvider claude-opus-5-5.
3. Model ID: شناسهٔ دقیق از صفحهٔ مدل‌ها ، مثلاً claude-opus-5-5. نام نمایشی «Claude Opus 5.5» شناسه نیست.
4. Context Length: پنجرهٔ زمینهٔ مدل از همان صفحه.

2. API Type، Endpoint URL و کلید

در زبانهٔ Authentication یکی از دو نوع API را انتخاب کنید و فیلدها را دقیقاً مانند زیر پر کنید. همان کلید OneProvider برای هر دو کار می‌کند.

Claude Messages API (مدل‌های Claude)

API Type: Claude Messages API
Endpoint URL: https://api.oneprovider.dev/v1/messages
Authentication Type: API Key via HTTP Header
Header Key: x-api-key
Header Value: sk-your-key-here
Model ID: claude-opus-5-5

OpenAI Chat Completions API (مدل‌های GPT و Claude)

API Type: OpenAI Chat Completions API
Endpoint URL: https://api.oneprovider.dev/v1/chat/completions
Authentication Type: API Key via HTTP Header
Header Key: Authorization
Header Value: Bearer sk-your-key-here
Model ID: gpt-6.1-terra

Header Value شامل واژهٔ Bearer، یک فاصله و سپس کل کلید شماست. شناسه‌های Claude مانند claude-sonnet-5-5 هم روی این مسیر کار می‌کنند.

3. Temperature و گزینه‌های درخواست

• temperature را روی مقدار پیش‌فرض بگذارید. مدل‌های Claude 5.x به temperature غیرپیش‌فرض پاسخ 400 می‌دهند؛ اگر آن را در تنظیمات مدل یا گفت‌وگوی TypingMind تغییر داده‌اید، به پیش‌فرض برگردانید.
• به Route requests via TypingMind Cloud نیازی نیست: API ما درخواست‌ها را مستقیماً از مرورگر می‌پذیرد (CORS).

4. Test & Save

روی Test & Save بزنید، سپس مدل تازه را در یک گفت‌وگو انتخاب کنید.

هر مدل یک custom model جداگانه است: برای هر شناسه‌ای که می‌خواهید مراحل را با همان Endpoint URL و همان کلید تکرار کنید.

کدام مدل را انتخاب کنیم

claude-opus-5-5 برای گفت‌وگوهای طولانی و دشوار مناسب است، claude-sonnet-5-5 گزینهٔ متعادل پیش‌فرض است و claude-haiku-5-5 گزینهٔ سریع و ارزان؛ مدل‌های GPT مانند gpt-6.1-terra از نوع OpenAI Chat Completions API استفاده می‌کنند. شناسه را دقیقاً مانند صفحهٔ مدل‌ها وارد کنید؛ نرخ‌ها در صفحهٔ قیمت‌ها آمده است.

خطاهای رایج و راه‌حل‌ها

404 Not Found

در Endpoint URL یک base URL آمده است (https://api.oneprovider.dev/v1 یا https://api.oneprovider.dev). برای نوع Claude Messages API از https://api.oneprovider.dev/v1/messages و برای نوع OpenAI Chat Completions API از https://api.oneprovider.dev/v1/chat/completions استفاده کنید.

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

Model ID باید شناسهٔ دقیق باشد، مثلاً claude-opus-5-5، نه نام نمایشی مدل. آن را از صفحهٔ مدل‌ها کپی کنید.

خطای 400 به‌خاطر temperature

مدل‌های Claude 5.x فقط temperature پیش‌فرض را می‌پذیرند. temperature را در TypingMind به پیش‌فرض برگردانید و پیام را دوباره بفرستید.

401 authentication_error

Claude Messages API: Header Key برابر x-api-key و مقدار آن کل کلید. OpenAI Chat Completions API: Header Key برابر Authorization و مقدار آن Bearer sk-....

کلید در فیلد داخلی Claude در TypingMind کار نمی‌کند

این فیلد درخواست‌ها را به Anthropic می‌فرستد و Anthropic کلید OneProvider را نمی‌شناسد. OneProvider را همان‌طور که در بالا آمده به‌صورت custom model اضافه کنید.

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

TypingMind به base URL نیاز دارد یا endpoint کامل؟

endpoint کامل. TypingMind هیچ مسیری اضافه نمی‌کند، پس نشانی باید به /v1/messages یا /v1/chat/completions ختم شود.

آیا به Route requests via TypingMind Cloud نیاز دارم؟

نه. API ما درخواست‌های مرورگر را می‌پذیرد (CORS)، پس TypingMind می‌تواند مستقیماً آن را فراخوانی کند.

می‌توانم از مدل‌های GPT استفاده کنم؟

بله: نوع OpenAI Chat Completions API و یک شناسهٔ GPT مانند gpt-6.1-terra را انتخاب کنید.

آیا یک مورد می‌تواند همهٔ مدل‌ها را پوشش دهد؟

نه. هر مدل یک custom model جداگانه با همان Endpoint URL و همان کلید است.

پاسخ‌های سریع

از کدام base URL استفاده کنم؟

Claude Code و SDKهای Anthropic از https://api.oneprovider.dev استفاده می‌کنند. SDKهای OpenAI و کلاینت‌های سازگار با OpenAI از https://api.oneprovider.dev/v1 استفاده می‌کنند. یک کلید پشت هر دو آدرس کار می‌کند؛ فهرست مدل‌ها در صفحهٔ مدل‌ها و نرخ‌ها در صفحهٔ قیمت‌ها است.

چگونه احراز هویت کنم؟

کلید خام sk-… را در x-api-key یا Authorization: Bearer بفرستید: یکی از این دو، نه هر دو. کلید را در یک متغیر محیطی نگه دارید، نه در فایلی که commit می‌شود. اطلاعات بیشتر دربارهٔ احراز هویت .

کلید را از کجا بگیرم؟

حساب کاربری خود را در ربات Telegram به نام @oneprovider_robot یا در app.oneprovider.dev باز کنید، موجودی را شارژ کنید و «صدور کلید» را بزنید. هر کلید می‌تواند سقف مصرف مخصوص خودش را داشته باشد. حساب کاربری و کلیدهای API .

کدهای 401، 404 و 429 یعنی چه؟

401: کلید ارسال نشده، اشتباه تایپ شده یا در هدر نادرست فرستاده شده است؛ کلید را کامل و بدون گیومه و فاصله جای‌گذاری کنید. 404: معمولاً base URL نادرست است، مثلاً /v1 جا افتاده یا دوبار آمده است. 429 با پیام «Insufficient balance»: موجودی حساب کاربری یا سقف مصرف کلید تمام شده است؛ به‌جای تلاش دوباره، شارژ کنید. هر 429 دیگری محدودیت نرخ است؛ تا پایان زمان Retry-After صبر کنید. جزئیات: کدهای خطا و رفع اشکال .

چرا استریم‌ها قطع یا ریست می‌شوند؟

VPN و پروکسی‌های VLESS اغلب SSE را بافر می‌کنند یا مذاکرهٔ HTTP/2 را مختل می‌کنند. OneProvider هیچ محدودیت منطقه‌ای ندارد و استریم‌ها را بافر نمی‌کند؛ پروکسی را خاموش کنید و دوباره امتحان کنید.

اگر این‌ها کافی نبود از کجا بپرسم؟

در Telegram به @Oneproviderhelpbot پیام بدهید یا در حساب کاربری وب «پشتیبانی» را باز کنید و کد وضعیت HTTP و متن دقیق خطا را بفرستید. پشتیبانی چگونه کار می‌کند .