E-commerce mode produces alt text optimized for product listings — emphasizing specific product attributes rather than general visual description.
How it activates
E-commerce mode activates automatically when you include any product metadata in your request. There is no separate toggle.
API — include any field in the ecommerce object:
{
"imageUrl": "https://example.com/sneaker.jpg",
"ecommerce": {
"product": "sneakers",
"brand": "Nike",
"color": "black",
"material": "leather"
}
}
Pass as many product fields as possible. The more context the model has — brand, color, material, product name — the more precise and consistent the output will be across your catalog.
Output differences
| Mode | Example output |
|---|
| Default | A person wearing joggers in a park, mid-stride. |
| E-commerce | Black Nike joggers in polyester fabric — relaxed fit. |
Style interaction
When e-commerce mode is active, the selected writing style has lower priority. Output stays concise and attribute-focused regardless of the style setting. This ensures consistency across product listings.
Available product fields
| Field | Description | Example |
|---|
product | Product name or type | "office chair" |
brand | Brand name | "Herman Miller" |
color | Dominant color or palette | "ivory white" |
material | Product material | "ceramic" |
