Блог для арбитражников · API‑интеграция

API‑генератор креативов для арбитража: как подключить ArbiterAI к своим связкам

Если ты уже протестировал live‑генератор на главной ArbiterAI, следующий логичный шаг — подключить API и генерировать креативы прямо из своих связок, ботов или внутренних тулов. В этой статье разбираем, как работает метод /v1/generate_creatives, какие параметры он принимает и как использовать JSON‑ответ в коде.

🔥 Протестировать генератор на сайте Получить тарифы на API

Нужен API‑ключ или помощь с интеграцией? Пиши в Telegram @arbiter_ai.

Что делает API‑генератор креативов

Цель API простая: по запросу с параметрами vertical, geo, style и language сервис возвращает набор заголовков и описаний в JSON‑формате. Это позволяет автоматизировать подготовку креативов и встроить генерацию прямо в пайплайн запуска кампаний.

Вместо того чтобы вручную собирать варианты в таблицах, можно одним запросом получить пачку текстов под нужную вертикаль (gambling, dating, nutra и т.д.), конкретный GEO и тональность (hard/soft), а дальше уже автоматически комбинировать их в скриптах.

Эндпоинт /v1/generate_creatives

Базовый вызов API выглядит так:

POST https://api.arbiterai.ru/v1/generate_creatives Headers: X-API-Key: YOUR_API_KEY Content-Type: application/json Body: { "vertical": "gambling", "geo": "EU", "style": "hard", "language": "ru" }

В этом примере запрашиваются креативы под gambling‑трафик для европейского GEO в более агрессивном стиле hard на русском языке. Аналогично можно указывать другие вертикали и настройки.

Параметры vertical / geo / style / language

Основные управляющие параметры запроса:

vertical — вертикаль оффера: "gambling", "dating", "nutra", "finance" и т.п.
geo — регион/рынок: "RU", "EU", "US" и другие поддерживаемые значения.
style — тональность текстов: "hard" (более агрессивный подход) или "soft" (аккуратные формулировки).
language — язык креативов: "ru", "en" и т.д.

За счёт комбинации этих четырёх параметров можно получать разные наборы текстов под один и тот же оффер: например, агрессивный hard‑подход для части источников и более мягкий soft для сеток с жёсткой модерацией.

Пример JSON‑ответа

Ответ приходит в формате JSON с двумя основными массивами: titles и descriptions.

{ "titles": [ "Выиграй большое с бонусом в €100", "Джекпоты ждут — играй сейчас", "100 бесплатных вращений СЕЙЧАС", "Быстрые выплаты без ограничений", "Эксклюзив для новых игроков" ], "descriptions": [ "Получите €100 бонус и начните играть в топовые слоты. Депозит сегодня — быстрые выплаты через популярные платёжные системы.", "Запустите барабаны и сорвите джекпот. Приветственный бонус для новых игроков доступен прямо сейчас.", "Активируйте 100 бесплатных вращений и протестируйте слоты без риска. Дальше играете уже на реальные выигрыши.", "Казино с быстрыми выводами и проверенными провайдерами. Регистрируйтесь, забирайте бонус и начинайте игру.", "Специальное предложение для новых игроков: повышенный бонус на первый депозит и доступ к эксклюзивным акциям." ] }

Дальше можно либо брать заголовки и описания парами, либо комбинировать их между собой, формируя десятки вариантов объявлений для A/B‑тестов.

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

Пример на 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 ArbiterAI в арбитражных связках может выглядеть так:

Выбираешь оффер и вертикаль (например, gambling EU или dating RU).
Скрипт делает запрос к /v1/generate_creatives и получает несколько наборов заголовков и описаний.
Креативы раскладываются по шаблонам объявлений для разных сетей и форматов.
Запускаются A/B‑тесты, а статистика по CTR/CR помогает выбирать удачные связки.
По мере выгорания текстов скрипт просто запрашивает новую партию с теми же параметрами.

В итоге генерация перестаёт быть узким местом: на подготовку креативов уходит не часы, а минуты, а арбитражник концентрируется на тестах и масштабировании.

FAQ по интеграции API‑генератора

Где взять API‑ключ для ArbiterAI?

Ключ можно получить через форму на главной или написав в Telegram @arbiter_ai. После выдачи ключа ты сможешь вызывать защищённые методы API и следить за расходом квоты.

Есть ли ограничение на количество запросов?

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

Можно ли вызывать API из бота или прокси‑скрипта?

Да, API‑ключ подходит и для серверных скриптов, и для Telegram‑ботов, и для внутренних инструментов. Главное — не светить ключ на фронтенде и хранить его в конфигурации сервера или бота.

Что делать, если нужен кастомный формат ответа?

Базовый формат — списки заголовков и описаний. Если тебе нужны более сложные структуры (например, дополнительные поля, UTM‑метки или шаблоны под конкретную сеть), можно обсудить это отдельно через Telegram @arbiter_ai.

Выбрать тариф и получить API‑ключ Обсудить интеграцию в связки