Интеграции · API5 минут чтения

Как генерировать описания и фото товаров через API

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

Предметная фотосъёмка флакона в студийном свете

1. Проверьте подключение бесплатно

Откройте метаданные OAuth. Запрос не требует аккаунта, токена или кредитов. В ответе будет адрес ресурса и информация для настройки авторизации.

Запрос метаданных OAuth
curl --fail https://mcp.cormak.app/.well-known/oauth-protected-resource/mcp

2. Подключите аккаунт и узнайте цену

Подключите Cormak по OAuth с PKCE и правом store:use. Дальше отправляйте JSON методом POST на https://mcp.cormak.app/store с заголовком Authorization: Bearer и вашим токеном. Храните токен на сервере или в локальном окружении Postman. Владелец аккаунта может отозвать доступ и настроить лимит генераций.

Тело запроса баланса и цен
{ "action": "account" }

В ответе проверьте available_ai_credits и prices. Чтение бесплатно. Генерация текста стоит 1 ИИ-кредит. Для фото возьмите текущую цену выбранной модели и качества из prices.images. Генерации используют баланс подключённого аккаунта.

3. Сгенерируйте описание товара

Передайте название и проверенные характеристики товара. Укажите поля, которые хотите получить. Этот запрос может сразу списать кредит. Пример UUID замените новым перед запуском для своего товара.

Платный запрос на описание
{
  "action": "fill_text",
  "request_id": "7b467f8a-8d87-4a92-8c8a-43df4bccd680",
  "locale": "en_US",
  "product": {
    "name": "White ceramic mug",
    "attributes": [
      {
        "name": "Material",
        "values": [
          "Ceramic"
        ]
      }
    ]
  },
  "options": {
    "fields": [
      "title",
      "description",
      "image_alt"
    ],
    "tone": "neutral",
    "length": "short"
  }
}

При status=complete возьмите нужные поля из result, например description_html. Для текста на русском укажите locale: ru_RU. Перед публикацией проверьте описание по каталогу поставщика.

4. Запустите генерацию фото и получите файл

Используйте новый UUID для фото. В expected_credits подставьте текущую цену модели и качества из ответа account. Число 2 в примере — пример значения для запроса. image_start возвращает HTTP 202, когда принимает запрос. Это пример генерации по тексту. Если важна точная форма товара, передайте исходное фото через reference и сравните результат с оригиналом.

Платный запуск генерации фото
{
  "action": "image_start",
  "request_id": "3278b354-fdd3-4600-a84b-c7dd7f544ba9",
  "mode": "prompt",
  "prompt": "A white ceramic mug on a plain background",
  "model": "nano2",
  "quality": "standard",
  "aspect_ratio": "1:1",
  "expected_credits": 2,
  "use_free_photo": false
}
Бесплатная проверка статуса фото
{
  "action": "image_status",
  "request_ids": [
    "3278b354-fdd3-4600-a84b-c7dd7f544ba9"
  ]
}

Если статус running, подождите и повторите проверку. При complete скачайте результат по временной ссылке. Если запрос прервался, повторяйте его с теми же UUID и параметрами. При статусе unknown проверьте результат в аккаунте прежде, чем запускать новую платную операцию.

ПРАКТИКА ВАЖНЕЕ ТЕОРИИ

Создайте следующий шаг из одной фразы.

Попробовать Cormak бесплатно 5 ИИ-кредитов в месяц · без привязки банковской карты