HydraAI API - Дополнительные инструменты с широким функционалом [ИНСТРУКЦИЯ]

Расширяем возможности нашего HydraAI API! Теперь доступны новые инструменты для поиска и извлечения данных.

Важно:

Все эндпоинты требуют авторизации (передача вашего API-ключа в заголовке Authorization: Bearer ВАШ_API_KEY).
Лимиты и баланс для этих инструментов используются те же, что и для ваших запросов к нейросетям.
Все запросы отправляются методом POST с телом в формате JSON.
Информация о фактической стоимости каждого запроса и времени выполнения будет отображаться в usage ответа.
Цены пока являются ориентировочными и могут быть изменены. Так же возможны различные сбои и неполадки так как Инструменты находятся в тестовом состоянии!

Базовые тарифы:

ПОИСК: 0.02 руб.
ПОИСК_НОВОСТЕЙ: 0.02 руб.
ПОИСК_ИЗОБРАЖЕНИЙ: 0.02 руб.
КРАУЛИНГ: 0.02 руб.

Полезные ссылки

🌐 1. Поиск информации (Search)

Позволяет выполнять поиск в различных системах с опциональным извлечением полного контента найденных страниц и его очисткой.

Конечная точка: POST /v1/search

Расчет стоимости:

Стоимость запроса = ПОИСК + (количество успешно обработанных страниц для crawl_results * КРАУЛИНГ).

Пример 1: Запрос с query="что-то" и crawl_results=0. Стоимость = 0.02 руб.
Пример 2: Запрос с query="что-то", max_results=5, crawl_results=2. Если контент успешно извлечен с 2 страниц, стоимость = 0.02 руб. (за поиск) + (2 * 0.02 руб.) (за краулинг) = 0.06 руб.

Параметры запроса:

query (str, обязательный, длина от 3 до 250 символов): Ваш поисковый запрос.
search_service (str, необязательный, по умолчанию: "google"): Поисковая система. Доступные значения: "google", "bing", "duckduckgo".
max_results (int, необязательный, по умолчанию: 5, от 1 до 10): Количество результатов, которые вы хотите получить.
crawl_results (int, необязательный, по умолчанию: 0, от 0 до 10): Количество результатов из max_results, с которых нужно дополнительно извлечь полный контент страницы. Каждая успешно обработанная страница для краулинга будет тарифицироваться дополнительно.
language (str, необязательный): Предпочтительный язык для результатов поиска (например, "ru", "en"). Использует стандартные коды языков.
time_range (str, необязательный): Ограничить результаты поиска определенным диапазоном времени. Доступные значения: "day", "month", "year".
content_clearing (bool, необязательный, по умолчанию: true): Очищать ли контент (удалять разметку, лишние переносы) для результатов, где он извлекается (при crawl_results > 0).

Пример запроса:

<JSON>

{
    "query": "Что такое API?",
    "search_service": "google",
    "language": "ru",
    "max_results": 3,
    "crawl_results": 1,
    "content_clearing": true
}

Ответ: Список найденных результатов (title, link, snippet, content для скрауленных страниц) и информация об использовании (usage).

📰 2. Поиск новостей (News Search)

Специализированный поиск по новостным источникам.

Конечная точка: POST /v1/search/news

Расчет стоимости:

Стоимость запроса = ПОИСК_НОВОСТЕЙ + (количество успешно обработанных страниц для crawl_results * КРАУЛИНГ).

Пример 1: Запрос с query="новости" и crawl_results=0. Стоимость = 0.02 руб.
Пример 2: Запрос с query="новости", max_results=3, crawl_results=1. Если контент успешно извлечен с 1 страницы, стоимость = 0.02 руб. (за поиск новостей) + (1 * 0.02 руб.) (за краулинг) = 0.04 руб.

Параметры запроса:

