Skill: fashion-video-creator

Overview

Generate complete assets for fashion e-commerce videos from scratch: a virtual model image (Seedream text-to-image) + a Seedance 2.0 video prompt with dialogue, actions, and scene + an operator SOP for the Jimeng platform. Supports single and batch modes.

When to Activate

User query contains any of:

• "穿搭视频", "outfit video", "生成模特", "虚拟模特"
• "seedance prompt", "穿搭创作", "带货视频", "带货短视频"
• "帮我做个穿搭视频", "批量生成穿搭", "batch prompt"
• "帮我拍个带货视频", "我有件衣服想做个展示视频", "做个穿搭短视频"
• "generate fashion video", "create outfit content"

Do NOT activate for:

• Analyzing / reverse-engineering existing videos -> use viral-video-replicator
• "这个视频怎么拍的", "帮我复刻这个视频" -> use viral-video-replicator
• Pure image generation without video prompt -> direct Seedream API call
• Non-fashion video generation -> not applicable

Prerequisites

This skill requires a Volcano Engine (火山方舟) account with Seedream model access.

Required: ARK_API_KEY + Seedream model/endpoint ID
Optional: None (all other logic is local)

Clarification Flow

Phase 1: API Key Acquisition

Ask these questions IN ORDER. Use plain language — the user may not be technical.

Q1: Image Generation Service

> "你需要先有一个能生成图片的 AI 服务账号。目前这个工具使用的是火山方舟平台的 Seedream 模型。

> 你有火山方舟的账号吗？如果有，请提供你的 API Key（在火山方舟控制台 -> API Key 管理中可以找到）。"

If user has no account -> STOP. Guide them to register at 火山方舟. Do NOT proceed without API key.

Q2: Model Version

> "火山方舟上有两个版本的图片生成模型：

> - Seedream 5.0（推荐）：理解能力更强，生成的人像更自然，每张约 0.22 元

> - Seedream 4.5：可以更精细地控制细节，每张约 0.32 元

>

> 你开通了哪个？需要提供模型ID或接入点ID。"

Phase 2: Mandatory Recommendations

MUST show before proceeding. These are not optional tips — violating them degrades output quality:

============================================================
API Configuration — Mandatory Recommendations
============================================================

[REQUIRED] Seedream 5.0 endpoint preferred
  WHY: 5.0 uses internal Chain-of-Thought reasoning, making natural
  language prompts significantly more effective. 4.5 relies on keyword
  stacking which loses semantics in complex body descriptions.
  If only 4.5: use model ID doubao-seedream-4-5-251128 or newer.

[REQUIRED] Realism scale 40-60
  WHY: Below 30 the output looks cartoonish (Pixar-style), unsuitable
  for product videos that need believable human models. Above 80 triggers
  uncanny valley artifacts and skin texture glitches.

[WARNING] Using older models or non-recommended endpoints will produce
noticeably worse portrait realism and clothing detail accuracy.
============================================================

Phase 3: Mode Selection

> "你要生成几条视频？单条还是批量？"

Phase 4: Creative Parameter Collection

Collection strategy — ask in 2 rounds, never more than 4 questions per round:

Round 1 (required — must have before executing):

1. Model gender (female/male) — default: female
2. Garment type (dress/top/pants/jacket/suit/casual) — NO default, must ask. WHY: "default" type produces generic dialogue without product-specific selling points. Defensive fallback: If user declines to specify after 2 attempts, fall back to "default" with warning: "Using generic dialogue — conversion effectiveness will be lower than type-specific scripts."
3. Scene (11 presets or custom text) — default: modern_apartment

Round 2 (enhanced — use defaults if not stated):

1. Model appearance: preset (9 templates) / body params / custom desc — default: asian_female_slim
2. Realism (0-100) — default: 40
3. Style: realism / pixar / anime_realistic — default: realism
4. Dialogue style: natural / professional / enthusiastic — default: natural
5. Camera: vlog / pro / static — default: vlog
6. Target audience: auto / female / male — default: auto
7. Duration (5-40s) — default: 10
8. Language: zh / en — default: zh
9. Task label (batch only)

Batch shortcut: If all tasks share config, ask once and apply to all. Only collect per-task differences.

Batch-Specific Recommendations

When batch mode selected, ADDITIONALLY show:

============================================================
Batch Mode — Additional Recommendations
============================================================

[REQUIRED] Specify exact garment type per task — do NOT use "default"
  WHY: Each garment type has 500+ chars of specialized dialogue with
  product-specific hand gestures (e.g., dress: pull hem to show fabric;
  pants: flip waistband to show grip strip). "default" loses all this.

[RECOMMENDED] Same gender per batch
  WHY: Mixing genders creates inconsistent dialogue tone — female uses
  filler words and emotional reactions, male is direct and factual.

[REQUIRED] Duration 10-15 seconds
  WHY: Under 5s cannot complete a product showcase. Over 15s triggers
  multi-segment auto-chaining which requires manual "extend" operations.
============================================================

Core Workflow

Step 0: Verify API Key (mandatory, never skip)

Platform-adaptive verification:

If bash/Python available (Claude Code, terminal):

import httpx
resp = httpx.get(f"{ARK_API_BASE}/api/v3/models",
                 headers={"Authorization": f"Bearer {ARK_API_KEY}"}, timeout=10)
