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

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

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

Для интеграции через API используйте ключ, созданный в Личном кабинете → API-ключи. Передавайте его в заголовке Authorization:

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

API-ключи доступны на тарифе Про. Endpoint для внешних интеграций: POST /api/webhook/generate

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— Подпись Inst

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
}

Кредиты и лимиты

Каждый API-вызов расходует кредиты. Количество зависит от тарифа и операции:

Тариф	Кредиты/мес	Brand Voice
Free	10 (стартовые)	-
Хобби	300	-
Старт	800	1
Про	2 000	5

Стоимость операций

Операция	Кредиты
Генерация текста, мета-теги, сниппеты	1
SEO-анализ текста, улучшение промпта	1
Изображение (стандарт)	3
Изображение (HD)	5
AI-чат (1-8 сообщений)	2
AI-чат (9+ сообщений)	4
Подбор ключевых слов, скоринг, ТЗ копирайтеру	2
Факт-чекинг	3
GEO-анализ, конкурентный анализ	4
AI Humanizer, AI-маркетолог (7 дней)	5
Контент-воронка	6
AI-маркетолог (14 дней)	8
AI-маркетолог (30 дней)	10
Статья (Article Writer)	1 (план) + 2 за секцию
Воркфлоу	1 за шаг

Burst-лимит: 10 запросов в минуту для всех тарифов. При исчерпании кредитов API вернёт 402.

Другие endpoints

POST /api/generate-image

Генерация изображений (DALL-E 3). Доступно с тарифа Хобби. Стоимость: 3 кредита (standard) / 5 кредитов (HD).

Параметр	Тип	Описание
prompt	string	Описание изображения (макс. 1000 символов)
size	string?	"1024x1024" \| "1024x1792" \| "1792x1024"
quality	string?	"standard" \| "hd"
style	string?	"vivid" \| "natural"

POST /api/generate-article

Генерация длинных SEO-статей (до 5000 слов). Доступно с тарифа Старт.

Параметр	Тип	Описание
topic	string	Тема статьи (обязательно)
keywords	string?	Ключевые слова через запятую
targetLength	number?	1000 \| 2000 \| 3000 \| 5000 слов
tone	string?	"formal" \| "friendly" \| "expert"
language	string?	"ru" \| "en" \| "de" \| "fr"

POST /api/chat

AI-чат для маркетологов. Стриминг ответов.

Параметр	Тип	Описание
messages	array	Массив {role: "user"\|"assistant", content: string}

POST /api/keywords

AI-подбор ключевых слов для SEO. Доступно всем тарифам.

Параметр	Тип	Описание
query	string	Тема или базовое ключевое слово
language	string?	"ru" \| "en" (по умолчанию "ru")

POST /api/workflows

Многошаговая автоматизация. Доступно с тарифа Старт.

Параметр	Тип	Описание
topic	string	Тема для автоматизации
steps	array	Массив шагов: "research" \| "article" \| "social_posts" \| "email" \| "rewrite"

POST /api/fact-check

Проверка фактов в тексте. Доступно с тарифа Старт.

Параметр	Тип	Описание
text	string	Текст для проверки (макс. 10000 символов)

Подписки и оплата

Доступны месячная и годовая подписки. Годовая — оплата за 10 месяцев (скидка 20%).

Тариф	Месяц	Год (скидка 20%)
Хобби	490 ₽	4 900 ₽
Старт	1 490 ₽	14 900 ₽
Про	3 990 ₽	39 900 ₽

Оплата через ЮKassa (банковские карты МИР, СБП). Подписка не продлевается автоматически.

Коды ошибок

Код	Описание
400	Неверные параметры
401	Не авторизован / неверный API-ключ
403	Функция недоступна на вашем тарифе
429	Лимит генераций исчерпан
500	Внутренняя ошибка
503	Сервис временно недоступен