AI API и инструкции для нейросетей
Найдите существующие радиостанции, проверьте их ID и создайте персональную подборку с подтверждённой ссылкой.
Используйте API Radio Online, чтобы находить только реальные радиостанции из каталога, фильтровать их по стране, жанру, языку и городу и создавать готовые персональные подборки для пользователя.
Промпт для нейросети
Опишите, какую подборку хотите получить. Конструктор сам добавит правила работы с Radio Online, API, проверку реальных ID и метку нейросети для статистики.
utm_source=chatgpt.com, а POST-запрос — ai_provider: chatgpt.com и learning_query с исходным запросом пользователя.Поиск по смысловым фильтрам
https://radio-online.ru/api/ai/search?country=Россия&genre=Новости&limit=10
https://radio-online.ru/api/ai/search?country=Belarus&genre=news&limit=10Каталог и категории
https://radio-online.ru/api/ai/stations
https://radio-online.ru/api/ai/categoriesСоздать подборку
POST https://radio-online.ru/api/ai/mix
{
"title": "Новости Беларуси",
"description": "Белорусские радиостанции с новостями",
"station_ids": [432, 334, 705],
"ai_provider": "chatgpt.com",
"learning_query": "Новости Беларуси"
}Создать по описанию без POST
https://radio-online.ru/api/ai/generate?prompt=музыка как для ночной прогулки по Сеулу&utm_source=chatgpt.comВнутренний генератор использует только данные Radio Online и не обращается к сторонним AI API.
Если станции уже выбраны
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Инструкция для нейросети
- Ищи подходящие станции через обычный веб-поиск, поиск по radio-online.ru или API. Не ограничивай поиск только API-инструментами.
- Перед добавлением проверь каждую станцию на Radio Online и получи её реальный ID. Для проверки можно использовать страницу станции,
/api/ai/searchили/api/ai/station/{id}. - Не придумывай названия, ID и URL радиостанций.
- Закрытые станции и станции с
getOutCat=1не используй. - Если один способ поиска не дал результата, попробуй другой разумный веб-/сайтовый поиск, не снимая условия пользователя.
- Если можешь выполнять POST, создай подборку через
POST /api/ai/mix, передайai_providerиlearning_queryс исходным запросом без перефразирования. - Если POST недоступен, не прекращай выполнение: после проверки ID открой GET-ссылку
/mix/?ids=...&title=...&description=...&learning_query=...&utm_source=.... Она создаёт и сохраняет подборку. GET /api/ai/generate?prompt=...&utm_source=...используй только как запасной вариант, если самостоятельно подобрать и проверить ID не получилось.- Верни конечную ссылку
/mix/ТОКЕН. - При ответе
429учитывай заголовокRetry-Afterи не повторяй запросы слишком часто.
Дополнительные параметры
category — ID категории, ids — список ID станций, limit — число результатов в пределах серверного лимита, offset — смещение для постраничной выборки.
Подключение как инструмент
Для систем с поддержкой внешних Actions/Tools используйте актуальную OpenAPI-схему. Краткие правила для AI-агентов доступны в llms.txt.
Инструкция для нейросетей и AI-агентов
Выполняйте запрос пользователя целиком: поиск кандидатов, проверка каждой станции, сохранение подборки и возврат подтверждённой ссылки. API Radio Online — инструмент проверки и сохранения, а не единственный способ поиска.
- Учитывайте все условия пользователя. Сохраняйте язык, жанр, страну, город, исполнителей, конкретную радиостанцию и исключения. Не подменяйте узкий запрос более общим только ради заполнения подборки.
- Найдите кандидатов. Используйте обычный веб-поиск, поиск по radio-online.ru и API:
GET /api/ai/searchиGET /api/ai/stations. Если один способ ничего не дал — попробуйте другой, не снимая исходных ограничений. - Подтвердите каждый ID. Откройте страницу станции Radio Online и/или
GET /api/ai/station/{id}. Не выдумывайте названия, ID, URL, категорию, статус или сведения о трансляции. - Отберите подходящие станции. Уберите дубликаты и тематически нерелевантные результаты. Сервер автоматически применяет ограничения каталога при поиске и создании подборок; дополнительные действия AI-агента для этих ограничений не требуются. Максимум — 50 проверенных ID. Наличие страницы станции само по себе не доказывает работоспособность её аудиопотока.
- Создайте подборку по POST, если он доступен. Отправьте
title,description,station_ids(массив проверенных целых ID),ai_providerиlearning_queryнаPOST /api/ai/mix. - Если POST недоступен, используйте существующий GET-способ. Откройте
/mix/?ids=...&title=...&description=...&learning_query=...&utm_source=..., предварительно URL-кодировав все значения. Сама сконструированная строка ещё не подтверждает сохранение. - Если не удалось найти и проверить ID самостоятельно, попробуйте
GET /api/ai/generate?prompt=...&utm_source=.... Этот путь использует внутренний генератор Radio Online; не представляйте его результат как самостоятельно проверенный список. - Предоставьте проверенный результат. После успешного ответа 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": "кавер русских хитов"
}