MarketCard AI

Yandex Metrika

Counter: 110476730

Environment variable:

NEXT_PUBLIC_YANDEX_METRIKA_ID=110476730

Goals:

click_create_card - create-card CTA click
open_cabinet - cabinet open
upload_photo - product photo upload
generate_card - successful card generation
download_png - PNG download
download_json - JSON download
copy_description - description or marketplace text copy
save_to_history - card saved to history
select_marketplace - marketplace selection
select_design_preset - design preset selection
pricing_click - pricing plan click

Check in Yandex Metrika: Reports -> Conversions.

Yandex Direct And Metrika

Counter: 110476730

Core goals for ads:

click_create_card - create-card CTA click
open_cabinet - cabinet open
generate_card - successful card generation
download_png - PNG download

Direct quick links:

/cabinet
/#examples
/#how
/#pricing

Direct UTM template:

utm_source=yandex_direct&utm_medium=cpc&utm_campaign={campaign_id}&utm_content={ad_id}&utm_term={keyword}

MarketCard AI - MVP AI-сервиса для продавцов маркетплейсов. Пользователь загружает фото товара, вводит описание, выбирает маркетплейс, стиль и режим изображения, а сервис генерирует текст карточки, SEO, инфографику, HTML-preview и AI-изображение через NanoBanana Expert или Google Gemini Nano Banana.

Запуск

npm install
npm run dev

Сборка:

npm run build

Переменные окружения

Скопируйте .env.example в .env.local:

AI_PROVIDER=gemini
GEMINI_API_KEY=
GEMINI_TEXT_MODEL=gemini-2.5-flash
IMAGE_PROVIDER=nanobanana_expert
GEMINI_IMAGE_MODEL=gemini-3.1-flash-image
GEMINI_IMAGE_FALLBACK_MODEL=gemini-2.5-flash-image
GEMINI_IMAGE_PRO_MODEL=gemini-3-pro-image
GEMINI_IMAGE_SIZE=1K

NANOBANANA_EXPERT_API_KEY=
NANOBANANA_EXPERT_BASE_URL=https://nanobanana.expert/api/v1
NANOBANANA_EXPERT_MODEL=nb2
NANOBANANA_EXPERT_PROVIDER=auto
NANOBANANA_EXPERT_RESOLUTION=1k
NANOBANANA_EXPERT_ASPECT_RATIO=4:5

KLING_ACCESS_KEY=
KLING_SECRET_KEY=
KLING_BASE_URL=https://api-singapore.klingai.com
KLING_VIDEO_MODEL=kling-v1-6
KLING_VIDEO_MODE=std

Секретные ключи храните только в .env.local. Не добавляйте реальные ключи в .env.example.

Veo 3.1 video (GenAPI)

Видео из готовой карточки создаётся через Google Veo 3.1 Fast (GenAPI, network id veo-3-1-fast, img2video через image_urls). Длительность — 4, 6 или 8 секунд, без звука. Розничные тарифы: standard (1080p) — 38 ₽/сек (4 сек = 152 ₽), pro (4K) — 114 ₽/сек. Карточка — 55 ₽ за одну генерацию фото.

GENAPI_API_KEY=
GENAPI_BASE_URL=https://api.gen-api.ru
GENAPI_VIDEO_MODEL_ID=veo-3-1-fast
GENAPI_CALLBACK_SECRET=

Legacy Kling video (direct API)

Для включения добавьте в .env.local один из вариантов.

Новый формат (один ключ из консоли Kling, вида api-key-kling-...):

KLING_API_KEY=

или

KLING_ACCESS_KEY=

Старый формат (пара Access Key + Secret Key для JWT):

KLING_ACCESS_KEY=
KLING_SECRET_KEY=

Общие настройки:

KLING_BASE_URL=https://api-singapore.klingai.com
KLING_VIDEO_MODEL=kling-v1-6
KLING_VIDEO_MODE=std

