Koneek – ارائه‌دهنده هوش مصنوعی برای OpenAI-Compatible

توضیحات

Koneek AI وردپرس را به OpenAI، Google Gemini، Anthropic Claude و هر پایانه (endpoint) سازگار با OpenAI متصل می‌کند، همه این‌ها از طریق یک افزونه واحد. این افزونه از پاسخ‌های استاندارد JSON و Server-Sent Events (SSE) از درگاه‌های هوش مصنوعی مانند OmniRoute و 9Router پشتیبانی می‌کند. نیازی به نصب افزونه‌های ارائه‌دهنده جداگانه برای هر سرویس نیست. این افزونه بر پایه WordPress Connectors API ساخته شده و کلیدهای API پیش از ذخیره در پایگاه داده، رمزنگاری می‌شوند.

به هر تعداد که مایلید اتصال ارائه‌دهنده با اولویت اختصاصی اضافه کنید. هنگامی که کلاینت هوش مصنوعی وردپرس درخواستی ارسال می‌کند، Koneek ابتدا آن را به سمت کمترین عدد اولویت هدایت می‌کند و اگر آن ارائه‌دهنده با اتمام مهلت‌زمان مواجه شود یا خطا برگرداند، به‌طور خودکار به اتصال بعدی بازمی‌گردد — حتی بازگشت بین ارائه‌دهندگان مختلف (برای نمونه، ابتدا OpenAI، سپس Anthropic و در نهایت Google).

ویژگی‌ها:

• اتصالات چند‌ارائه‌دهنده: هر تعداد اتصال — شامل چندین کلید برای یک ارائه‌دهنده واحد — را که هرکدام مدل و اولویت اختصاصی خود را دارند، پیکربندی کنید.
• بازگشت مبتنی بر اولویت: درخواست‌ها ابتدا اولویت 1 را امتحان می‌کنند؛ در صورت اتمام مهلت‌زمان یا بروز خطا، Koneek به‌طور خودکار اتصال بعدی را به ترتیب دوباره امتحان می‌کند. به لطف لایه ترجمه خودکار قالب درخواست/پاسخ، بازگشت بین ارائه‌دهندگان مختلف کار می‌کند.
• پشتیبانی از چند‌ارائه‌دهنده: یکپارچه‌سازی بی‌نقص با OpenAI، Google Gemini، Anthropic Claude و ارائه‌دهندگان سفارشی سازگار با OpenAI (مانند Groq، Together AI، NVIDIA و غیره).
• ذخیره‌سازی امن: کلیدهای API به‌صورت امن در پایگاه داده با استفاده از رمزنگاری قوی AES-256-CBC که از Saltهای امنیتی وردپرس شما (در wp-config.php) مشتق شده، ذخیره می‌شوند. کلید هر اتصال در تنظیمات اختصاصی خود ذخیره می‌شود که نام آن از ارائه‌دهنده و نام اتصال گرفته شده است (koneek_api_key_openai، koneek_api_key_custom_openai_nvidia، koneek_api_key_anthropic و …).
• مهلت‌زمان برای هر اتصال: تعیین کنید پیش از بازگشت به ارائه‌دهنده بعدی، چه مدت منتظر بماند.
• لایه سازگاری OpenAI: فراخوانی‌های استاندارد API را به‌طور خودکار به ارائه‌دهندگان سفارشی هدایت می‌کند و فرمت‌های جدیدتر API Responses را به Chat Completions استاندارد تبدیل می‌نماید.
• پشتیبانی از پاسخ SSE: پاسخ‌های جریانی Server-Sent Events را از درگاه‌های هوش مصنوعی سازگار با OpenAI تجزیه می‌کند، که شامل محتوای استدلال (reasoning) و پاسخ نهایی به‌صورت جداگانه است.
• یکپارچه‌سازی خودکار: اعتبارنامه‌ها را به‌طور خودکار با WordPress Connectors API همگام‌سازی و ثبت می‌کند و مجوزهای اتصال را برای افزونه‌های هوش مصنوعی به‌صورت خودکار تایید می‌کند.
• نگاشت منعطف مدل: از میان مدل‌های از پیش تعیین‌شده انتخاب کنید یا نام مدل‌های سفارشی خود را وارد نمایید.

