رفتن به محتوا

اتصال وردپرس به API هوش مصنوعی؛ با افزونه یا چند خط کد PHP

وردپرس را به API هوش مصنوعی هیبانا وصل کنید؛ با افزونهٔ AI Engine یا یک تابع PHP آزموده‌شده، همراه خلاصهٔ خودکار نوشته‌ها و رفع خطای cURL error 28.

مهدی سهندی۵ دقیقه مطالعه
صفحهٔ یک وب‌سایت روی نمایشگر لپ‌تاپ که با سیمی نرم به یک ابر کوچک متصل است و از آن جرقه‌های کوچک نور به صفحه برمی‌گردد

نوشتن خلاصهٔ نوشته‌ها، پیشنهاد عنوان، نوشتن توضیح محصول در ووکامرس یا ساخت یک دستیار پاسخ‌گو در سایت: همهٔ این‌ها با وصل کردن وردپرس به یک API هوش مصنوعی شدنی است. در این مطلب دو راه را قدم‌به‌قدم می‌رویم: افزونهٔ AI Engine با تنظیم یک آدرس سفارشی، و یک تابع کوتاه PHP بدون هیچ افزونه‌ای. بعد یک کار واقعی، یعنی خلاصهٔ خودکار نوشته‌ها، را می‌سازیم و رایج‌ترین خطای این اتصال را رفع می‌کنیم. همه را روی وردپرس ۷٫۱٫۳ و API واقعی هیبانا آزموده‌ایم و خروجی‌ها و هزینه‌ها واقعی‌اند.

پیش از شروع

API هیبانا با OpenAI سازگار است: نشانی پایه https://api-ai.hibanacloud.ir/v1 است و هر ابزاری که اجازه می‌دهد نشانی OpenAI را عوض کنید، با یک کلید هیبانا به همهٔ مدل‌های لیست مدل‌ها وصل می‌شود. اگر با خود API آشنا نیستید، اول راهنمای API هوش مصنوعی را بخوانید. برای این مطلب لازم دارید:

  • یک کلید API و کمی موجودی در کیف پول؛
  • دسترسی مدیر به وردپرس، و برای راه دوم دسترسی به فایل‌های سایت.

پیشنهاد ما این است که برای سایت یک کلید جداگانه بسازید تا هزینهٔ سایت از کارهای دیگرتان جدا بماند و اگر کلید فاش شد، فقط همان را حذف کنید.

راه اول؛ افزونهٔ AI Engine

AI Engine افزونهٔ هوش مصنوعی‌ای است که طبق مخزن رسمی وردپرس بیش از ۹۰ هزار نصب فعال دارد. نسخهٔ ۳٫۹٫۴ آن نوعی محیط به نام «Custom (OpenAI-Compatible)» دارد که می‌توان آن را به هر سرویس سازگار با OpenAI وصل کرد. مراحل:

  1. افزونه را نصب و فعال کنید.
  2. در تنظیمات AI Engine به بخش Environments for AI بروید و یک محیط تازه بسازید.
  3. نوع محیط را Custom (OpenAI-Compatible) بگذارید.
  4. در فیلد Endpoint نشانی https://api-ai.hibanacloud.ir/v1 را بنویسید و در API Key کلید هیبانا را.
  5. روی Refresh Models بزنید تا فهرست مدل‌ها از هیبانا خوانده شود.

در آزمایش ما فهرست ۱۰۹ مدل خوانده شد. نام مدل‌ها همان کدهای هیبانا است، مثل openai/gpt-5-nano. بعد از ساخت محیط، با تابع PHP خود افزونه یک سؤال پرسیدیم:

global $mwai;echo $mwai->simpleTextQuery( 'در یک جمله بگو وردپرس چیست.', array(    'envId' => 'hibana',    'model' => 'openai/gpt-5-nano',) );

hibana شناسه‌ای است که ما به محیط دادیم. پاسخ حدود ۱۰ ثانیه بعد رسید:

وردپرس یک سیستم مدیریت محتوا (CMS) رایگان و متن‌باز است که با PHP و MySQL ساخته شده و به شما امکان می‌دهد وب‌سایت یا وبلاگ خود را به‌راحتی ایجاد، مدیریت و سفارشی‌سازی کنید.

از اینجا به بعد چت‌بات، ابزار نوشتن و بقیهٔ قابلیت‌های AI Engine را می‌توانید با همین محیط و مدل‌های هیبانا به کار ببرید. یک نکته: AI Engine برای مدل‌هایی که خودش نمی‌شناسد، سقف خروجی را ۴٬۰۹۶ توکن ثبت کرد. اگر متن‌های بلند لازم دارید، این سقف را در نظر داشته باشید.