Endpoint приложения: POST /api/generate-video. Он создаёт задачу Kling image2video, если передано изображение, иначе text2video, и возвращает videoUrl либо taskId для повторной проверки.

Как подключить NanoBanana Expert

Зарегистрируйтесь в NanoBanana Expert.
Откройте Dashboard → API.
Создайте API key.
В .env.local добавьте:

NANOBANANA_EXPERT_API_KEY=
NANOBANANA_EXPERT_BASE_URL=https://nanobanana.expert/api/v1
NANOBANANA_EXPERT_MODEL=nb2
NANOBANANA_EXPERT_PROVIDER=auto
NANOBANANA_EXPERT_RESOLUTION=1k
NANOBANANA_EXPERT_ASPECT_RATIO=4:5
IMAGE_PROVIDER=nanobanana_expert

Запустите проект:

npm run dev

На странице генератора выберите: Режим изображения → NanoBanana Expert

Ошибки NanoBanana Expert

401: Неверный API-ключ.

402: Недостаточно banana-баланса.

400: Ошибка параметров запроса.

403: Нет доступа или аккаунт заблокирован.

429: Слишком много запросов.

500/503: Сервис временно недоступен.

Когда выбирать nb2, а когда gpt2

nb2: Использовать по умолчанию для красивых товарных карточек, фонов, визуальной композиции и image-to-image.

gpt2: Использовать, если важно лучше отрисовать текст на изображении.

Как включить Nano Banana (Gemini)

Создайте API key в Google AI Studio.
Создайте файл .env.local.
Добавьте:

GEMINI_API_KEY=
AI_PROVIDER=gemini
IMAGE_PROVIDER=gemini
GEMINI_TEXT_MODEL=gemini-2.5-flash
GEMINI_IMAGE_MODEL=gemini-3.1-flash-image
GEMINI_IMAGE_FALLBACK_MODEL=gemini-2.5-flash-image
GEMINI_IMAGE_PRO_MODEL=gemini-3-pro-image

Запустите проект:

npm run dev

На странице генератора включите “Сгенерировать AI-изображение карточки” и выберите режим:

HTML-preview - не вызывает внешние image API.
NanoBanana Expert - генерация через REST API NanoBanana Expert.
Gemini Nano Banana - gemini-3.1-flash-image / gemini-2.5-flash-image / gemini-3-pro-image.
Auto - сначала NanoBanana Expert (если задан ключ), затем Gemini, затем HTML-preview.

Почему картинка может не генерироваться

не задан NANOBANANA_EXPERT_API_KEY или GEMINI_API_KEY;
недостаточно banana-баланса в NanoBanana Expert;
выбран текстовый Gemini model вместо image model;
не используется Interactions API;
превышены лимиты API;
не подключен billing для платного уровня;
модель временно недоступна;
запрос заблокирован safety-фильтрами;
изображение слишком большое или неподдерживаемого формата.

Если AI-изображение не сгенерировалось, интерфейс не падает: показывается HTML/CSS fallback-preview, который можно скачать как PNG.

Ограничения изображения

Максимальный размер входного файла: 5 МБ.
Поддерживаются image/jpeg, image/png, image/webp.
Если файл больше 5 МБ, приложение покажет ошибку: “Изображение слишком большое. Загрузите файл до 5 МБ.”

Что работает в MVP

Генерация текстовой карточки через Gemini, Ollama, OpenRouter, Hugging Face или smart fallback.
Генерация AI-изображения карточки через NanoBanana Expert REST API.
Генерация AI-изображения карточки через Gemini Nano Banana Interactions API.
Автоматический fallback на HTML/CSS preview.
Проверка баланса NanoBanana Expert через /api/image-balance.
Скачивание PNG/AI-изображения и JSON.
Копирование описания и prompt изображения.
История последних 10 генераций в localStorage, включая AI-изображение и metadata.
Защита от слишком больших и неподдерживаемых изображений.