query (str, обязательный, длина от 3 до 250 символов): Запрос для поиска новостей.
search_service (str, необязательный, по умолчанию: "google"): Новостной сервис. Доступные значения: "google", "bing", "duckduckgo".
max_results (int, необязательный, по умолчанию: 5, от 1 до 10): Количество новостей.
crawl_results (int, необязательный, по умолчанию: 0, от 0 до 10): Количество новостей, с которых нужно извлечь полный контент. Каждая успешно обработанная страница для краулинга будет тарифицироваться дополнительно.
language (str, необязательный): Предпочтительный язык новостей (например, "en", "ru").
time_range (str, необязательный): Временной диапазон новостей. Доступные значения: "day", "month", "year".
content_clearing (bool, необязательный, по умолчанию: true): Очищать ли контент извлеченных новостей.

Пример запроса:

<JSON>

{
    "query": "Технологические стартапы 2025",
    "search_service": "google",
    "max_results": 3,
    "crawl_results": 1,
    "language": "ru",
    "time_range": "month"
}

Ответ: Список найденных новостей (аналогично обычному поиску) и информация об использовании.

🖼️ 3. Поиск изображений (Image Search)

Позволяет находить изображения по ключевым словам с различными фильтрами.

Конечная точка: POST /v1/search/images

Стоимость: ПОИСК_ИЗОБРАЖЕНИЙ (0.02 руб.) за каждый запрос.

Параметры запроса:

keywords (str, обязательный, длина от 3 до 250 символов): Ключевые слова для поиска изображений.
safesearch (str, необязательный, по умолчанию: "moderate"): Уровень безопасного поиска. Доступные значения: "on", "moderate", "off".
timelimit (str, необязательный): Ограничение по времени публикации. Доступные значения: "Day", "Week", "Month", "Year".
size (str, необязательный): Размер изображения. Доступные значения: "Small", "Medium", "Large", "Wallpaper".
color (str, необязательный): Цветовая гамма изображения. Доступные значения: "color", "Monochrome", "Red", "Orange", "Yellow", "Green", "Blue", "Purple", "Pink", "Brown", "Black", "Gray", "Teal", "White".
type_image (str, необязательный): Тип изображения. Доступные значения: "photo", "clipart", "gif", "transparent", "line".
layout (str, необязательный): Компоновка изображения. Доступные значения: "Square", "Tall", "Wide".
max_results (int, необязательный, по умолчанию: 10, от 1 до 100): Максимальное количество результатов.

Пример запроса:

<JSON>

{
    "keywords": "ночной город огни",
    "safesearch": "moderate",
    "max_results": 5,
    "size": "Large",
    "color": "Blue"
}

Ответ: Список найденных изображений (title, image (URL), thumbnail (URL), url (страница-источник), height, width, source) и информация об использовании.

📄 4. Извлечение контента страницы (Crawl)

Получает и (опционально) очищает основной контент веб-страницы по её URL.

Конечная точка: POST /v1/crawl

Стоимость: CRAWL_PRICE (0.02 руб.) за каждый успешный запрос на извлечение контента с одной страницы.

Параметры запроса:

url (str, обязательный): URL-адрес страницы, с которой нужно получить контент. Должен быть валидным URL (например, https://example.com/article).
content_clearing (bool, необязательный, по умолчанию: true): Очищать ли контент (удалять разметку, лишние переносы строк и т.д.).

Пример запроса:

<JSON>

{
    "url": "https://example.com/some-article-to-read",
    "content_clearing": true
}

Ответ: Извлеченный контент (title, link (исходный URL), content) и информация об использовании. Поле results может быть null в случае ошибки.

Полезные ссылки

Function в HydraAi API — поддержка всеми моделями нейросетей

HydraAI API - Дополнительные инструменты с широким функционалом [ИНСТРУКЦИЯ]

Важно:

Базовые тарифы:

Полезные ссылки

🌐 1. Поиск информации (Search)

📰 2. Поиск новостей (News Search)

🖼️ 3. Поиск изображений (Image Search)

📄 4. Извлечение контента страницы (Crawl)

Полезные ссылки

Report Page