# 200 -> proceed. 401/403 -> key invalid. Timeout -> network issue.

If no code execution (Claude.ai web, chat-only):

Trust the user-provided key and proceed. Mark internally: api_verified: false.

If Step 3 (image generation) fails with 401 -> surface the error then.

• Key valid -> proceed to Step 1
• Key invalid (401/403) -> report error, ask user to verify. Do NOT proceed.
• No code execution -> proceed with unverified key, validate on first API call.

Single Mode

Step 1: Collect parameters (2 rounds max)
Step 2: Build model prompt (version-aware: 4.5 keyword / 5.0 natural language)
Step 3: Call Seedream API -> generate model image (720x1280, 9:16)
Step 4: Build Seedance prompt -> compose dialogue + actions + scene + camera
        Read references/dialogue-library.md for garment-specific scripts
        Read references/prompt-assembly.md for assembly rules
Step 5: Generate SOP
Step 6: If duration > 15s -> build chained multi-segment extend plan
Step 7: Validate output (see below)

Batch Mode

Step 0: Verify API key
Step 1: Collect batch size + per-task configs (2 rounds)
Step 2: Validate all configs (garment type != "default"?)
Step 3: For each task (sequential):
  a. Build model prompt
  b. Call Seedream API (if image needed)
  c. Compose dialogue (opening + core + closing) from dialogue-library.md
  d. Compose actions (garment-specific choreography)
  e. Assemble Seedance prompt
  f. If duration > 15s: build chained segments
  g. Generate SOP
  h. Mark task: completed / failed
Step 4: Validate all outputs
Step 5: Return results with progress summary

Progress: queued -> processing -> completed/failed
Partial success: batch completes even if some tasks fail.

Output Validation (mandatory, never skip)

Before delivering results, verify ALL:

• [ ] Model image is 9:16 portrait with full body visible (head to feet)?
• [ ] Prompt contains @image1 (garment) and @image2 (model ref)?
• [ ] Dialogue matches the selected garment type (not generic "default")?
• [ ] SOP specifies correct image upload order (image1=garment FIRST)?
• [ ] If chained: every segment has continuation prompt + dialogue preview?
• [ ] Brand constraint present: "Do not alter clothing pattern, color, texture or style"?

Any NO -> fix before delivering. Do NOT send unvalidated output.

Error Handling

Degraded Mode: Prompt-Only (when image generation fails)

If Seedream API is unreachable or fails after retry, do NOT block the entire workflow.

Skip image generation, still deliver prompt + SOP. Mark output clearly:

[Note] Model image generation unavailable (API error). Prompt and SOP generated successfully.
Use your own model photo as @image2 when operating on the Jimeng platform.

This ensures the user gets the valuable prompt + SOP even without the AI-generated model image.

Usage Example

Input: "帮我做一个女性穿搭视频，裙子类型，现代公寓场景"

Resolved params: gender=female, garment=dress, scene=modern_apartment, realism=40, style=realism, dialogue=natural, camera=vlog, audience=auto->female, duration=10, lang=zh

Output 1 — Model Image: 720x1280 PNG (asian_female_slim preset, realism=40)

Output 2 — Seedance Prompt:

一位面容和身材参考@图片2的年轻女性穿着@图片1中的服装，在简约现代的白色公寓客厅中，自然光从落地窗照入。她面朝镜头表情生动自然地展示服装，右手拉起裙摆展示面料（始终用右手），右手翻开裙摆内侧展示车线做工，小幅转身让裙摆飘动，右手捏腰部展示松紧设计，对着镜头说：「姐妹们你们快看...哇，不是，我真的没想到这条裙子上身效果这么好。你看这个面料，是那种...嗯...醋酸缎面的...（右手轻轻拉起裙摆展示）滑滑的凉凉的，而且有一定的厚度，不是那种廉价的薄纱感。然后你看这个车线...（右手翻开裙子内侧给镜头看）全部是包边走线的，没有毛边，做工真的很扎实。裙摆是A字的微微伞摆，你看我转一下...（转了一圈）你看它飘起来那个弧度，而且腰线这里有一个隐藏的松紧设计...（右手捏了捏腰部）不会勒但又收腰。你们猜多少钱？不到两百！超显腿长，闭眼入。」语气自然亲切，像在跟闺蜜视频通话。说话有停顿、有喘息、偶尔磕巴自我纠正，真实感强。Do not alter clothing pattern, color, texture or style. 手持vlog镜头感，竖屏9:16构图。音频要求：全程只有模特一个人的清晰人声，不出现第二个人的声音或对白。背景有符合场景的自然环境音，音量不超过人声的10%。视觉要求：全程保持中景到中近景，不要切到手部或脚部的特写镜头，避免手指变形问题。模特展示服装细节时始终使用右手操作，避免左右手切换导致的镜像翻转。全程画面中只有模特一人，不出现其他人物。

Output 3 — Operator SOP: Step-by-step for 即梦 platform (upload order, settings, quality checklist)

Domain Knowledge Role Declaration

> The reference files contain dialogue scripts, model presets, API specs, and prompt templates.

> Their role is to assist prompt assembly — providing the raw materials that get composed into Seedance prompts.

> They do NOT replace the execution workflow. Never output reference content directly as the final answer.

> Always assemble through the workflow: collect params -> build prompt -> validate -> deliver.

References