| name | ecommerce-livestream-overlay-generator |
| description | Fully automated e-commerce livestream overlay generation. Given a brand, product, and promotional info (or a product photo directly), automatically generates a complete livestream visual package: background, title banner, host persona, pricing card, product shelf, and benefits bar. Supports green screen removal, auto-composite preview, and packaged delivery.
|
E-Commerce Livestream Overlay Generator Skill
I. Prerequisites
Dependencies
- Python 3 + Pillow + opencv-python-headless + numpy
- Volcano Engine (Doubao) API Key
Install dependencies
pip3 install Pillow==12.2.0 opencv-python-headless==4.13.0 numpy==2.3.2
II. Requirement Confirmation (Must Complete Before Generation)
⚠️ Upon receiving a generation request, do NOT start generating images immediately. Confirm the following info first to ensure one-pass success.
2.1 Required Information
| Info | Description | Required |
|---|
| Brand | e.g. Dyson, Moutai, Three Squirrels | ✅ |
| Featured Product | Specific product name and model | ✅ |
| Promotion | Discounts, gifts, loyalty points, etc. | ✅ |
| Style Preference | Special requirements (color, mood, tone) | ❌ |
2.2 Confirmation Flow
- User provides complete info → Summarize understanding, ask user to confirm, then start
- User info is incomplete → Only ask for missing required fields, auto-infer the rest
- User sends a product photo with no text → Identify the product, infer brand & category, summarize and confirm
- User says "use the example" → Generate directly using the Dyson example below
2.3 Confirmation Example Reply
Let me confirm the requirements:
📋 **Brand**: Dyson
📋 **Featured Product**: Dyson Supersonic HD16 Hair Dryer + Airwrap Multi-Styler
📋 **Promotion**: ¥300 off every ¥3,000 spent
📋 **Gift**: Free 2 styling nozzle attachments with hair dryer purchase
📋 **Packaging**: Livestream-exclusive gift box
📋 **Style**: Tech-luxury (inferred from Dyson brand)
Here's my copy design:
- Main title: "Dyson · Salon-Grade Styling"
- Subtitle: "Limited Edition · Luxe Experience"
- Pricing card: "¥300 off ¥3,000+ / Free styling nozzles with hair dryer / Exclusive gift box"
- Benefits: "2-year warranty / Free shipping / Premium gift packaging"
If this looks good I'll start generating. Let me know if you want any changes 👇
2.4 Example Requirement (Show Proactively on First Trigger)
When receiving a generation request, proactively show the example below so the user can follow it or ask to use it directly.
Example requirement:
Generate a full Dyson livestream overlay set. Featured products: Dyson Supersonic HD16 Hair Dryer and Airwrap Multi-Styler. Free 2 styling nozzle attachments with hair dryer purchase. ¥300 off every ¥3,000 spent. Livestream-exclusive gift box.
First reply template:
You can just tell me your brand and promo info, like:
> Generate a full Dyson livestream overlay set. Featured products: Dyson Supersonic HD16 Hair Dryer and Airwrap Multi-Styler. Free 2 styling nozzle attachments with hair dryer purchase. ¥300 off every ¥3,000 spent. Livestream-exclusive gift box.
Or just say "use the Dyson example" and I'll generate with that spec.
What's your requirement?
Minimum needed: Brand + Featured Product + Promotion (3 core fields)
Copy, style, host design, benefits are all auto-generated by AI. User can optionally modify.
III. Auto Copywriting Rules
3.1 Main Title
- Must include brand name with atmospheric feel
- NEVER use "official" or "flagship" or similar words
- Don't just write the product name — it needs marketing appeal and purchase desire
3.2 Subtitle
- Core benefit (perks / efficacy / scenario) or current campaign
- Concise and impactful
3.3 Pricing Card
- Split promotion into 2-3 tiers
- Each tier: amount/benefit + conditions
3.4 Benefits Copy
- Usually 3 items: gift-related + authenticity guarantee + logistics/after-sales
- ⚠️ Avoid audit-triggering words like "authentic" or "guarantee" — use "quality" and "assured" instead
IV. Component List & Dimensions
⚠️ Dimensions calibrated for doubao-seedream-4-5-251128 minimum pixel limits
| # | Component | Size | Green Screen | Notes |
|---|
| 1 | Background | 1440×2560 | ❌ | C4D scene |
| 2 | Title Banner | 3328×1109 | ✅ | Die-cut sticker |
| 3 | Host Persona | 1440×2560 | ✅ | Bare-faced + youthful face + styled look (no product in hand) |
| 4 | Pricing Card | 1920×1920 | ✅ | Square die-cut sticker |
| 5 | Product Shelf | 3328×1109 | ✅ | 40+ items dense arrangement |
| 6 | Benefits Bar | 3328×1109 | ❌ | Full-width bottom |
V. Prompt Writing Standards
Core Principles
- All components use a unified style prefix for color consistency
- Must include negative constraints
- Background uses "pure deep green" (not #00FF00)
5.1 Background Prompt
Constraint: No text, no people, no products.
Template:
A C4D commercial space scene blending [style description]. The space uses [primary color] as the dominant tone, complemented by [secondary color], with [accent color] details, all balanced by [neutral color]. The spatial structure presents [structure description], creating a [atmosphere]. Lighting design [lighting description] highlights texture and depth. Materials include [materials], showcasing the charm of [style]. Modular abstract display elements are scattered throughout, such as [element 1], [element 2], and [element 3], together creating a [overall feeling] spatial experience.
5.2 Title Banner Prompt
Template:
Solid uniform green background #00FF00. Center of frame is a [color] gradient die-cut horizontal card with [border texture], irregular artistic edges on all four sides. Inside the card, left side has [text area background color], large text "[MAIN TITLE]" in [font description], below it "[SUBTITLE]" in [font description]. Right side of card shows [product illustration description]. The entire card has rich deep colors with absolutely no white background areas, no green/cyan/teal. The card is a complete solid sticker with crisp sharp edges.
5.3 Host Persona Prompt
⚠️ Core rules (v2 update):
- Use
doubao-seedream-5-0-260128 for host persona (other components still use doubao-seedream-4-5-251128)
- Completely bare-faced, no makeup (not "natural nude makeup")
- Do NOT hold products — hands hang naturally, slightly bent (v2 removed hand-held product)
- Internet-celebrity youthful face with short midface, deep watery eyes, jelly-glossy lips
- Outfit must be pre-designed — fully describe top + bottom (no shoes) + accessories in prompt
- Hair color preferably black, silky smooth, styled with possible accessories matching brand tone
- Background uses "pure deep green" (not #00FF00)
Template:
Pure deep green uniform background, absolutely uniform pure color with no gradients, no texture, no shadows, no light spots, no impurities. Vertical portrait, person standing facing camera, framed from top of head to mid-thigh, person centered and occupying most of the frame, top of head very close to frame top. 25-year-old beautiful young female host, completely bare-faced with no makeup, cool-toned fair skin that is clear and translucent, internet-celebrity youthful face with short midface, {eye type description}, deep watery eyes, {eye area description}, lips {lip shape description} with jelly-glossy {lip color description}, {temperament description}. Completely bare-faced, no makeup on face whatsoever, no eyeshadow, eyeliner, mascara, blush, lipstick, or foundation. Wearing {top description}, {bottom description}, {accessories description}. {hair style and color description}, {hair accessories description}. Soft even front lighting. Person standing naturally, both arms hanging naturally with slight bend, relaxed elegant posture.
Face Differentiation (Must specify these dimensions each time):
| Dimension | Description | Examples |
|---|
| Face shape | Internet-celebrity youthful face, short midface (fixed) | Heart/oval/melon/square-round |
| Eye type | Round/almond/peach-blossom/phoenix | Describe "slightly downturned for innocent look" or "slightly upturned for elegance" |
| Eye hydration | Fixed requirement | "Deep watery eyes, delicate translucent skin around eyes" |
| Lip jelly feel | Fixed requirement | "Full pouty lips with jelly-glossy translucent shine" / "Thin lips natural pale pink with jelly feel" |
| Temperament | Sweet & approachable / cool & premium / elegant & intellectual / energetic / confident | Varies by brand |
| Outfit | Must be pre-designed, top + bottom + accessories | No shoes |
| Hairstyle | Must be pre-designed, primarily black + accessories | Silky smooth, refined with design sense |
Host Design Examples (v2):
Lancôme Absolue:
Internet-celebrity youthful face with short midface, round eyes slightly downturned for innocent look, deep watery eyes, delicate translucent skin around eyes, full pouty lips with jelly-glossy translucent shine, refined sweet and approachable features. Wearing white fine-knit cropped cardigan, layered over cream-white lace camisole, high-waisted light pink pleated satin midi skirt, rose-gold delicate collarbone chain on chest, rose-gold thin bracelet on left wrist, simple pearl ring on right hand. Long straight black hair silky smooth falling to below collarbone, a small pearl hair clip clipped on the right side of crown, a few wispy strands naturally framing the face.
Helena Rubinstein Re-Plasty:
Internet-celebrity youthful face with short midface, phoenix eyes slightly upturned, deep watery eyes with natural cool-premium feel at outer corners, thin lips natural pale pink with jelly-glossy hydration, refined cool-premium features. Wearing black high-neck slim-fit silk shirt, sleeves rolled up to elbows revealing slender wrists, black high-waisted wide-leg suit pants, a 2-carat diamond stud on left earlobe, ultra-fine silver chain bracelet on right wrist. Long straight black hair silky smooth with center part falling naturally to center of back, a minimalist black ultra-thin hairpin placed near right temple for clean structured look.
La Mer:
Internet-celebrity youthful face with short midface, bright large almond eyes, deep watery eyes with warm soulful gaze, standard lips with jelly-glossy natural pink full hydration, refined soft and clear features. Wearing pearl-white silk satin loose shirt with top button undone revealing delicate collarbone, puffy bubble sleeve design, champagne high-waisted satin wide-leg trousers, ultra-fine champagne-gold necklace with small pearl pendant on neck, white jade thin bracelet on left wrist. Long curly black hair silky smooth with natural large waves falling to shoulder blades, a loose refined French braid woven from left side of crown, tiny pearl hairpins scattered through the braid.
5.4 Pricing Card Prompt
⚠️ Size changed from 896×1344 to 1920×1920 (square)
Template:
Solid uniform green background #00FF00. Center of frame is a compact vertical die-cut label sticker, entirely [dark color scheme] solid background, absolutely no white areas, no light-colored areas, no gradients to white, no green/cyan/teal. Sticker shape is rounded rectangle with arched top decoration. Top has [decorative elements]. Large text "[HEADLINE]" in [font description]; below divided into three tiers: "[TIER 1]" "[TIER 2]" "[TIER 3]". The entire sticker has rich deep solid colors with crisp sharp edges, a solid die-cut sticker. Sticker occupies about 40% of frame area, compact not sparse.
5.5 Product Shelf Prompt (⚠️ Different from original skill)
⚠️ Key differences:
- White matte marble display tabletop (not pure green + white plane)
- Layered cluster + left-right mirror + front-back progression layout logic
- At least 40+ individual product units (not "make it rich")
- Middle core zone split into left-center-right sections, center as visual focal point
Template:
Background is pure deep green uniform. At the bottom of frame is a front-facing flat white premium display tabletop (white matte marble texture), completely horizontal with no tilt, occupying bottom 40% of frame height. Products arranged by layered cluster plus left-right mirror plus front-back progression logic, at least 40+ individual product units densely covering most tabletop area: [Middle core display zone split into left-center-right] Center visual focal point: {product layout description} [Overall layout requirements] All products standing upright facing the viewer. Height differences create stepped layering. Appropriate blank spacing between left/right zones and center zone for breathing room. Dense and full product arrangement, at least 40+ individual units. Nothing else besides products and white matte metal display stands, absolutely no hands, fingers, arms, or any human body parts. Even lighting. Pure still-life product display photo with no human presence whatsoever.
⚠️ Do NOT include "leave hand-holding space at front" in the layout — hand-held products are for the host persona image; the product shelf is pure product display.
5.6 User Product Photo (Optional)
When the user provides a real product photo:
a) Background removal: Select strategy based on product photo background
| Product Background | Removal Method |
|---|
| White/light solid background | HSV threshold to remove white areas |
| Dark solid background | HSV threshold to remove corresponding dark color |
| Complex scene background | GrabCut or Rembg |
import cv2
import numpy as np
def remove_white_bg(img_path, output_path):
"""Remove white/light background"""
img = cv2.imread(img_path)
hsv = cv2.cvtColor(img, cv2.COLOR_BGR2HSV)
mask_w = cv2.inRange(hsv, np.array([0, 0, 200]), np.array([180, 30, 255]))
mask_g = cv2.inRange(hsv, np.array([0, 0, 160]), np.array([180, 50, 240]))
mask = cv2.bitwise_or(mask_w, mask_g)
k = cv2.getStructuringElement(cv2.MORPH_ELLIPSE, (7, 7))
mask = cv2.morphologyEx(mask, cv2.MORPH_CLOSE, k, iterations=5)
mask = cv2.morphologyEx(mask, cv2.MORPH_OPEN, k, iterations=3)
mask = cv2.GaussianBlur(mask, (5, 5), 0)
mask = (mask > 200).astype(np.uint8) * 255
b, g, r = cv2.split(img)
cv2.imwrite(output_path, cv2.merge([b, g, r, 255 - mask]))
b) Product Shelf Prompt adjustment: Leave center area blank for user's product
In the product shelf prompt, change the center zone description to:
"Leave sufficient blank space in the center area for the main featured product
(about 30% of center area kept clean), surrounding products arranged by
layered cluster plus left-right mirror plus front-back progression logic"
c) Composite overlay: User product photo scaled and placed at center of product area
up_target_w = int(cw * 0.25)
ups = up_target_w / user_product.width
up_resized = user_product.resize((int(user_product.width * ups), int(user_product.height * ups)), Image.LANCZOS)
upx = (cw - up_resized.width) // 2
upy = pdy + int(pdr.height * 0.05)
canvas.paste(pdr, (0, pdy), pdr)
canvas.paste(up_resized, (upx, upy), up_resized)
canvas.paste(tr, (tx, ty), tr)
5.7 Benefits Bar Prompt
Template:
Symmetrical left-right composition, eye-level view. Core elements in upper half: three simple benefit icons, with corresponding text below: "[BENEFIT 1] / [BENEFIT 2] / [BENEFIT 3]". Background [background description]. Style: flat design, minimalist lighting. Color: [primary color], clean and elegant.
VI. Image Generation API
| Item | Content |
|---|
| Endpoint | https://ark.cn-beijing.volces.com/api/v3/images/generations |
| Method | POST |
| Content-Type | application/json |
| General model | doubao-seedream-4-5-251128 |
| Persona model | doubao-seedream-5-0-260128 (host persona component only) |
Request parameters
{
"model": "doubao-seedream-4-5-251128",
"stream": false,
"watermark": false,
"sequential_image_generation": "disabled",
"prompt": "<prompt in Chinese>",
"size": "<width>x<height>"
}
Request example
curl -s "https://ark.cn-beijing.volces.com/api/v3/images/generations" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <API_KEY>" \
-d '{
"model": "doubao-seedream-4-5-251128",
"stream": false,
"watermark": false,
"sequential_image_generation": "disabled",
"prompt": "prompt content",
"size": "1440x2560"
}'
VII. Green Screen Removal
Execute green screen removal on components 2 (Title Banner), 3 (Host Persona), 4 (Pricing Card), and 5 (Product Shelf).
import cv2
import numpy as np
def remove_green(img_path, output_path):
img = cv2.imread(img_path)
hsv = cv2.cvtColor(img, cv2.COLOR_BGR2HSV)
mask1 = cv2.inRange(hsv, np.array([35, 80, 80]), np.array([85, 255, 255]))
mask2 = cv2.inRange(hsv, np.array([30, 40, 120]), np.array([90, 255, 255]))
mask = cv2.bitwise_or(mask1, mask2)
k = cv2.getStructuringElement(cv2.MORPH_ELLIPSE, (5, 5))
mask = cv2.morphologyEx(mask, cv2.MORPH_CLOSE, k, iterations=3)
mask = cv2.morphologyEx(mask, cv2.MORPH_OPEN, k, iterations=2)
mask = cv2.GaussianBlur(mask, (3, 3), 0)
mask = (mask > 127).astype(np.uint8) * 255
b, g, r = cv2.split(img)
rgba = cv2.merge([b, g, r, 255 - mask])
cv2.imwrite(output_path, rgba)
VIII. Composite Preview
⚠️ Layout parameters differ from original skill
Layout Parameters
layout = {
"title": {"scale": 0.95, "pos": "center-top", "y_pct": 0.07},
"person": {"scale": 0.70, "pos": "left", "x_pct": 0.15, "y_pct": 0.14},
"promo": {"scale": 0.40, "pos": "right", "x_pct": 0.55, "y_pct": 0.22},
"product": {"zoom": 1.2, "pos": "bottom-full", "above": "benefit"},
"benefit": {"scale": 1.0, "pos": "bottom-full"},
}
Composite Code
from PIL import Image
def compose_preview(bg_path, person_nobg, title_nobg, promo_nobg, product_nobg, benefit_path, output_path):
bg = Image.open(bg_path).convert("RGBA")
cw, ch = bg.size
def fit(img, w_ratio, center=True):
w = int(cw * w_ratio)
s = w / img.width
r = img.resize((w, int(img.height * s)), Image.LANCZOS)
x = (cw - w) // 2 if center else cw - w
return r, x
def fit_full(img):
s = cw / img.width
return img.resize((cw, int(img.height * s)), Image.LANCZOS)
def zoom_crop(img, zoom):
w = int(cw * zoom)
s = w / img.width
h = int(img.height * s)
r = img.resize((w, h), Image.LANCZOS)
cx = (w - cw) // 2
return r.crop((cx, 0, cx + cw, h))
title = Image.open(title_nobg).convert("RGBA")
person = Image.open(person_nobg).convert("RGBA")
promo = Image.open(promo_nobg).convert("RGBA")
product = Image.open(product_nobg).convert("RGBA")
benefit = Image.open(benefit_path).convert("RGBA")
tr, tx = fit(title, 0.95); ty = int(ch * 0.07)
prr, prx = fit(promo, , center=); prx = (cw * ); pry = (ch * )
per, perx = fit(person, ); perx = (cw * ); pery = (ch * )
pdr = zoom_crop(product, ); pdy = ch - fit_full(benefit).height - pdr.height
bfr = fit_full(benefit); bfy = ch - bfr.height
canvas = bg.copy()
canvas.paste(prr, (prx, pry), prr)
canvas.paste(per, (perx, pery), per)
canvas.paste(pdr, (, pdy), pdr)
canvas.paste(tr, (tx, ty), tr)
canvas.paste(bfr, (, bfy), bfr)
canvas.convert().save(output_path, , quality=)
Post-processing: Host Brightness Boost
Boost the host layer brightness before compositing to prevent dark appearance:
from PIL import ImageEnhance
person_bright = ImageEnhance.Brightness(person).enhance(1.17)
⚠️ Only boost the host layer (17%). Do NOT touch other layers. The delivered 人物.png should also use the boosted version.
IX. Delivery & Packaging
Deliverables (Fixed 7 files)
| Filename | Format | Notes |
|---|
| 背景.png | PNG 1440×2560 | Full-bleed |
| 标题横卡.png | PNG 1440×2560 transparent | Content at preview position |
| 人物.png | PNG 1440×2560 transparent | Brightness boosted (don't label "boosted") |
| 促销竖卡.png | PNG 1440×2560 transparent | Content at preview position |
| 桌面商品贴.png | PNG 1440×2560 transparent | Content at preview position |
| 权益下贴.png | PNG 1440×2560 transparent | Content at preview position |
| 预览.jpg | JPG 1440×2560 | Composite preview |
If a user product photo is provided, it will be composited into the center of the product shelf — not delivered separately.
Delivery Methods (Auto-select based on channel)
Method 1: Send in chat (when channel supports file sending)
- Send preview image (
预览.jpg) to chat first
- Send zip archive (named
{Brand}_livestream_overlays.zip, containing all 7 files)
cd output/
zip -j "../{Brand}_livestream_overlays.zip" 背景.png 标题横卡.png 人物.png 促销竖卡.png 桌面商品贴.png 权益下贴.png 预览.jpg
Method 2: Desktop folder (when channel doesn't support file sending)
- Create folder on user's desktop named
{Brand}_overlays
- Put only the 7 files inside — no intermediate files, no zip
- Use
open command to show the preview image
- Use
open command to open the folder
⚠️ Note: webchat (Control UI) does not support file sending — use Method 2. Feishu, WeChat etc. use Method 1.
X. Complete Workflow
1. Collect requirements (brand, promotion, optional: user product photo)
2. Analyze brand style → determine color palette
3. Design host appearance (youthful face + watery eyes + jelly lips + outfit + hairstyle + accessories)
4. Auto-generate missing copy
5. Write prompts for all 6 components (host uses v2 template, no hand-held products)
- If user product photo: leave center blank in product shelf prompt
6. General components → doubao-seedream-4-5-251128, host → doubao-seedream-5-0-260128
7. Green screen removal on components 2/3/4/5
8. Boost host layer brightness by 17% (ImageEnhance.Brightness 1.17)
9. [Optional] Remove background from user product photo (white/light bg → HSV threshold)
10. Composite preview (use boosted host, user product overlaid at center of product area)
11. Package and deliver
