API документация

Интегрируйте AI-генерацию текстов в свои приложения. Доступно на тарифе Про.

Аутентификация

Все запросы к API требуют авторизации через cookie-сессию (NextAuth). Для программного доступа используйте API-ключ в заголовке:

curl -X POST https://aimarketing.ru/api/generate \
  -H "Content-Type: application/json" \
  -H "Cookie: next-auth.session-token=YOUR_SESSION" \
  -d '{
    "template": "ad",
    "topic": "Онлайн-курс по маркетингу",
    "tone": "sales",
    "length": "medium"
  }'

POST /api/generate

Генерация маркетингового текста.

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

Параметр	Тип	Описание
template	string	Тип шаблона (обязательный)
topic	string	Тема / описание продукта (макс. 500 символов)
tone	string	"formal" \| "friendly" \| "sales"
length	string	"short" \| "medium" \| "long"
brandVoiceId	string?	ID голоса бренда (опционально)
variants	number?	Количество вариантов: 1-5 (по умолчанию 1)

Доступные шаблоны

ad— Рекламный текст

headline— Заголовки

slogan— Слоган / Девиз

landing— Текст для лендинга

social— Пост для соцсетей

telegram_post— Пост для Telegram

vk_post— Пост для ВКонтакте

instagram_caption— Подпись Instagram

youtube_description— Описание YouTube

email— Email-рассылка

sms— SMS-рассылка

push_notification— Push-уведомление

product— Описание товара

seo_article— SEO-статья

product_card— Карточка маркетплейса

faq_answer— FAQ / Ответ на вопрос

commercial_offer— Коммерческое предложение

press_release— Пресс-релиз

review_response— Ответ на отзыв

job_description— Описание вакансии

rewrite— Рерайт / Перефразирование

content_plan— Контент-план

Ответ (1 вариант)

При variants=1 возвращается текстовый стрим (Content-Type: text/plain).

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
X-RateLimit-Remaining: 99
X-RateLimit-Limit: 100

Текст генерируется потоково...

Ответ (несколько вариантов)

При variants > 1 возвращается JSON:

{
  "variants": [
    "Вариант 1...",
    "Вариант 2...",
    "Вариант 3..."
  ],
  "remaining": 97
}

Лимиты по тарифам

Тариф	Генераций/день	Вариантов	Brand Voice
Free	1	1	-
Hobby	20	1	-
Старт	100	3	1
Про	Безлимит	5	5

Коды ошибок

Код	Описание
400	Неверные параметры
401	Не авторизован
429	Лимит генераций исчерпан
500	Внутренняя ошибка