API для арбитражников и команд

Документация API ArbiterAI: креативы и преленды под 30+ вертикалей

ArbiterAI генерирует креативы и переписывает преленды под gambling, betting, dating, nutra, finance, crypto, VPN, SaaS, e‑commerce и десятки других вертикалей. Ниже — параметры, примеры запросов, ответы и подсказки по тому, как выжать максимум ROI из API.

Ключевые запросы: ai креативы для арбитража, генератор креативов для gambling/dating/nutra, api генерации креативов, ai для прелендов
🚀 Быстрый старт: от нуля до первых креативов за 5 минут

1) Проверяешь качество в боте и live‑демо, 2) открываешь Swagger, 3) забираешь API‑ключ и подключаешь генерацию к своим связкам. Один и тот же API подходит и для соло‑арбитражников, и для агентств с десятком байеров.

Совмещай: тестируй идеи в боте, обкатывай связки через API, а лучшие результаты выноси в прод.
📍 Базовые параметры: vertical, geo, style, language

Все методы API крутятся вокруг четырёх полей. Через них настраиваешь, под какую связку и рынок будут генериться тексты.

  • vertical — тематика оффера: "gambling", "dating", "nutra", "crypto", "vpn_proxy" и др.
  • geo — регион: "RU", "EU", "US", "ASIA", "LATAM" и др.
  • style — тонкость и агрессия: "hard" (максимум FOMO, ограничения по модерации) или "soft" (аккуратно и «белее»).
  • language — язык: чаще всего "ru" или "en" (другие по договорённости).
Пример 1 (gambling EU hard ru): { "vertical": "gambling", "geo": "EU", "style": "hard", "language": "ru" } Пример 2 (dating US soft en): { "vertical": "dating", "geo": "US", "style": "soft", "language": "en" }

Совет: заведи у себя таблицу/конфиг пресетов под топ‑вертикали и GEO, чтобы байеры выбирали нужные настройки одним кликом.

📦 Встроенные вертикали и типовые use‑cases

ArbiterAI заточен под арбитраж: промпты и стили отличаются от «общих» моделей и ориентированы на CTR/CR и модерацию.

gambling — казино, слоты, live‑игры
betting — ставки, киберспорт
dating — анкеты, знакомства
nutra — похудение, здоровье
sweepstakes — розыгрыши, give‑away
crypto — биржи, кошельки
finance — займы, карты
forex — трейдинг, CFD
adult — 18+ сервисы
ecommerce — интернет‑магазины
mobile_content — подписки, VAS
mobile_apps — приложения, утилиты
software_saas — SaaS‑сервисы
hosting — хостинг, домены
streaming — кино, VOD
gaming — игры, F2P
travel — туры, билеты
education — курсы, EdTech
vpn_proxy — VPN/прокси
b2b_services — CRM, рассылки

Для каждой вертикали заранее заданы свои фишки: ограничения по обещаниям, локальные триггеры, подход к цифрам, безопасные формулировки под модерацию.

🧠 Пресеты под реальные связки

Готовые строки, которые можно вставить в live‑генератор, бота или разложить по полям в теле API‑запроса.

Сценарий Пресет
Гемблинг под EU, агрессивно gambling EU hard ru
Dating под US, мягко и нативно dating US soft en
Nutra под RU, аккуратный подход nutra RU soft ru
Крипта под EU crypto EU hard en
VPN/прокси под US vpn_proxy US soft en

Расширенный список — в статье «Пресеты запросов для AI‑креативов под топ‑вертикали».

🤖 Telegram‑бот @Arbiter_AI_bot

Самый быстрый способ показать продукт тимлиду или байерам. Те же модели, что и за API, только через удобный интерфейс.

  • Лимит: 100 бесплатных запросов на пользователя.
  • Режимы: генерация креативов и рерайт прелендов.
  • Подходит для теста вертикалей и первичного онбординга команды.
/start → Generate creatives → gambling EU hard ru /start → Rewrite prelend → "текст преленда | nutra RU soft ru"

Когда команда «нащупала» рабочие подходы в боте, эти же пресеты легко перенести в backend через API.

⚡ POST /v1/generate_creatives — генерация креативов

