Премини към основното съдържание
Български— Изберете език
Меню

Активиране на X Search в API

Урок 8 от 16 Обновен 30 юли 2026 г. Програмист
На тази страница
  1. Достъп до данни от X в реално време
  2. Възможности на X Search
  3. Основно активиране
  4. Активиране чрез SDK
  5. Комбиниране на X Search и Web Search
  6. Основни разлики спрямо Web Search
  7. Ключови изводи

Достъп до данни от X в реално време

X Search е уникален вграден инструмент, специфичен за Grok API. Той позволява на модела да търси публикации, профили и дискусии в X (бившия Twitter) в реално време. Това осигурява на Grok значително конкурентно предимство спрямо другите API за езикови модели, които обикновено нямат директен достъп до социалните мрежи.

𝕏
Native search
10
Filterable handles
🎥
Video supported
$5
/ 1,000 calls

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()]

Можете да активирате двата инструмента едновременно, за да може моделът да кръстосва информация от уеб мрежата и социалните мрежи:

{
  "tools": [
    {"type": "web_search"},
    {"type": "x_search"}
  ]
}

Моделът решава кой от тях да използва – или и двата – въз основа на зададения въпрос. Въпросите относно общественото мнение облагодетелстват X Search, докато фактологичните въпроси предпочитат Web Search.

ФункцияWeb SearchX Search
ИзточникЦялата уеб мрежаСамо X/Twitter
ФилтриранеПо домейн (макс. 5)По потребителско име (макс. 10)
ДатиНедостъпниfrom_date / to_date
Изображенияenable_image_understandingenable_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 за кръстосана проверка на информацията
  • Поддържа разбиране на изображения и видеоклипове (ексклузивно)