نیازمندی‌ها:

• PHP 7.4 یا بالاتر
• کلید API OpenAI، کلید API Gemini، کلید API Anthropic یا هر کلید API سازگار با OpenAI

چگونه کار می‌کند

این افزونه مستقیماً تولید محتوای هوش مصنوعی را انجام نمی‌دهد. این یک اتصال‌دهنده/پل است که اعتبارنامه‌های ارائه‌دهنده شما را در SDK کلاینت هوش مصنوعی وردپرس ثبت می‌کند.

نشانی‌های URL API ارائه‌دهندگان (مانند api.openai.com، api.anthropic.com، generativelanguage.googleapis.com) منحصراً برای موارد زیر استفاده می‌شوند:

1. متادیتا ارائه‌دهنده — پیکربندی URL پایه که به رجیستری کلاینت هوش مصنوعی وردپرس ارسال می‌شود تا SDK بداند درخواست‌ها را به کجا هدایت کند.
2. تست اتصال — یک ویژگی “آزمایش اتصال” فقط برای مدیر که یک درخواست حداقلی (max_tokens=1) برای اعتبارسنجی کلید API و مدل شما پیش از ذخیره ارسال می‌کند. این برای تولید محتوا استفاده نمی‌شود.
3. بازنویسی URL ارائه‌دهنده سفارشی — برای پایانه‌های سازگار با OpenAI، افزونه درخواست‌های کلاینت هوش مصنوعی وردپرس را رهگیری کرده و آن‌ها را به URL سفارشی شما هدایت می‌کند.

تمام تولیدات واقعی هوش مصنوعی توسط SDK کلاینت هوش مصنوعی وردپرس (WordPress\AiClient\AiClient) مدیریت می‌شود. این افزونه صرفاً اطمینان حاصل می‌کند که ارائه‌دهنده صحیح ثبت شده و اعتبارنامه‌ها در دسترس هستند.

هیچ SDK هوش مصنوعی شخص ثالثی در composer.json وجود ندارد. تنها تماس‌های HTTP به APIهای ارائه‌دهندگان از بخش تست اتصال (فقط برای مدیر، اعتبارسنجی سبک) سرچشمه می‌گیرد.

سرویس‌های خارجی

این افزونه برای اهداف تست اتصال و ثبت اعتبارنامه به APIهای ارائه‌دهندگان هوش مصنوعی شخص ثالث متصل می‌شود. این افزونه مستقیماً تولید محتوای هوش مصنوعی را انجام نمی‌دهد — تمام فرآیند تولید هوش مصنوعی توسط SDK کلاینت هوش مصنوعی وردپرس مدیریت می‌شود.

API OpenAI

برای اعتبارسنجی کلیدهای API و تست اتصال هنگام کلیک مدیر بر روی “آزمایش اتصال” در صفحه تنظیمات استفاده می‌شود. یک درخواست حداقلی (max_tokens=1) برای تایید معتبر بودن کلید API و مدل ارسال می‌شود. نشانی URL API نیز در SDK کلاینت هوش مصنوعی وردپرس ثبت می‌شود تا بتواند درخواست‌های تولید را هدایت کند.

داده‌های ارسالی: کلید API، نام مدل و یک پرامپت آزمایشی تک‌کلمه‌ای (“Hi”) با max_tokens=1.
زمان: تنها زمانی که مدیر به‌صورت دستی روی “آزمایش اتصال” در صفحه تنظیمات افزونه کلیک کند، یا هنگامی که SDK کلاینت هوش مصنوعی وردپرس درخواست‌های تولید را از طریق ارائه‌دهنده ثبت‌شده ارسال کند.

