ارائه‌دهنده‌ها
روشن‌کردن ارائه‌دهنده، گذاشتن کلید، انتخاب مدل و مدل بر پایه‌ی هدف، آزمون اتصال، و فهرست ارائه‌دهنده‌های پشتیبانی‌شده.
این صفحه تب ارائه‌دهنده‌ها (admin.php?page=wp-ai-connect&tab=providers) را کامل شرح می‌دهد: هر کارت چه فیلدهایی دارد، هر دکمه چه می‌کند، چه ارائه‌دهنده‌هایی هست و چگونه کلید و مدل را درست می‌گذارید.
تب ارائه‌دهنده‌ها
در بالای تب، برای هر ارائه‌دهنده یک کلید روشن/خاموش (چیپ) هست. ارائه‌دهنده‌ای که روشن کنید کارتش را در پایین باز می‌کند؛ نیازی نیست همه را روشن کنید و یک ارائه‌دهنده کافی است. تا وقتی هیچ‌کدام روشن نیست پیام «هنوز هیچ ارائه‌دهنده‌ای روشن نیست …» دیده می‌شود. اگر libsodium روی سرور نباشد، هشدار قرمز می‌گوید کلید نمی‌تواند امن نگه داشته شود و ارائه‌دهنده‌هایی که کلید می‌خواهند کار نمی‌کنند؛ از میزبان بخواهید آن را فعال کند.
کدام ارائه‌دهنده را روشن کنم
بخش بازشونده‌ی «کدام ارائه‌دهنده را روشن کنم؟» راهنمای انتخاب است:
| نیاز | پیشنهاد |
|---|---|
| شروع رایگان | Google Gemini، Groq، OpenRouter (مدل‌های رایگانش)، Cerebras، SambaNova یا GitHub Models؛ کلید رایگان با سقف روزانه |
| بهترین نوشتن فارسی | OpenAI، Anthropic یا Google Gemini با اعتبار API پولی (اشتراک ChatGPT یا Claude اعتبار API نیست) |
| پرداخت ریالی | GapGPT: چند خانواده‌ی مدل پشت یک کلید |
| مدل‌های زیاد با یک کلید | OpenRouter |
| جست‌وجوی معنایی در محتوای سایت | ارائه‌دهنده‌ای که مدل Embedding دارد: OpenAI، Google Gemini، Mistral، Cohere، Qwen، Together، GitHub Models یا Ollama |
| روی رایانه یا سرور خودتان، بی کلید | Ollama، یا هر سرویس سازگار با OpenAI با نشانی خودش |
بدون مدل Embedding، ایندکس باز هم با واژه‌ها جست‌وجو می‌کند. دومین ارائه‌دهنده به‌عنوان پشتیبان یا برای کاری که اولی انجام نمی‌دهد مفید است.
ارائه‌دهنده‌های پشتیبانی‌شده
| ارائه‌دهنده | سطح | نکته |
|---|---|---|
| OpenAI | پولی | مدل Embedding و ساخت تصویر دارد |
| Anthropic | پولی | |
| Google Gemini | رایگان (سطح رایگان) | مدل Embedding دارد |
| xAI Grok | پولی | |
| Mistral AI | اعتبار آزمایشی | مدل Embedding دارد |
| DeepSeek | پولی | |
| Cohere | اعتبار آزمایشی | مدل Embedding دارد |
| Ollama (این رایانه یا سرور خودتان) | روی رایانه‌ی خودتان | بی کلید؛ نشانی لازم؛ پیش‌فرض http://localhost:11434/v1 |
| Groq | رایگان | |
| OpenRouter | رایگان (مدل‌های :free) |
هزینه را خودش گزارش می‌دهد |
| GapGPT | پولی | از میزبان‌های ایران بی پروکسی کار می‌کند |
| Alibaba Qwen | اعتبار آزمایشی | مدل Embedding دارد |
| Together AI | اعتبار آزمایشی | مدل Embedding دارد |
| Cerebras | رایگان | |
| SambaNova | رایگان | |
| GitHub Models | رایگان | مدل Embedding دارد؛ کلید همان توکن GitHub |
| Cloudflare Workers AI | رایگان | «شناسه‌ی حساب» لازم |
| سرویس سازگار با OpenAI (سفارشی) | نامشخص | نشانی (base URL) لازم؛ برای هر سرویس سازگار |
نشان روی کارت یکی از این‌هاست: «سطح رایگان»، «اعتبار آزمایشی» یا «روی رایانه‌ی خودتان اجرا می‌شود». فهرست مدل‌های پیشنهادی هر کارت فقط پیشنهاد است؛ هر نام مدلی را که حسابتان دارد می‌توانید بنویسید.
نکته: افزونه‌های دیگر هم می‌توانند ردیف ارائه‌دهنده‌ی سازگار با OpenAI اضافه کنند؛ چنین ردیفی هرگز نمی‌تواند قیمت یک تماس را پایین‌تر حساب کند.
کارت ارائه‌دهنده
هر کارت از بالا این اجزا را دارد.
سربرگ و نشان‌ها
نام ارائه‌دهنده، نشان سطح (رایگان/آزمایشی/محلی)، نشان «پیش‌فرض» (برای ارائه‌دهنده‌ی پیش‌فرض) و وضعیت کلید: «کلید ذخیره شده»، «بدون کلید» یا «کلید باز نمی‌شود» (مثلاً بعد از انتقال سایت به سرور دیگر؛ کلید را دوباره بچسبانید). منوی سه‌نقطه‌ی «اقدام‌های بیشتر» گزینه‌ی «پاک‌کردن کلید» را دارد؛ پس از تأیید، کلید ذخیره‌شده حذف می‌شود و باید دوباره وارد شود.
کلید API
فیلد «کلید API» همیشه خالی است و فقط پایان کلید ذخیره‌شده را به‌صورت نقطه‌چین به‌عنوان راهنما نشان می‌دهد. کلید را بچسبانید (دکمه‌ی کنار فیلد از کلیپ‌بورد می‌چسباند؛ اگر مرورگر اجازه ندهد با Ctrl+V بچسبانید) و «ذخیره» را بزنید. کلید فوراً رمزشده ذخیره می‌شود. کلید را بدون فاصله وارد کنید. لینک «کلید را از کجا بگیرم» صفحه‌ی ساخت کلید همان ارائه‌دهنده و «راهنمای ارائه‌دهنده» مستندات او را باز می‌کند.
نشانی (base URL) و شناسه‌ی حساب
- «نشانی (base URL)» فقط برای Ollama و سرویس سازگار سفارشی دیده می‌شود. نشانی کامل را بنویسید، مثل
https://example.com/v1. نشانی خالی، غیروب، یاhttpبرای سرویس روی اینترنت پذیرفته نمی‌شود (خطایwpaic_bad_url). - «شناسه‌ی حساب» (
account_id) فقط برای Cloudflare Workers AI لازم است.
مدل
فیلد «مدل» نام مدل است و فهرست پیشنهادی دارد؛ اولین مدل فهرست پیش‌فرض است. اگر برای مدل انتخابی قیمتی شناخته نباشد (و ارائه‌دهنده خودش هزینه را گزارش ندهد و محلی نباشد)، هشدار «قیمتی برای این مدل شناخته نیست، پس هزینه‌اش صفر حساب می‌شود و سقف‌های هزینه آن را نمی‌بینند. قیمتش را در تب مصرف وارد کنید.» دیده می‌شود؛ فهرست قیمت را تکمیل کنید.
مدل بر پایه‌ی هدف
بخش بازشونده‌ی «مدل بر پایه‌ی هدف» سه خانه دارد: «سریع»، «هوشمند» و «ارزان». افزونه‌های دیگر نام مدل نمی‌خواهند، هدف (سریع، هوشمند یا ارزان) می‌خواهند و اتصال مدل متناظر را برمی‌دارد. خانه‌ی خالی یعنی مدل پیشنهادی ارائه‌دهنده (خانه‌ی راهنما آن را نشان می‌دهد). این بخش فقط برای ارائه‌دهنده‌هایی هست که فهرست مدل دارند.
دکمه‌های کارت
| دکمه | کار |
|---|---|
| پیش‌فرض شود | این ارائه‌دهنده را پیش‌فرض می‌کند (گزینه‌ی default_provider؛ پیش‌فرض: خالی) |
| بارگذاری مدل‌ها | فهرست واقعی مدل‌های حسابتان را از ارائه‌دهنده می‌گیرد و به فهرست پیشنهاد اضافه می‌کند |
| آزمون با یک پرسش | یک درخواست بسیار کوچک واقعی می‌فرستد؛ فرق «کلید رد شد» با «مشکل شبکه» را می‌گوید. نتیجه: «کار می‌کند.» یا «آزمون ناموفق بود.» با «پیام ارائه‌دهنده»، «یعنی چه» و «راه حل» |
| بررسی اتصال | فقط می‌پرسد آیا این سرور به نشانی اصلی ارائه‌دهنده می‌رسد. کلید را نمی‌سنجد و بدون کلید می‌فرستد. پیام: «آدرس ارائه‌دهنده از این سرور پاسخ می‌دهد» یا «در دسترس نیست» |
| ذخیره | کلید، نشانی، مدل و مدل‌های هدف این کارت را ذخیره می‌کند |
نکته: «در دسترس نیست» لزوماً غلط‌بودن کلید نیست؛ بعضی میزبان‌ها (مثلاً در ایران) بعضی ارائه‌دهنده‌ها را می‌بندند. ارائه‌دهنده‌ی دیگری انتخاب کنید یا در ورودی سفارشی نشانی پروکسی بگذارید. راه‌حل هر خطا در عیب‌یابی آمده است.
ترتیب پیشنهادی راه‌اندازی
- ارائه‌دهنده را روشن کنید، کلید را از لینک «کلید را از کجا بگیرم» بسازید و بچسبانید.
- «ذخیره» را بزنید.
- «بررسی اتصال» و بعد «آزمون با یک پرسش».
- اگر مدل اشتباه است «بارگذاری مدل‌ها» را بزنید، مدل را انتخاب و ذخیره کنید.
- «پیش‌فرض شود» را بزنید.
- در مصرف سقف هزینه بگذارید و در صورت نیاز پشتیبان را تنظیم کنید.