100 Нотв подарок
Для нейросетей и AI-агентов

AI API и инструкции для нейросетей

Найдите существующие радиостанции, проверьте их ID и создайте персональную подборку с подтверждённой ссылкой.

Используйте API Radio Online, чтобы находить только реальные радиостанции из каталога, фильтровать их по стране, жанру, языку и городу и создавать готовые персональные подборки для пользователя.

Промпт для нейросети

Опишите, какую подборку хотите получить. Конструктор сам добавит правила работы с Radio Online, API, проверку реальных ID и метку нейросети для статистики.

GET

Поиск по смысловым фильтрам

https://radio-online.ru/api/ai/search?country=Россия&genre=Новости&limit=10 https://radio-online.ru/api/ai/search?country=Belarus&genre=news&limit=10
GET

Каталог и категории

https://radio-online.ru/api/ai/stations https://radio-online.ru/api/ai/categories
POST

Создать подборку

POST https://radio-online.ru/api/ai/mix { "title": "Новости Беларуси", "description": "Белорусские радиостанции с новостями", "station_ids": [432, 334, 705], "ai_provider": "chatgpt.com", "learning_query": "Новости Беларуси" }
GET AI

Создать по описанию без POST

https://radio-online.ru/api/ai/generate?prompt=музыка как для ночной прогулки по Сеулу&utm_source=chatgpt.com

Внутренний генератор использует только данные Radio Online и не обращается к сторонним AI API.

GET fallback

Если станции уже выбраны

https://radio-online.ru/mix/?ids=432,334,705&title=Новости Беларуси&description=Белорусские радиостанции с новостями&learning_query=Новости Беларуси&utm_source=chatgpt.com

Как искать радиостанции

Фильтры можно комбинировать в одном запросе. Предпочитайте человекочитаемые параметры и не угадывайте ID категорий.

country

Страна или распространённый код: Россия, Russia, RU, Беларусь, Belarus, BY.

genre

Жанр или понятный алиас: Новости, news, Рок, rock, Джаз, jazz.

lang / language

Язык или код: ru, Русский, be, Беларуская, kk, en.

city

Город, например Москва, Минск, Алматы.

category_name

Человекочитаемое название категории DLE, когда нужна конкретная категория сайта.

q

Свободный текст: точное/частичное название станции или категории, ручные алиасы и русские варианты произношения. Например Камеди может найти Comedy Club Радио.

https://radio-online.ru/api/ai/search?country=Беларусь&genre=Новости&language=ru&limit=10 https://radio-online.ru/api/ai/search?city=Москва&genre=rock&limit=10

Инструкция для нейросети

  1. Ищи подходящие станции через обычный веб-поиск, поиск по radio-online.ru или API. Не ограничивай поиск только API-инструментами.
  2. Перед добавлением проверь каждую станцию на Radio Online и получи её реальный ID. Для проверки можно использовать страницу станции, /api/ai/search или /api/ai/station/{id}.
  3. Не придумывай названия, ID и URL радиостанций.
  4. Закрытые станции и станции с getOutCat=1 не используй.
  5. Если один способ поиска не дал результата, попробуй другой разумный веб-/сайтовый поиск, не снимая условия пользователя.
  6. Если можешь выполнять POST, создай подборку через POST /api/ai/mix, передай ai_provider и learning_query с исходным запросом без перефразирования.
  7. Если POST недоступен, не прекращай выполнение: после проверки ID открой GET-ссылку /mix/?ids=...&title=...&description=...&learning_query=...&utm_source=.... Она создаёт и сохраняет подборку.
  8. GET /api/ai/generate?prompt=...&utm_source=... используй только как запасной вариант, если самостоятельно подобрать и проверить ID не получилось.
  9. Верни конечную ссылку /mix/ТОКЕН.
  10. При ответе 429 учитывай заголовок Retry-After и не повторяй запросы слишком часто.

Дополнительные параметры

category — ID категории, ids — список ID станций, limit — число результатов в пределах серверного лимита, offset — смещение для постраничной выборки.