سرویس ارائه‌شده توسط OpenAI, LLC.
شرایط استفاده: https://openai.com/policies/terms-of-use
سیاست حریم خصوصی: https://openai.com/policies/privacy-policy

API Anthropic

برای اعتبارسنجی کلیدهای API و تست اتصال هنگام کلیک مدیر بر روی “آزمایش اتصال” در صفحه تنظیمات استفاده می‌شود. یک درخواست حداقلی (max_tokens=1) برای تایید معتبر بودن کلید API و مدل ارسال می‌شود. نشانی URL API نیز در SDK کلاینت هوش مصنوعی وردپرس ثبت می‌شود تا بتواند درخواست‌های تولید را هدایت کند.

داده‌های ارسالی: کلید API، نام مدل و یک پرامپت آزمایشی تک‌کلمه‌ای (“Hi”) با max_tokens=1.
زمان: تنها زمانی که مدیر به‌صورت دستی روی “آزمایش اتصال” در صفحه تنظیمات افزونه کلیک کند، یا هنگامی که SDK کلاینت هوش مصنوعی وردپرس درخواست‌های تولید را از طریق ارائه‌دهنده ثبت‌شده ارسال کند.

سرویس ارائه‌شده توسط Anthropic PBC.
شرایط استفاده: https://www.anthropic.com/legal/consumer-terms
سیاست حریم خصوصی: https://www.anthropic.com/legal/privacy

API زبان مولد گوگل (Gemini)

برای اعتبارسنجی کلیدهای API و تست اتصال هنگام کلیک مدیر بر روی “آزمایش اتصال” در صفحه تنظیمات استفاده می‌شود. یک درخواست حداقلی (maxOutputTokens=1) برای تایید معتبر بودن کلید API و مدل ارسال می‌شود. نشانی URL API نیز در SDK کلاینت هوش مصنوعی وردپرس ثبت می‌شود تا بتواند درخواست‌های تولید را هدایت کند.

داده‌های ارسالی: کلید API، نام مدل و یک پرامپت آزمایشی تک‌کلمه‌ای (“Hi”) با maxOutputTokens=1.
زمان: تنها زمانی که مدیر به‌صورت دستی روی “آزمایش اتصال” در صفحه تنظیمات افزونه کلیک کند، یا هنگامی که SDK کلاینت هوش مصنوعی وردپرس درخواست‌های تولید را از طریق ارائه‌دهنده ثبت‌شده ارسال کند.

سرویس ارائه‌شده توسط Google LLC.
شرایط استفاده: https://ai.google.dev/gemini-api/terms
سیاست حریم خصوصی: https://policies.google.com/privacy

پایانه‌های سفارشی سازگار با OpenAI

هنگامی که با یک ارائه‌دهنده سفارشی (مانند Groq، Together AI، NVIDIA) پیکربندی شود، افزونه درخواست‌های API را از SDK کلاینت هوش مصنوعی وردپرس به نشانی URL پایانه مشخص‌شده توسط کاربر هدایت می‌کند. همان رفتار آزمایش اتصال اعمال می‌شود.

داده‌های ارسالی: کلید API، نام مدل و پرامپت‌ها که توسط SDK کلاینت هوش مصنوعی وردپرس یا قابلیت آزمایش اتصال تعیین می‌شوند.
زمان: تنها زمانی که مدیر به‌صورت دستی روی “آزمایش اتصال” کلیک کند، یا هنگامی که SDK کلاینت هوش مصنوعی وردپرس درخواست‌های تولید را از طریق ارائه‌دهنده ثبت‌شده ارسال کند.

شرایط خدمات و سیاست حریم خصوصی به سرویس شخص ثالث خاصی که توسط مدیر سایت پیکربندی شده است، بستگی دارد.