Активиране на X Search в API
На тази страница
Достъп до данни от X в реално време
X Search е уникален вграден инструмент, специфичен за Grok API. Той позволява на модела да търси публикации, профили и дискусии в X (бившия Twitter) в реално време. Това осигурява на Grok значително конкурентно предимство спрямо другите API за езикови модели, които обикновено нямат директен достъп до социалните мрежи.
Възможности на X Search
X Search предлага четири режима на търсене:
- Търсене по ключови думи: откриване на публикации, съдържащи конкретни термини
- Семантично търсене: откриване на публикации, свързани с дадена тема, дори без точното съвпадение на думите
- Търсене на потребители: идентифициране на релевантни профили
- Извличане на нишки: достъп до пълни дискусии
Моделът автоматично избира режима, най-подходящ за заявката на потребителя.
Основно активиране
Активирането работи по същия начин като при Web Search. Добавяте {"type": "x_search"} към масива tools:
{
"model": "grok-4.20-0309-reasoning",
"input": "What are developers saying about the latest React update?",
"tools": [
{"type": "x_search"}
]
}
Моделът автоматично търси в X за релевантни публикации и ги интегрира в своя отговор, включвайки съответните цитати.
Активиране чрез SDK
xAI SDK (Python)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the reactions on X about Grok 4?",
tools=[client.tools.x_search()]
)
OpenAI SDK (Python)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the reactions on X about Grok 4?",
tools=[{"type": "x_search"}]
)
Vercel AI SDK (JavaScript)
tools: [xai.tools.xSearch()]
Комбиниране на X Search и Web Search
Можете да активирате двата инструмента едновременно, за да може моделът да кръстосва информация от уеб мрежата и социалните мрежи:
{
"tools": [
{"type": "web_search"},
{"type": "x_search"}
]
}
Моделът решава кой от тях да използва – или и двата – въз основа на зададения въпрос. Въпросите относно общественото мнение облагодетелстват X Search, докато фактологичните въпроси предпочитат Web Search.
Основни разлики спрямо Web Search
| Функция | Web Search | X Search |
|---|---|---|
| Източник | Цялата уеб мрежа | Само X/Twitter |
| Филтриране | По домейн (макс. 5) | По потребителско име (макс. 10) |
| Дати | Недостъпни | from_date / to_date |
| Изображения | enable_image_understanding | enable_image_understanding |
| Видео | Недостъпно | enable_video_understanding |
| Цена | $5 / 1,000 заявки | $5 / 1,000 заявки |
Разбирането на видеоклипове е ексклузивно за X Search. Тази функция позволява на модела да анализира съдържанието на видеоклипове, публикувани в X.
Цени към 5 август 2026 г. – цените се променят редовно: преди да изчислите какъвто и да е бюджет, проверете актуалната ценова таблица на официалната страница за модели и цени на xAI.
Ключови изводи
- X Search е ексклузивно предимство на Grok API
- Активирането става чрез
{"type": "x_search"}в масиваtools - Четири режима на търсене: ключови думи, семантично, потребители, нишки
- Може да се комбинира с Web Search за кръстосана проверка на информацията
- Поддържа разбиране на изображения и видеоклипове (ексклузивно)