Generuj opis

Endpoint do generowania opisów AI

Ten endpoint pozwala na generowanie artykułów lub opisów produktów za pomocą sztucznej inteligencji. Wystarczy przekazać informacje o produkcie w przejrzystej strukturze, a system AI zwróci automatycznie wygenerowany opis.

Adres URL endpointu

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

Metoda

 POST

Format danych

 application/json

Przykład żądania 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"
        ]
      }
    }
  ]
}

Parametry żądania

Parametr Typ Obowiązkowy Opis
workflow integer Nie Jeśli nie zostanie podany, zostanie użyty skonfigurowany domyślny workflow.
to string Nie Język, w którym zostanie wygenerowany wynik. Jeśli nie zostanie ustawiony, zostanie automatycznie wykryty.
callback_url string Nie Adres URL, na który zostanie wysłana odpowiedź. Jeśli nie zostanie ustawiony, zostanie użyty skonfigurowany domyślny adres URL.
data array Tak Lista obiektów z danymi dla każdego indywidualnego żądania.


Struktura pola data

Pole Typ Obowiązkowy Opis
ref string Nie Identyfikator referencyjny dla klienta.
content object Tak Obiekt zawierający szczegóły produktu.


Struktura pola content

Pole Typ Obowiązkowy Opis
name string Tak Nazwa produktu.
categories array Nie Lista kategorii powiązanych z produktem.
description string Nie Opis produktu.
additional array Nie Lista specyfikacji lub dodatkowych informacji.


Możliwe odpowiedzi

Pomyślna odpowiedź (HTTP 200)

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

Żądanie zostało zarejestrowane, a system zwrócił jego ID wraz z Twoją referencją.

Odpowiedź błędu (HTTP 400)

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

Odpowiedź wskazuje, że żądanie było nieprawidłowe. Pole errors będzie zawierać listę szczegółów dotyczących tego, co poszło nie tak.

Przykłady integracji

Przykłady integracji dostępne są na oficjalnej stronie Ovesio na GitHubie .

Czy masz jakieś pytania? Skontaktuj się z nami

Zarezerwuj rozmowę demo