Подключение как инструмент

Для систем с поддержкой внешних Actions/Tools используйте актуальную OpenAPI-схему. Краткие правила для AI-агентов доступны в llms.txt.

Обязательные правила работы

Инструкция для нейросетей и AI-агентов

Выполняйте запрос пользователя целиком: поиск кандидатов, проверка каждой станции, сохранение подборки и возврат подтверждённой ссылки. API Radio Online — инструмент проверки и сохранения, а не единственный способ поиска.

  1. Учитывайте все условия пользователя. Сохраняйте язык, жанр, страну, город, исполнителей, конкретную радиостанцию и исключения. Не подменяйте узкий запрос более общим только ради заполнения подборки.
  2. Найдите кандидатов. Используйте обычный веб-поиск, поиск по radio-online.ru и API: GET /api/ai/search и GET /api/ai/stations. Если один способ ничего не дал — попробуйте другой, не снимая исходных ограничений.
  3. Подтвердите каждый ID. Откройте страницу станции Radio Online и/или GET /api/ai/station/{id}. Не выдумывайте названия, ID, URL, категорию, статус или сведения о трансляции.
  4. Отберите подходящие станции. Уберите дубликаты и тематически нерелевантные результаты. Сервер автоматически применяет ограничения каталога при поиске и создании подборок; дополнительные действия AI-агента для этих ограничений не требуются. Максимум — 50 проверенных ID. Наличие страницы станции само по себе не доказывает работоспособность её аудиопотока.
  5. Создайте подборку по POST, если он доступен. Отправьте title, description, station_ids (массив проверенных целых ID), ai_provider и learning_query на POST /api/ai/mix.
  6. Если POST недоступен, используйте существующий GET-способ. Откройте /mix/?ids=...&title=...&description=...&learning_query=...&utm_source=..., предварительно URL-кодировав все значения. Сама сконструированная строка ещё не подтверждает сохранение.
  7. Если не удалось найти и проверить ID самостоятельно, попробуйте GET /api/ai/generate?prompt=...&utm_source=.... Этот путь использует внутренний генератор Radio Online; не представляйте его результат как самостоятельно проверенный список.
  8. Предоставьте проверенный результат. После успешного ответа API либо фактического открытия GET-ссылки верните конечный URL формата https://radio-online.ru/mix/ТОКЕН. Если создать подборку не удалось, объясните причину. Не придумывайте токен, конечный URL или подтверждение сохранения.

Обучение и повторные запросы

learning_query — точная исходная формулировка запроса без перефразирования. ai_provider (POST) или utm_source (GET) — источник обращения, например chatgpt.com. Ранее созданную подборку не копируйте без повторной проверки, если она была признана ошибочной. Не называйте обучение завершённым до подтверждения сохранения сервером.

Поиск и фильтры

Комбинируйте q, country, genre, category_name, lang / language, city. Не угадывайте числовые ID категорий. Человекочитаемые названия и поддерживаемые алиасы предпочтительнее.

Ошибки и недоступность

Нет результатов — уточните запрос и смените способ поиска; 400/422 — исправьте параметры; 401/403 — не обходите ограничения; 404 — перепроверьте ID; 429 — соблюдайте Retry-After; 5xx или тайм-аут — не утверждайте, что подборка сохранена.

Шаблон POST-запроса с пояснениями

Поля ПРОВЕРЕННЫЙ_ID_1 и ПРОВЕРЕННЫЙ_ID_2 — обозначения, а не числовые ID. Перед отправкой замените их реальными целыми ID, проверенными на Radio Online.

POST https://radio-online.ru/api/ai/mix
Content-Type: application/json

{
  "title": "Каверы русских хитов",
  "description": "Русскоязычные кавер-версии известных песен",
  "station_ids": [ПРОВЕРЕННЫЙ_ID_1, ПРОВЕРЕННЫЙ_ID_2],
  "ai_provider": "chatgpt.com",
  "learning_query": "кавер русских хитов"
}