Product AI
AI-powered product description generation with configurable tone, language, and agent
Last updated: Feb 09, 2026
Product AI
Note: Requires authentication. Requires AI features to be enabled in admin Settings → AI Settings.
Generate Product Description
Use AI to generate product descriptions based on product data and optional context.
POST /api/v1/products/{id}/generate-descriptionAuthorization: Bearer {token}
Request Body:
{
"product_title": "Premium Yoga Mat",
"category": "Sports & Outdoors",
"attributes": ["Non-slip", "6mm thickness", "Eco-friendly"],
"brand": "FitPro",
"key_features": ["Anti-tear", "Moisture resistant", "Carrying strap included"],
"target_audience": "Fitness enthusiasts",
"tone_preference": "professional",
"language": "en",
"agent": "Product Description Writer"
}Request Fields
| Field | Type | Required | Description |
|---|---|---|---|
product_title | string | No | Override product name (max 200 chars) |
category | string | No | Product category context (max 255 chars) |
attributes | array | No | Product attributes for context |
images | array | No | Image URLs for vision-capable models |
brand | string | No | Brand name (max 120 chars) |
key_features | array | No | Key selling points |
target_audience | string | No | Intended audience (max 120 chars) |
tone_preference | string | No | Writing tone: professional, casual, luxury, etc. (max 50 chars) |
language | string | No | Output language code, e.g., en, hi (max 10 chars) |
agent | string | No | Specific AI agent name to use (max 120 chars) |
Response: 200 OK
{
"success": true,
"message": "Product description generated",
"data": {
"short_description": "Professional-grade yoga mat with non-slip surface...",
"description": "Elevate your yoga practice with the Premium Yoga Mat by FitPro..."
}
}Error Response: 422
{
"success": false,
"message": "AI generation failed: Provider not configured",
"error_code": "AI_GENERATION_FAILED"
}