qstar-video-ecom（qstar 视频 ecom）

Qstar Video Ecom

Use this skill when the user wants to make a Chinese e-commerce short video quickly, especially for Douyin, Xiaohongshu, Taobao, Pinduoduo, JD, or WeChat Video.

Default value: keep the old one-click product video flow as the stable path, then layer newer video-factory style modes on top.

What this skill supports

This skill now has 4 modes:

1. classic

Classic one-click product video. Best when the user says "做个产品视频", "生成电商视频", "帮我出一条带解说的视频".

1. single-image

Single-image fast start. Best when the user already has one product image, poster, hero shot, or reference visual and wants to start from it.

1. batch-variants

Batch multiple short-video variants from one product brief. Best when the user wants several hooks, tones, or platform versions in one go.

1. revise

Natural-language revision mode. Best when the user already has a generated video and says things like "把背景换掉", "节奏快一点", "换成男声", "再来 3 个版本".

If the user does not specify a mode, use classic.

Important boundary

Do not pretend the backend already has magical edit APIs if it does not.

For newer modes:

• If the current bot.guanma.top/sora-api endpoints can support the request with the existing generate flow, use them.
• If the request exceeds current API capability, convert the user intent into a structured generation brief and explain that you are using the nearest supported workflow.
• Prefer a truthful fallback over a fake "done".

Step 0 — Extract USER_ID

Extract platform and sender_id from the current session key and convert to {platform}:{sender_id}.

Examples:

• agent:main:telegram:direct:5239705501 -> tg:5239705501
• agent:main:wechat:direct:oh8CU6xxx -> wx:oh8CU6xxx
• agent:main:wecom:direct:zhangsan -> wecom:zhangsan
• agent:main:feishu:direct:ou_xxx -> feishu:ou_xxx
• agent:main:slack:direct:U12345 -> slack:U12345

Always inline the real value into commands. Do not rely on shell variables.

Step 1 — Detect mode

Route by user intent:

• classic

User wants one finished e-commerce short video and has no advanced request.

• single-image

User gives or mentions a specific product image / hero image / visual reference and wants to start from that one image.

• batch-variants

User asks for multiple versions, multiple hooks, multiple platforms, multiple tones, or "批量跑素材".

• revise

User already has an existing video and wants changes in plain language.

If mixed, prefer: revise > batch-variants > single-image > classic

Step 2 — Check profile

curl -s https://bot.guanma.top/sora-api/user/profile/{USER_ID}

If onboarded: false, run the onboarding flow before generation.

Opening message:

🎬 欢迎使用 AI 电商视频生成！

📌 使用须知：
• 免费版：每天 1 次，仅支持通用商品视频
• 付费版：不限次数，支持上传产品实拍图，生成更贴近真实商品的视频

如果你想做“基于真实产品图”的视频，建议使用付费版。

Ask:

1. 你主要在哪个平台经营？（淘宝/小红书/抖音/其他）
2. 你的主营产品类目是？（服装/数码/美妆/食品/其他）
3. 售后联系方式（选填，可跳过）

Then:

curl -s -X POST https://bot.guanma.top/sora-api/user/onboard \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "{USER_ID}",
    "main_platform": "{用户回答1}",
    "category": "{用户回答2}",
    "contact": "{用户回答3}"
  }'

Step 3 — Mode-specific intake

Mode A: classic

Follow the stable old flow:

1. Ask target platform
2. Ask script style template
3. Ask product name + 2-3 core selling points
4. Ask voice choice
5. Check quota
6. If paid, allow product image upload
7. Generate one finished video

Mode B: single-image

Ask for:

1. Target platform
2. Product name
3. One-sentence video goal
4. 2-3 selling points
5. Voice choice
6. One image upload or image URL

Then convert the brief into a structured product field like:

[mode:single-image][platform:douyin] 产品名：{产品名}；目标：{视频目标}；卖点：{卖点列表}；要求：基于已上传图片生成，保留商品核心外观。

If the image is available and the user has paid quota, prefer passing a direct public image_url. Only use the documented upload endpoint if it is confirmed live in the current environment. If image upload is unavailable, say you are falling back to the standard image-assisted generation path.

Mode C: batch-variants

Ask for:

1. Target platform or platforms
2. Product name
3. Core selling points
4. Number of variants
5. Preferred dimensions of variation:

- hook - tone - audience - CTA - voice

Then produce a variant plan first, for example:

• Variant 1: price-shock
• Variant 2: bestie recommendation
• Variant 3: curiosity bait

Run the current generation path once per variant if the backend only supports single-job generation. Do not claim server-side batch execution unless it truly exists.

Mode D: revise

Ask for:

1. Existing video link or generation context
2. What to change, in plain language
3. Whether the user wants:

- overwrite-style replacement - one more revised version - several revised versions

Translate the user's request into a structured revision brief:

• scene/background change
• faster/slower rhythm
• stronger CTA
• female/male voice
• platform-specific format
• more dramatic / more everyday / more premium tone

If no true edit API exists, tell the user you are generating a revised new version instead of frame-accurate editing.

Step 4 — Platform choice

Use this mapping:

