جستجوی وب

افزونه جستجوی وب در سرویس AI API خاتش به شما اجازه می‌دهد پاسخ مدل‌ها را با داده‌های تازه از وب غنی کنید. این صفحه تمام تنظیمات، فرمت پاسخ و هزینه‌های مربوط به اتصال جستجوی وب در OpenRouterرا به فارسی توضیح می‌دهد.

چرا این افزونه مهم است؟

پوشش به‌روز وب

Realtime

مدل‌های شما به کمک موتورهای بومی یا Exa همیشه به آخرین محتوای آنلاین دسترسی دارند.

ساختار استاندارد

نتایج با قالب واحد پیام‌های OpenAI بازمی‌گردند تا پردازش و استناد آسان باشد.

کنترل کامل موتور

به‌دلخواه میان موتور بومی یا Exa جابه‌جا شوید و هرکدام را مجبور کنید.

هزینه شفاف

تعرفه‌ی دقیق هر موتور و حجم زمینهٔ جستجو به‌صورت شفاف مشخص شده و قابل محاسبه است.

پایه‌گذاری مستقل از مدل

فارغ از اینکه از کدام مدل روی OpenRouter استفاده می‌کنید، می‌توانید با فعال کردن افزونه وب یا افزودن پسوند:online نتایج مرتبط وب را به درخواست خود متصل کنید. این کار مدل را مجبور می‌کند که پاسخ را روی داده‌های تازه‌ای که از وب جمع‌آوری شده است بنا کند.

فعال‌سازی مدل آنلاین

اضافه کردن پسوند :online سریع‌ترین راه برای اجبار مدل به استفاده از افزونه وب است.

online-model.json

{  "model": "openai/gpt-4o:online"}

معادل استفاده از افزونه وب

در صورتی که می‌خواهید کنترل کامل روی افزونه‌ها داشته باشید، ساختار زیر دقیقاً معادل نمونه بالا است.

web-plugin.json

{  "model": "openrouter/auto",  "plugins": [{ "id": "web" }]}

نمونه دوم دقیقاً برابر با فعال‌سازی افزونه وب است و فقط میانبری برای تنظیم سریع به‌شمار می‌آید.

تحلیل نتایج جستجو

نتایج جستجو برای تمام مدل‌ها (حتی مدل‌هایی مثل Perplexity یا حالت آنلاین OpenAI) در قالب استاندارد پیام‌هایOpenAI Chat Completion بازگردانده می‌شوند. هر ارجاع با نوعurl_citation مشخص شده و شامل لینک، عنوان، خلاصه محتوا و محدوده متن است.

web-search-response.json

{  "message": {    "role": "assistant",    "content": "Here's the latest news I found: ...",    "annotations": [      {        "type": "url_citation",        "url_citation": {          "url": "https://www.example.com/web-search-result",          "title": "Title of the web search result",          "content": "Content of the web search result",          "start_index": 100,          "end_index": 200        }      }    ]  }}

سفارشی‌سازی افزونه وب

می‌توانید حداکثر تعداد نتایج و همچنین متنی که قبل از الحاق نتایج در پاسخ شما درج می‌شود را تغییر دهید. پارامتر engine نیز به شما اجازه می‌دهد میان موتور بومی یا Exa انتخاب کنید.

custom-web-plugin.json

{  "model": "openai/gpt-4o:online",  "plugins": [    {      "id": "web",      "engine": "exa",      "max_results": 1,      "search_prompt": "Some relevant web results:"    }  ]}

متن پیش‌فرضی که افزونه وب به پاسخ اضافه می‌کند:default_prompt

default-prompt.md

A web search was run on `date`. Use the search results below to ground your answer in real, verifiable sources.Only use information that is supported by these results, and prefer newer sources when possible.When you reference a result, cite it with a markdown link whose text is the source domain name.Do not invent URLs or sources that are not present in the search results.Example: [nytimes.com](https://nytimes.com/some-page).

انتخاب موتور جستجو

پارامتر engine سه حالت دارد:

native: همیشه از جستجوی بومی ارائه‌دهنده (مانندOpenAI یا Anthropic) استفاده می‌کند.
exa: نتایج را از Exa دریافت می‌کند.
بدون مقدار: ابتدا موتور بومی را امتحان می‌کند و در صورت عدم پشتیبانی بهExa بازمی‌گردد.

اگر موتور را مشخص نکنید، مدل‌هایی که جستجوی بومی دارند همان را به‌صورت پیش‌فرض اجرا می‌کنند و سایر مدل‌ها روی Exa قرار می‌گیرند.

رفتار پیش‌فرض و اجبار موتور

با تعیین صریح موتور می‌توانید رفتار را حتی در مدل‌هایی که موتور بومی دارند تغییر دهید. مثال‌های زیر نحوه اجبار به هر موتور را نشان می‌دهند:

اجبار به موتور بومی

استفاده از مقدار native همیشه تلاش می‌کند موتور ارائه‌دهنده را اجرا کند.

force-native.json

{  "model": "openai/gpt-4o",  "plugins": [    {      "id": "web",      "engine": "native"    }  ]}

اجبار به موتور Exa

با مقدار exa حتی مدل‌های دارای جستجوی بومی از Exa استفاده خواهند کرد.

force-exa.json

{  "model": "openai/gpt-4o",  "plugins": [    {      "id": "web",      "engine": "exa",      "max_results": 3    }  ]}

حجم زمینهٔ جستجو

برخی مدل‌ها هزینه را بر اساس میزان متنی که به‌عنوان «زمینهٔ جستجو» واکشی و بررسی می‌شود محاسبه می‌کنند. می‌توانید پارامترweb_search_options.search_context_size را روی مقادیر «low»، «medium» یا «high» قرار دهید.

search-context.json

{  "model": "openai/gpt-4.1",  "messages": [    {      "role": "user",      "content": "What are the latest developments in quantum computing?"    }  ],  "web_search_options": {    "search_context_size": "high"  }}

Low: داده کم و مناسب پرس‌وجوهای ساده
Medium: توازن میان هزینه و پوشش اطلاعات
High: مناسب پژوهش‌های عمیق و نیازمند جزئیات بیشتر

قیمت‌گذاری

هزینه جستجوی وب بسته به موتور انتخابی متفاوت است. در حالت Exa پرداخت با اعتبارOpenRouter انجام می‌شود و در حالت بومی، هزینه دقیقاً مطابق تعرفه ارائه‌دهنده محاسبه خواهد شد.

هزینه استفاده از Exa: چهار دلار به‌ازای هر ۱۰۰۰ نتیجه. مقدار پیش‌فرض ۵ نتیجه است که حداکثر ۰.۰۲ دلار برای هر درخواست هزینه دارد.

تعرفه مدل‌های OpenAI

مدل	Low	Medium	High
GPT-4.1 / GPT-4o / GPT-4o Search Preview	$30 به‌ازای ۱۰۰۰ درخواست	$35 به‌ازای ۱۰۰۰ درخواست	$50 به‌ازای ۱۰۰۰ درخواست
GPT-4.1-Mini / GPT-4o-Mini / GPT-4o-Mini-Search-Preview	$25 به‌ازای ۱۰۰۰ درخواست	$27.5 به‌ازای ۱۰۰۰ درخواست	$30 به‌ازای ۱۰۰۰ درخواست

تعرفه مدل‌های Perplexity

مدل	Low	Medium	High
Sonar / SonarReasoning	$5 به‌ازای ۱۰۰۰ درخواست	$8 به‌ازای ۱۰۰۰ درخواست	$12 به‌ازای ۱۰۰۰ درخواست
SonarPro / SonarReasoningPro	$6 به‌ازای ۱۰۰۰ درخواست	$10 به‌ازای ۱۰۰۰ درخواست	$14 به‌ازای ۱۰۰۰ درخواست

هنگام استفاده از موتور بومی، هزینه مطابق جدولی است که ارائه‌دهنده برای هر سطح «حجم زمینهٔ جستجو» تعیین کرده است. اگر engine را روی «exa» بگذارید، فقط تعرفه Exa برای نتایج محاسبه می‌شود و هزینه ارائه‌دهنده صرفاً بابت توکن‌های پاسخ خواهد بود.

برای جزئیات بیشتر می‌توانید به صفحات رسمی قیمت‌گذاری OpenAI، Anthropic و Perplexity مراجعه کنید.