Крайна точка за генериране на 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.