Endpoint para generar descripciones de IA
Este endpoint permite la generación de artículos o descripciones de productos utilizando inteligencia artificial. Debe pasar la información del producto en una estructura clara, y el sistema de IA devolverá una descripción generada automáticamente.
URL del endpoint
https://api.ovesio.com/v1/ai/generate-description
Método
POST
Formato de datos
application/json
Ejemplo de solicitud 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"
]
}
}
]
}
Parámetros de la solicitud
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| workflow | entero | no | Si no se especifica, se utilizará el flujo de trabajo predeterminado configurado. |
| to | cadena | no | El idioma en el que se generará el resultado. Si no se establece, se detectará automáticamente. |
| callback_url | cadena | no | La URL a la que se enviará la respuesta. Si no se establece, se utiliza la URL predeterminada configurada. |
| date | array | Sí | La lista de objetos con los datos para cada solicitud individual. |
Estructura del campo data
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| ref | cadena | no | El ID de referencia para el cliente. |
| content | objeto | Sí | Objeto que contiene los detalles del producto. |
Estructura del campo content
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| name | cadena | Sí | Nombre del producto. |
| categories | array | no | Lista de categorías asociadas al producto. |
| description | cadena | no | Descripción del producto. |
| additional | array | no | Lista de especificaciones o información adicional. |
Posibles respuestas
Respuesta exitosa (HTTP 200)
{
"success": true,
"data": [
{
"id": 320126,
"ref": "1234ABC"
}
]
}
La solicitud ha sido registrada y el sistema ha devuelto su ID junto con su referencia.
Respuesta de error (HTTP 400)
{
"success": false,
"errors": []
}
La respuesta indica que la solicitud no era válida. El campo errors contendrá una lista de detalles sobre lo que salió mal.
Ejemplos de integración
Puede consultar ejemplos de integración disponibles en la página oficial de GitHub de Ovesio .