Платформенная генерация текстов

MarketCard AI генерирует текстовые данные карточки с учётом правил конкретной площадки. Платформа влияет на структуру JSON, стиль, ограничения и поля platformSpecific.

Wildberries

Короткое точное название без SEO-перегруза
Описание, характеристики, преимущества
Safe-тексты для инфографики (wbSafeImageTexts) без цены, скидок и CTA
Список запрещённых слов на фото и чеклист перед загрузкой

Ozon

Информативное название, аннотация и полное описание
Rich-content блоки: «Почему стоит купить», «Сценарии использования», «Что в комплекте»
Структурированные характеристики и медиа-рекомендации

Avito

Формат объявления, а не карточки маркетплейса
Заголовок, описание, цена, CTA, доставка
Блок частых вопросов и ответов

Яндекс Маркет

Информативное название: тип + бренд + характеристики
Описание и характеристики в каталожном стиле
Safe-тексты для фото без цен, скидок и CTA

Пример API-запроса для Wildberries

{
  "platform": "wildberries",
  "textMode": "marketplace_safe",
  "productDescription": "портативный вентилятор с тремя режимами и аккумулятором",
  "category": "Техника для дома",
  "color": "чёрный",
  "price": "1290 ₽",
  "marketplace": "Wildberries",
  "style": "Премиальный",
  "includeSeo": true,
  "focusBenefits": true,
  "includeInfographicText": true
}

Пример API-запроса для Avito

{
  "platform": "avito",
  "textMode": "full_listing",
  "productDescription": "премиальная награда из дуба и чёрного акрила",
  "category": "Сувениры и подарки",
  "price": "7490 ₽",
  "packageContents": "награда, подарочная упаковка",
  "marketplace": "Avito",
  "style": "Премиальный",
  "includeSeo": true,
  "focusBenefits": true,
  "includeInfographicText": true
}

Ответ API содержит поле marketplaceText с платформенной структурой, platformSpecific, moderationWarnings, improvementTips и exportChecklist.

Честные ограничения

В MVP нет прямой публикации на WB/Ozon/Avito.
AI-модель может ошибаться в мелкой типографике; HTML-preview остается надежным fallback.
Для Gemini image API может требоваться paid billing.

Name		Name	Last commit message	Last commit date
app		app
certs		certs
components		components
config		config
lib		lib
public		public
publick		publick
types		types
.env.example		.env.example
.gitignore		.gitignore
README.md		README.md
auth.config.ts		auth.config.ts
auth.ts		auth.ts
middleware.ts		middleware.ts
next-env.d.ts		next-env.d.ts
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json

Navigation Menu

Repository navigation

About

Repository files navigation

MarketCard AI

Yandex Metrika

Yandex Direct And Metrika

Запуск

Переменные окружения

Veo 3.1 video (GenAPI)

Legacy Kling video (direct API)

Как подключить NanoBanana Expert

Ошибки NanoBanana Expert

Когда выбирать nb2, а когда gpt2

Как включить Nano Banana (Gemini)

Почему картинка может не генерироваться

Ограничения изображения

Что работает в MVP

Платформенная генерация текстов

Wildberries

Ozon

Avito

Яндекс Маркет

Пример API-запроса для Wildberries

Пример API-запроса для Avito

Честные ограничения

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

MarketCard AI

Yandex Metrika

Yandex Direct And Metrika

Запуск

Переменные окружения

Veo 3.1 video (GenAPI)

Legacy Kling video (direct API)

Как подключить NanoBanana Expert

Ошибки NanoBanana Expert

Когда выбирать nb2, а когда gpt2

Как включить Nano Banana (Gemini)

Почему картинка может не генерироваться

Ограничения изображения

Что работает в MVP

Платформенная генерация текстов

Wildberries

Ozon

Avito

Яндекс Маркет

Пример API-запроса для Wildberries

Пример API-запроса для Avito

Честные ограничения

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages