Как использовать YandexGPT API для автоматического создания описаний товаров

YandexGPT API позволяет автоматизировать создание описаний товаров через интеграцию нейросетевого генератора текста в ваш каталог продуктов. Это сокращает время подготовки контента на 80–90% и обеспечивает консистентность описаний. Для реализации потребуется API-ключ Яндекса, Python или другой язык программирования, а также настройка запросов к модели.

Зачем использовать YandexGPT API для описаний товаров

Экономия времени — вместо ручного написания сотен описаний система генерирует их за секунды.
Масштабируемость — автоматизация работает при добавлении новых товаров без дополнительных затрат труда.
Единообразный стиль — нейросеть придерживается заданных инструкций и параметров тона для всех описаний.
Многоязычность — YandexGPT поддерживает генерацию описаний на разных языках.
Снижение ошибок — автоматический контроль орфографии и грамматики встроен в API.
Оптимизация для SEO — можно настроить промпт для включения ключевых слов в описания.

Пошаговая инструкция по настройке

Этап 1: Получение API-ключа

Откройте консоль Яндекс.Облака по адресу https://console.cloud.yandex.ru.
Авторизуйтесь с помощью учётной записи Яндекса.
Создайте новый проект или выберите существующий.
Перейдите в раздел API и сервисы → Учётные данные.
Нажмите кнопку Создать учётные данные и выберите API-ключ.
Скопируйте сгенерированный ключ и сохраните его в безопасном месте.
Убедитесь, что в проекте включён сервис Generative Models API.

Этап 2: Установка необходимых инструментов

Установите Python версии 3.8 или выше (если его ещё нет).
Откройте командную строку или терминал.
Установите официальную библиотеку Яндекса командой pip install yandex-cloud.
Установите дополнительно библиотеку для работы с запросами: pip install requests.
Проверьте установку, выполнив команду pip list и убедитесь, что обе библиотеки присутствуют.

Этап 3: Подготовка данных товаров

Подготовьте CSV-файл или JSON-файл с данными товаров (название, категория, ключевые характеристики).
Убедитесь, что в файле присутствуют колонки: product_name, category, features.
Сохраните файл в кодировке UTF-8 для корректной работы с кириллицей.
Проверьте, что структура данных соответствует формату, который будет использован в скрипте.

Этап 4: Написание Python-скрипта для интеграции

Создайте новый файл Python с расширением .py (например, generate_descriptions.py).
Импортируйте необходимые модули: requests, json, csv.
Инициализируйте переменные с вашим API-ключом и точкой входа API: API_KEY = "your_key" и API_ENDPOINT = "https://llm.api.cloud.yandex.net/llm/v1/chat".
Напишите функцию для отправки запроса к YandexGPT (см. пример ниже).
Создайте цикл для обработки каждого товара из вашего набора данных.
Сохраняйте результаты в новый CSV или JSON-файл.

Пример базового скрипта

import requests
import json
import csv

API_KEY = "your_api_key_here"
API_ENDPOINT = "https://llm.api.cloud.yandex.net/llm/v1/chat"

def generate_description(product_name, category, features):
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    
    prompt = f"Напиши краткое, привлекательное описание товара для интернет-магазина в 2-3 предложения. Название: {product_name}. Категория: {category}. Особенности: {features}"
    
    payload = {
        "model_uri": "gpt://b1g86q4d080h42l7j9g0/yandexgpt-lite",
        "messages": [
            {"role": "user", "text": prompt}
        ]
    }
    
    response = requests.post(API_ENDPOINT, headers=headers, json=payload)
    
    if response.status_code == 200:
        result = response.json()
        return result['result']['message']['text']
    else:
        return f"Ошибка: {response.status_code}"

# Чтение товаров из CSV
with open('products.csv', 'r', encoding='utf-8') as infile:
    reader = csv.DictReader(infile)
    products = list(reader)

# Генерация описаний
results = []
for product in products:
    description = generate_description(
        product['product_name'],
        product['category'],
        product['features']
    )
    results.append({
        'product_name': product['product_name'],
        'description': description
    })
    print(f"✓ Обработан: {product['product_name']}")

# Сохранение результатов
with open('generated_descriptions.csv', 'w', encoding='utf-8', newline='') as outfile:
    writer = csv.DictWriter(outfile, fieldnames=['product_name', 'description'])
    writer.writeheader()
    writer.writerows(results)

print("Описания успешно сгенерированы и сохранены в generated_descriptions.csv")

Этап 5: Запуск скрипта

Откройте командную строку в папке, где находится ваш скрипт.
Выполните команду python generate_descriptions.py.
Дождитесь завершения обработки всех товаров (время зависит от их количества).
Проверьте выходной файл generated_descriptions.csv с результатами.
Убедитесь, что описания качественные и соответствуют вашим требованиям.

Этап 6: Импорт в систему управления каталогом

Откройте административную панель вашего интернет-магазина.
Перейдите в раздел управления товарами или Каталог.
Найдите функцию Импорт товаров или Bulk Upload.
Загрузите CSV-файл с сгенерированными описаниями.
Сопоставьте колонки (product_name → название товара, description → описание).
Нажмите кнопку Импортировать или Применить.
Проверьте результаты и убедитесь, что описания корректно заполнены в карточках товаров.

Часто задаваемые вопросы

Какой лимит запросов к YandexGPT API? Лимиты зависят от тарифного плана Яндекс.Облака; бесплатный уровень предоставляет ограниченное количество запросов в месяц, платные планы предлагают масштабируемые лимиты.

Как избежать блокировки при большом количестве товаров? Добавьте задержку между запросами с помощью time.sleep(1) в цикле обработки товаров.

Можно ли кастомизировать стиль описаний? Да, измените переменную prompt в функции generate_description(), указав требуемый тон, длину и ключевые слова для описаний.

Текстовые ИИ и Копирайтинг