AI Modules

AvidiaDescribe — AI Product Descriptions

Generate listing-ready product descriptions from structured data — at any scale, in any tone.

What AvidiaDescribe Does

AvidiaDescribe takes the structured product data output from AvidiaExtract (or manually entered product data) and generates human-quality product copy. It produces multiple content types per run: a short description for search snippets, a long-form description for your product detail page, a bullet-point feature list, and a technical summary for spec sheets or B2B buyers.

Unlike generic AI writing tools, AvidiaDescribe is trained specifically on product content and avoids the vague, filler-heavy output that plagues general-purpose AI. Every description is grounded in the actual extracted specifications — no hallucinated claims.

Input and Output

Input

  • Extracted product data (from AvidiaExtract)
  • Manual product data (name, brand, specs)
  • Existing short description for enrichment

Output

  • Short description — 1–2 sentences, 150–200 chars
  • Long description — 3–5 paragraphs, full prose
  • Bullet points — 5–8 feature highlights
  • Technical summary — spec-focused, structured

Example output — Bosch GSB 18V-755 Drill:

Short Description

Professional-grade brushless combi drill with 75 Nm torque and 13mm keyless chuck — built for drilling into concrete, masonry, and wood on a single 18V battery charge.

Bullet Points

  • Brushless EC motor delivers 75 Nm hard torque for heavy-duty applications
  • 2-speed gearbox: 0–550 rpm (drilling) / 0–2,100 rpm (driving)
  • 13mm keyless chuck for fast, tool-free bit changes
  • 25+1 torque settings for precise screw-driving in any material
  • Compatible with Bosch 18V ProCORE Li-ion batteries

Tone Settings

Select the tone that matches your brand voice and customer expectations. The same underlying product data will produce very different copy depending on the tone you choose.

Professional

B2B, industrial supply, professional tools

"The Bosch GSB 18V-755 Cordless Combi Drill delivers 75 Nm of torque with a brushless motor, designed for demanding professional applications including concrete and masonry drilling."

Casual

Consumer retail, home improvement, DIY

"Meet your new go-to drill. The Bosch 18V Combi gives you serious power for everything from hanging shelves to DIY renovations — and the battery lasts all day."

Technical

Technical buyers, procurement, specification matching

"GSB 18V-755: brushless EC motor, max torque 75 Nm (hard), 13mm keyless chuck, 2-speed gearbox (0–550/0–2,100 rpm), 25+1 torque settings. Kompatibel mit 18V Li-ion batteries."

Medical / Clinical

Medical supply, healthcare, PPE

"The 3M N95 Respirator 8210 provides NIOSH-approved particulate filtration efficiency ≥95% for non-oil aerosols. Indicated for use in healthcare environments and industrial settings requiring respiratory protection."

Length and Format Options

HTMLDescription wrapped in <p>, <ul>, <li> tags. Ready for Shopify/BigCommerce product description fields.
Plain textNo markup. Clean text suitable for feeds, PDFs, or platforms that don't accept HTML.
MarkdownUses ** for bold, - for bullets. Ideal for Notion, GitHub, or headless CMS systems.

Configure your default output format in Dashboard → Description Formats. You can also override the format per-request in the API.

Description Templates

Templates let you define the structure and emphasis of your descriptions. For example, you can create a template that always starts with a benefit statement, includes a compatibility note for industrial products, and ends with a warranty reminder.

Set up templates at /dashboard/description-formats. Each template includes:

  • Template name (e.g., "Industrial MRO", "Consumer Electronics")
  • Required sections (short description, long description, bullets, technical)
  • Tone and length preferences
  • Custom instructions (free-text directives to the AI model)
  • Output format (HTML, plain text, Markdown)

Templates can be set as defaults per product category, so a medical supply product automatically uses the clinical template while power tools use the professional template.

Industry Presets

If you don't want to build a custom template, use one of the built-in industry presets to get tuned output for your vertical:

Medical / Clinical

Avoids superlatives and unverifiable claims. Uses clinical language and includes indication/contraindication framing.

Industrial / MRO

Emphasizes specs, certifications, and compatibility. Uses trade terminology (MPN, ANSI, OSHA standards).

Consumer Electronics

Feature-benefit framing, accessibility-focused language, emphasizes user experience.

Apparel / Soft Goods

Fabric composition, care instructions, fit notes. Sensory and lifestyle language.

What Makes a Good Description

AvidiaDescribe scores each description internally before returning it. Here's what the model is optimizing for:

  • Specificity: references actual product data (model numbers, measurements, materials) rather than generic claims.
  • Feature-benefit framing: pairs each feature with a practical benefit. "Brushless motor (feature) means longer runtime and less maintenance (benefits)."
  • No keyword stuffing: natural keyword integration, not repetition. SEO optimization is handled by AvidiaSEO, not by cramming keywords into the description.
  • Filler phrases: "This product is perfect for all your needs" — the model is tuned to avoid empty copy that doesn't communicate value.

Regenerating Descriptions

If the generated description doesn't meet your quality bar, regenerate it from the product detail view. Click Regenerate Description — you can optionally add custom instructions (e.g., "emphasize that this product is FDA 510(k) cleared") to guide the next generation.

Previous versions are stored and accessible under the History tab — you can roll back to any prior version without consuming an additional credit.

Credit Usage

AvidiaDescribe costs 1 description credit per product per run. Regeneration within 24 hours of the original run is free. After 24 hours, regeneration consumes an additional credit.

Check your available description credits in Dashboard → Billing.

API: Generate a Description

POST https://app.avidiatech.com/api/v1/describe
Authorization: Bearer <your-api-key>
Content-Type: application/json

{
  "ingestion_id": "ing_01HX4K2QZRP7W9VMBGT3DENF8",
  "tone": "professional",
  "format": "html",
  "length": "standard",
  "custom_instructions": "Mention that this product is NIOSH-approved."
}

// Response (200 OK)
{
  "id": "desc_01HX4K9ZTAB2N3VMCGP4REEF9",
  "ingestion_id": "ing_01HX4K2QZRP7W9VMBGT3DENF8",
  "short": "NIOSH-approved N95 respirator delivering ≥95% particulate filtration...",
  "long": "<p>The 3M N95 Respirator 8210 is NIOSH-approved for use in...</p>",
  "bullets": [
    "NIOSH-approved N95 particulate filtration efficiency ≥95%",
    "Lightweight flat-fold design fits in pocket or pouch",
    "Soft inner material reduces skin contact irritation",
    "Adjustable nose clip ensures secure, comfortable seal",
    "Tested to NIOSH 42 CFR Part 84 standards"
  ],
  "technical_summary": "Model: 8210 | Filtration: ≥95% non-oil | Style: Flat fold...",
  "credits_used": 1
}
AvidiaTech | Product Data Automation