Генерирай описание

Крайна точка за генериране на AI описания

Тази крайна точка позволява генерирането на статии или продуктови описания с помощта на изкуствен интелект. Трябва да подадете информация за продукта в ясна структура и AI системата ще върне автоматично генерирано описание.

URL на крайна точка

 https://api.ovesio.com/v1/ai/generate-description

Метод

 POST

Формат на данните

 application/json

Пример за JSON заявка

 {
  "workflow": null,
  "to": "en",
  "callback_url": "https://example.com/callback-url",
  "data": [
    {
      "ref": "1234ABC",
      "content": {
        "name": "SAMSUNG QN32Q60D 32 Inch QLED 4K Smart TV Bundle",
        "categories": ["Smart TV", "Samsung", "Home Entertainment"],
        "description": "Smart TV",
        "additional": [
          "Display Technology: LED",
          "Special Technology: QLED",
          "Image Quality: 4K"
        ]
      }
    }
  ]
}

Параметри на заявката

Параметър Тип Задължителен Описание
workflow цяло число не Ако не е зададен, ще бъде използван конфигурираният работен поток по подразбиране.
to низ не Езикът, на който ще бъде генериран резултатът. Ако не е зададен, ще бъде автоматично разпознат.
callback_url низ не URL адресът, на който ще бъде изпратен отговорът. Ако не е зададен, се използва конфигурираният URL по подразбиране.
date масив Да Списъкът с обекти с данните за всяка отделна заявка.


Структура на полето data

Поле Тип Задължителен Описание
ref низ не Идентификаторът на препратка за клиента.
content обект Да Обект, съдържащ подробности за продукта.


Структура на полето content

Поле Тип Задължителен Описание
name низ Да Име на продукта.
categories масив не Списък с категории, свързани с продукта.
description низ не Описание на продукта.
additional масив не Списък със спецификации или допълнителна информация.


Възможни отговори

Успешен отговор (HTTP 200)

 {
  "success": true,
  "data": [
    {
      "id": 320126,
      "ref": "1234ABC"
    }
  ]
}

Заявката е регистрирана и системата е върнала нейния ID заедно с вашата препратка.

Отговор за грешка (HTTP 400)

 {
  "success": false,
  "errors": []
}

Отговорът показва, че заявката не е била валидна. Полето errors ще съдържа списък с подробности за това какво се е объркало.

Примери за интеграция

Можете да разгледате примери за интеграция, достъпни на официалната GitHub страница на Ovesio.

Имате ли въпроси? Свържете се с нас

Резервирай демонстрационен разговор