راه دوم؛ چند خط PHP، بدون افزونه

اگر فقط یک کار مشخص دارید، لازم نیست افزونهٔ بزرگی نصب کنید. اول کلید را در wp-config.php تعریف کنید، نه در دیتابیس یا فایل قالب:

define( 'HIBANA_API_KEY', 'YOUR_API_KEY' );

بعد این فایل را در wp-content/mu-plugins/hibana-ai.php بگذارید. اگر پوشهٔ mu-plugins وجود ندارد، آن را بسازید. افزونه‌های این پوشه همیشه فعال‌اند و با عوض شدن قالب از بین نمی‌روند:

<?php/** * Plugin Name: Hibana AI (helper) */ function hibana_ask( string $prompt, string $model = 'openai/gpt-5-nano' ) {    $response = wp_remote_post( 'https://api-ai.hibanacloud.ir/v1/chat/completions', array(        'timeout' => 60,        'headers' => array(            'Authorization' => 'Bearer ' . HIBANA_API_KEY,            'Content-Type'  => 'application/json',        ),        'body'    => wp_json_encode( array(            'model'    => $model,            'messages' => array(                array( 'role' => 'user', 'content' => $prompt ),            ),        ) ),    ) );     if ( is_wp_error( $response ) ) {        return $response;    }     $code = wp_remote_retrieve_response_code( $response );    $data = json_decode( wp_remote_retrieve_body( $response ), true );     if ( 200 !== $code ) {        return new WP_Error( 'hibana_api', $data['error']['message'] ?? 'HTTP ' . $code );    }     return $data['choices'][0]['message']['content'];}

حالا هر جای سایت می‌توانید hibana_ask() را صدا بزنید. آزمایش ما:

$answer = hibana_ask( 'در یک جمله بگو افزونهٔ وردپرس چیست.' );echo is_wp_error( $answer ) ? $answer->get_error_message() : $answer;
افزونهٔ وردپرس یک ماژول نرم‌افزاری است که امکانات و قابلیت‌های جدیدی به وب‌سایت وردپرس اضافه می‌کند و معمولاً بدون دستکاری در هستهٔ اصلی وردپرس کار می‌کند.

این درخواست ۴٫۶ ثانیه طول کشید. تابع خطا را به‌شکل WP_Error برمی‌گرداند؛ پس همیشه با is_wp_error() بررسی کنید. معنی خطاهایی مثل ۴۰۱ و ۴۰۲ را در راهنمای خطاهای ۴۰۱، ۴۰۲ و ۴۲۹ توضیح داده‌ایم.

مثال کاربردی؛ خلاصهٔ خودکار نوشته‌ها

با همین تابع، خلاصهٔ یک نوشته را می‌سازیم و در فیلد «چکیده» (excerpt) ذخیره می‌کنیم. $post_id شمارهٔ نوشتهٔ شماست:

$text    = wp_strip_all_tags( get_post_field( 'post_content', $post_id ) );$summary = hibana_ask( "این نوشته را در حداکثر دو جمله خلاصه کن:\n\n" . $text ); if ( ! is_wp_error( $summary ) ) {    wp_update_post( array( 'ID' => $post_id, 'post_excerpt' => $summary ) );}

ما آن را روی یک نوشتهٔ ۴۵۵ کاراکتری دربارهٔ راه‌اندازی فروشگاه با ووکامرس اجرا کردیم و این چکیده ذخیره شد:

برای راه‌اندازی فروشگاه اینترنتی با وردپرس، ابتدا هاست و دامنه تهیه کرده، سپس وردپرس را نصب و افزونه ووکامرس را فعال کنید تا محصولات، سبد خرید و سفارش‌ها مدیریت شوند و درگاه پرداخت از طریق همان افزونه متصل گردد. برای سرعت، تصاویر محصولات را فشرده کنید و افزونه‌های غیرضروری را نصب نکنید و در پایان صفحات قوانین بازگشت کالا و ارسال را بنویسید تا مشتریان با اطمینان خرید کنند.

هزینهٔ این درخواست ۱٬۲۸۰ ریال بود: ۱۵۷ توکن ورودی و ۶۳۱ توکن خروجی. با اینکه پاسخ دو جمله بود، توکن‌های خروجی زیاد شدند، چون این مدل پیش از پاسخ «فکر» می‌کند و آن توکن‌ها هم حساب می‌شوند. منطق کلی را در توکن چیست و هزینهٔ API چطور حساب می‌شود خوانده‌اید. قیمت به‌روز را در صفحهٔ GPT-5 nano ببینید.

متن تولیدشده را پیش از انتشار بخوانید. در همین نمونه مدل دو جمله نوشت، اما جمله‌ها برای چکیده بیش از حد بلندند؛ اگر متن کوتاه‌تر می‌خواهید، سقف را با تعداد کلمه بدهید.