1 淘宝/天猫 -> taobao
2 拼多多 -> pinduoduo
3 小红书 -> xiaohongshu
4 抖音/TikTok -> douyin
5 京东 -> jingdong
6 视频号 -> shipinhao

Prompt:

请选择视频发布平台：
1️⃣ 淘宝/天猫（16:9，8秒）
2️⃣ 拼多多（16:9，4秒）
3️⃣ 小红书（9:16，8秒）
4️⃣ 抖音/TikTok（9:16，8秒）
5️⃣ 京东（16:9，8秒）
6️⃣ 视频号（9:16，8秒）

Step 5 — Script style template

For classic and most batch-variants cases, use the proven template system. Template details live in TEMPLATES.md.

Prompt:

请选择视频文案风格：
1️⃣ 痛点共鸣型
2️⃣ 价格冲击型
3️⃣ 闺蜜种草型
4️⃣ 专业测评型
5️⃣ 反常识悬念型
6️⃣ 自由描述

Map:

• 1 -> T1痛点共鸣
• 2 -> T2价格冲击
• 3 -> T3闺蜜种草
• 4 -> T4专业测评
• 5 -> T5反常识悬念
• 6 -> free自由描述

When the user chooses 1-5, auto-build the product brief using the template style plus platform.

Step 6 — Voice choice

Prompt:

请选择解说声音：
🎙️ 1. 晓晓（女声·温柔）
🎙️ 2. 云希（男声·稳重）

Map:

• 1 -> female
• 2 -> male

Step 7 — Quota and image upload

Check quota:

curl -s https://bot.guanma.top/sora-api/quota/{USER_ID}

If credits > 0, allow image upload:

📸 是否上传产品实拍图？上传后视频会更贴近你的真实商品。
直接发图即可，或回复“跳过”。

If the user sends an image, first obtain a public image URL through the host platform's image handling path, then:

curl -s -X POST "https://bot.guanma.top/sora-api/upload-image?user_id={USER_ID}" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "{用户图片的公网URL}"}'

Read image_url from the response.

If that endpoint returns 404 or equivalent unavailability, do not loop on the upload flow. Pass the original public image URL directly in the generate request instead.

The image URL must be reachable by the generation backend, not just by the local machine. Avoid internal-only hosts or asset domains that fail public DNS resolution.

If free user or skipped upload, keep image_url empty.

Step 8 — Generate

Tell the user generation is running:

正在生成，约需 3 分钟，请稍候...

Then:

curl -s -X POST https://bot.guanma.top/sora-api/generate \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "{USER_ID}",
    "platform": "{platform_key}",
    "product": "{结构化产品描述}",
    "voice": "{voice_key}",
    "image_url": "{产品图URL或空字符串}"
  }' \
  --max-time 400

Step 9 — Response handling

If success:

• With uploaded image:

🎬 个性化视频已生成！基于你的产品图定制。

• Free quota no image:

🎬 视频已生成！今日免费次数已用完，充值后可上传产品图生成更贴近真实商品的视频。

• Paid quota no image:

🎬 视频已生成！如需更贴近真实商品的版本，可继续上传产品图重新生成。

For batch-variants, summarize all successful outputs clearly by variant label. For revise, explicitly say this is a revised version if you had to regenerate rather than edit in place.

If HTTP 402 or quota exceeded: run the payment flow.

Step 10 — Payment flow

Show:

今日免费次数已用完 😅

升级付费版，解锁：
✅ 不限次数生成
✅ 上传产品实拍图，生成更贴近真实商品的视频

选择套餐：
1️⃣ 5次视频 · ¥39
2️⃣ 10次视频 · ¥69（最划算）
3️⃣ 20次视频 · ¥128

Then ask payment channel:

请选择支付方式：
💚 1. 微信支付
💙 2. 支付宝

Create order:

curl -s -X POST "https://bot.guanma.top/sora-api/pay/create?user_id={USER_ID}&package={套餐价格}&channel={channel}"

Read order_id, amount, qr_url. Send the QR image first, then:

请扫码完成支付 👆
订单号：{order_id}
金额：¥{amount}

支付完成后系统会自动到账，无需截图。

Poll every 10 seconds, up to 18 times:

curl -s https://bot.guanma.top/sora-api/pay/status/{order_id}

If status == "paid":

✅ 支付成功！额度已到账，现在可以继续生成视频了。

Then return to Step 7.

If timeout:

支付还未到账，可稍后发送“继续生成”重试。

Operating rules

• Prefer the stable classic mode unless the user clearly wants a newer mode.
• Use single-image when the image is the center of the request, not just an optional add-on.
• Use batch-variants when the user cares about scale or testing multiple hooks.
• Use revise when the user wants changes to an existing output.
• Be explicit when a "revision" is actually a new regenerated version.
• Never hide quota/payment boundaries.

Data and privacy

This skill is provided by Q-star via https://guanma.top.

• Transmitted data:

- product description text - optional public product image URL - platform-linked user ID - optional contact info

• Transport:

- HTTPS API calls to bot.guanma.top

• Storage:

- generated videos are stored in Qiniu for delivery

• This skill does not read local files directly
• This skill does not access system credentials
• Payment QR codes are generated by the payment provider bound to Q-star services