Возвращает массивы titles и descriptions, готовые к загрузке в рекламные кабинеты или внутренние тулзы. Один запрос — пачка креативов под конкретный оффер/рынок.

POST https://api.arbiterai.ru/v1/generate_creatives Headers: X-API-Key: YOUR_API_KEY Content-Type: application/json Body (gambling EU hard ru): { "vertical": "gambling", "geo": "EU", "style": "hard", "language": "ru" }
Усечённый пример ответа: { "titles": [ "Выиграй большое с бонусом в €100", "Джекпоты ждут — играй сейчас", "100 бесплатных вращений СЕЙЧАС", "Быстрые выплаты без ограничений", "Эксклюзив для новых игроков" ], "descriptions": [ "Получите €100 бонус и начните играть в топовые слоты...", "Запустите барабаны и сорвите джекпот...", "Активируйте 100 бесплатных вращений и протестируйте слоты без риска...", "Казино с быстрыми выводами и проверенными провайдерами...", "Специальное предложение для новых игроков..." ] }
✏️ POST /v1/rewrite_prelend — рерайт прелендов

Берёт исходный текст и возвращает несколько переписанных версий под нужный стиль и GEO. Идеально для A/B‑тестов и модерации.

POST https://api.arbiterai.ru/v1/rewrite_prelend Headers: X-API-Key: YOUR_API_KEY Content-Type: application/json Body: { "source_text": "Исходный текст преленда...", "vertical": "dating", "geo": "EU", "style": "soft", "language": "ru", "variants": 3 }

В ответе будет массив variants с несколькими версиями текста, которые можно сразу раскатать по лендингам.

👨‍💻 Примеры интеграции: curl и Python

curl — быстро проверить запрос с сервера или локальной машины.

curl -X POST "https://api.arbiterai.ru/v1/generate_creatives" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "vertical": "dating", "geo": "EU", "style": "soft", "language": "ru" }'

Python — пример простого скрипта под пайплайн:

import requests API_URL = "https://api.arbiterai.ru/v1/generate_creatives" API_KEY = "YOUR_API_KEY" payload = { "vertical": "nutra", "geo": "RU", "style": "hard", "language": "ru" } headers = { "X-API-Key": API_KEY, "Content-Type": "application/json" } resp = requests.post(API_URL, json=payload, headers=headers) data = resp.json() titles = data.get("titles", []) descriptions = data.get("descriptions", []) for t, d in zip(titles, descriptions): print("Title:", t) print("Desc :", d) print("-" * 40)

Дальше этот код можно расширить: писать креативы в БД, CSV или сразу дёргать API рекламной сети.

❌ Статусы и ошибки API

Лимиты считаются по API‑ключу (месячная квота). При каждом успешном запросе счётчик растёт; при превышении вернётся 429.

HTTP‑статус Что значит Что делать
200 Запрос успешен, в теле — JSON с данными. Использовать данные в своих скриптах/связках.
401 Нет или неверный X-API-Key. Проверить ключ, заголовки, окружение.
403 Ключ неактивен или заблокирован. Написать в Telegram @arbiter_ai.
429 Квота месяца выбрана. Обсудить расширение лимита или новый тариф.
422 Ошибка в параметрах (например, неизвестный vertical). Сверить значения с документацией и Swagger.
500 Внутренняя ошибка сервиса. Повторить запрос через пару секунд, если повторяется — написать в поддержку.
🏁 Как максимизировать ROI от API

Несколько практических советов, которые уже показали себя на баерах и командах:

  • Используй AI для черновиков и массовой генерации, а людей — для финальной шлифовки топовых связок.
  • Делай отдельные пресеты под каждую сетку и GEO, чтобы не ловить неожиданные отклонения по модерации.
  • Не жадничай на A/B‑тесты: AI делает дешёвые креативы, поэтому проще отсеять лишнее статистикой.
  • Веди свои «чёрные/белые списки» формулировок и фильтруй тексты перед заливкой.
  • Считай экономию времени: замени 2–4 часа ручного копирайта в день на несколько API‑запросов и посмотри, как меняется маржа.

Хочешь разобрать конкретный кейс (сетка, вертикаль, объёмы) — проще всего сделать это прямо в диалоге в Telegram: @arbiter_ai.