Generare descriere

Endpoint pentru generarea descrierilor AI

Acest endpoint permite generarea de articole sau descrieri de produs cu ajutorul inteligenței artificiale. Trebuie să transmiți informații despre produs într-o structură clară, iar sistemul AI va returna o descriere generată automat.

URL endpoint

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

Metodă

POST

Format date

application/json

Exemplu cerere 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"
        ]
      }
    }
  ]
}

Parametri cerere

Parametru	Tip	Obligatoriu	Descriere
workflow	integer	nu	Dacă nu este specificat, se va folosi workflow-ul implicit configurat.
to	string	nu	Limba în care se va genera rezultatul. Dacă nu este setată, va fi detectată automat.
callback_url	string	nu	Adresa URL la care se va trimite răspunsul. Dacă nu este setată, se folosește URL-ul implicit configurat.
data	array	da	Lista de obiecte cu datele pentru fiecare cerere individuală.

Structura câmpului `data`

Câmp	Tip	Obligatoriu	Descriere
ref	string	nu	ID-ul de referință pentru client.
content	object	da	Obiect care conține detaliile produsului.

Structura câmpului `content`

Câmp	Tip	Obligatoriu	Descriere
name	string	da	Numele produsului.
categories	array	nu	Listă de categorii asociate produsului.
description	string	nu	Descrierea produsului.
additional	array	nu	Listă de specificații sau informații adiționale.

Răspunsuri posibile

Răspuns de succes (HTTP 200)

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

Cererea a fost înregistrată, iar sistemul a returnat ID-ul acesteia împreună cu referința ta.

Răspuns de eroare (HTTP 400)

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

Răspunsul indică faptul că cererea nu a fost validă. Câmpul errors va conține o listă cu detalii despre ce anume a fost greșit.

Exemple de integrare

Poți consulta exemple de integrare disponibile pe pagina oficială de GitHub Ovesio.