خطای cURL error 28؛ مهم‌ترین تنظیم

مهلت پیش‌فرض wp_remote_post پنج ثانیه است، اما پاسخ مدل‌های هوش مصنوعی، به‌ویژه برای متن‌های بلند، اغلب بیشتر طول می‌کشد. همان درخواست را بدون 'timeout' => 60 و با خواستن یک متن ۳۰۰ کلمه‌ای فرستادیم:

Error: cURL error 28: Operation timed out after 5001 milliseconds with 0 bytes received

راه‌حل همان 'timeout' => 60 در تابع بالاست. اما مهلت طولانی یعنی کاربر هم منتظر می‌ماند؛ پس کارهای سنگین، مثل خلاصه کردن صدها نوشته، را هنگام بارگذاری صفحه انجام ندهید و آن‌ها را با WP-Cron یا یک فرمان WP-CLI در پس‌زمینه اجرا کنید. پیش از کار دسته‌ای، محدودیت نرخ درخواست را هم ببینید.

هوش مصنوعی خود وردپرس ۷ چه؟

وردپرس از نسخهٔ ۷٫۰ یک کلاینت هوش مصنوعی در هسته دارد و صفحهٔ Connectors به بخش تنظیمات پیشخوان اضافه شده است. در این صفحه OpenAI، Anthropic و Google فهرست شده‌اند، اما هر کدام به افزونهٔ ارائه‌دهندهٔ جداگانه‌ای نیاز دارد. افزونهٔ رسمی «AI Provider for OpenAI» از تیم هوش مصنوعی وردپرس، در نسخهٔ ۱٫۲٫۰، نشانی api.openai.com را ثابت در کد دارد و جایی برای تغییر آن ندارد؛ پس فعلاً نمی‌شود آن را به هیبانا وصل کرد. هستهٔ وردپرس ابزارهای لازم برای نوشتن یک ارائه‌دهندهٔ سازگار با OpenAI را دارد، اما ما چنین افزونه‌ای را نیازموده‌ایم. تا آن زمان، دو راه بالا مطمئن‌ترند.

نکته‌های امنیت و هزینه

  • کلید فقط در سمت سرور: کلید را هرگز در جاوااسکریپت یا HTML صفحه نگذارید. هر کسی که صفحه را باز کند، آن را می‌بیند.
  • محل نگهداری کلید: در راه دوم کلید در wp-config.php است. AI Engine کلید را در دیتابیس سایت نگه می‌دارد؛ پس دسترسی مدیر سایت را محدود نگه دارید.
  • ورودی کاربر: اگر متن کاربران را به مدل می‌فرستید، طول آن را محدود کنید تا یک نفر نتواند با متن خیلی بلند هزینهٔ زیادی بسازد.
  • قطعی اینترنت بین‌الملل: بیشتر مدل‌ها روی سرورهای خارج از ایران اجرا می‌شوند. برای آن روزها استفاده از API هوش مصنوعی بدون VPN را بخوانید.

جمع‌بندی

برای وصل کردن وردپرس به هوش مصنوعی، اگر امکانات آماده می‌خواهید، AI Engine را با محیط «Custom (OpenAI-Compatible)» و نشانی هیبانا تنظیم کنید. اگر یک کار مشخص دارید، همان تابع کوتاه hibana_ask() کافی است. در هر دو حالت مهلت درخواست را بلند بگذارید، کارهای سنگین را به پس‌زمینه بسپارید و خروجی را پیش از انتشار بخوانید. برای شروع، کلید API بگیرید و اگر می‌خواهید برای سایت یک دستیار پاسخ‌گو بسازید، ساخت چت‌بات سایت و ربات بله را بخوانید.

مطالب مرتبط

پروتکل MCP چیست؛ اتصال ابزارها و داده‌ها به مدل‌های هوش مصنوعی

پروتکل MCP به زبان ساده؛ میزبان، کلاینت و سرور چه می‌کنند، کدام ابزارها از آن پشتیبانی می‌کنند و چطور با مدل‌های هیبانا یک سرور MCP را به کار بگیرید.

کدام ایجنت کدنویسی با API ایرانی کار می‌کند؟ Kilo Code و Cline و Cursor

مقایسهٔ عملی Kilo Code و Cline و Cursor برای اتصال به API هوش مصنوعی از ایران؛ کدام کار می‌کند، چرا Cline توکن زیادی مصرف می‌کند و کدام مدل را انتخاب کنیم.

با یک کلید به همه مدل‌ها وصل شوید

GPT، Claude، Gemini و ده‌ها مدل دیگر، با پرداخت ریالی و یک API سازگار با OpenAI.