Yike Storyboard Creation Skill
Help users complete the AI video creation workflow from novel/script to storyboard via conversational interface.
Prerequisites
1. Aliyun CLI Check
Pre-check: Aliyun CLI >= 3.3.1 required
CODEBLOCK0
Verify version >= 3.3.1. If not installed or version is too low, refer to references/cli-installation-guide.md.
Then [MUST] run the following commands to configure CLI:
CODEBLOCK1
2. ICE Plugin Installation
Pre-check: ICE CLI Plugin required
> aliyun plugin install --names ice
>
Verify plugin is installed:
CODEBLOCK3
Service Activation
1. Activate IMS (Intelligent Media Services)
Activation Link: https://ice.console.aliyun.com/guide/default
Log in with your Alibaba Cloud account and activate ICE Intelligent Media Services.
2. Log in to yikeai platform
Platform Link: https://www.yikeai.com/#/home
Visit the product website and authorize login with your Alibaba Cloud account.
Currently Wanjing Yike is in invitation-only phase. Click Apply for Access to submit your application.
Credential Verification
Pre-check: Alibaba Cloud Credentials Required
Security Rules:
- - DO NOT read, print, or output AK/SK values
- ONLY USE
aliyun configure list to check credential status
CODEBLOCK4
If no valid profile exists, STOP and:
- 1. Get credentials from Alibaba Cloud Console
- Run
aliyun configure to set up credentials
RAM Permissions
This skill requires ICE permissions: ice:CreateYikeAssetUpload, ice:SubmitYikeStoryboardJob, ice:GetYikeStoryboardJob.
For complete permission policies, see references/ram-policies.md.
[MUST] Permission Error Handling: When any command fails due to permission errors, read references/ram-policies.md for required permissions.
Parameter Confirmation
Confirm key parameters with user before file upload through natural dialogue.
| Parameter | Required | Description | Default |
|---|
| file_path | ✅ | Text file path (txt/docx, ≤5MB, ≤30K chars) | User provides |
| title |
✅ | Storyboard title | Extract from text |
| source-type | ✅ |
Novel or
Script | Based on content analysis |
| style | ✅ | Visual style ID | Based on genre |
| voice | ✅ | Narration voice ID | Based on protagonist |
| shot-split-mode | ✅ | Shot split mode | Based on narrative style |
| ratio | Optional |
16:9,
9:16,
4:3,
3:4 |
9:16 |
| resolution | Optional |
720P,
1K,
2K,
4K |
720P |
See Task 0: Parameter Confirmation for recommendation guide.
Text Type Classification
| Type | Value | Description |
|---|
| Novel | INLINECODE18 | Primarily narrative, descriptive, psychological content for reading |
| Script |
Script | Primarily scenes, dialogue, action descriptions for performance/filming |
Classification Guide:
Evaluate the following features to determine if text is novel or script (don't judge solely by dialogue presence - novels can have extensive dialogue too):
| Feature | Script | Novel |
|---|
| Scene Markers | ✅ Has scene numbers, time, location, INT/EXT | ❌ No explicit scene markers |
| Structure |
✅ "Character Name + Dialogue" dominant | ❌ Narrative text dominant |
| Action Cues | ✅ Has stage directions, camera directions | ❌ No performable features |
| Literary Expression | ❌ Minimal | ✅ Rich environmental descriptions, psychology, emotions |
Classification Rules:
- 1. Script: Dominated by scenes, dialogue, action descriptions
- Novel: Dominated by narration, description, psychological activity
- Mixed Content: Determine dominant feature, output "more like script" or "more like novel"
Important: After classification, confirm text type with user or let user specify directly.
Core Workflow
Task 0: Parameter Confirmation
Before upload, analyze the text and confirm key parameters with the user.
Step 1: Analyze Text Content
CODEBLOCK5
Determine: genre, narrative style (first/third person), protagonist characteristics.
Step 2: Recommend & Confirm Parameters
Based on analysis, make recommendations and confirm with user through natural dialogue.
Recommendation Guide:
| Parameter | Based On | Examples |
|---|
| style | Genre | Modern Urban → CinematicRealism; Period Drama → RealisticGuzhuangPro; Fantasy → RealisticXianxia; Anime → INLINECODE23 |
| voice |
Protagonist | Young Female →
sys_ClassicYoungWoman; Young Male →
sys_GentleYoungMan; Mature Male →
sys_CalmDeepMale |
| shot-split-mode | Narrative | Third person →
thirdPersonNarration; First person →
firstPersonNarration; Dialogue-heavy Script →
dialogue |
| ratio | Platform | TikTok/Douyin →
9:16; YouTube →
16:9 |
| resolution | Quality | Default
720P; Higher quality
1K/
2K/
4K |
Defaults: 9:16, 720P (vertical HD for mobile)
⚠️ Constraint: dialogue mode is ONLY available for Script type, NOT for Novel.
Example confirmation dialogue:
"Based on your modern urban romance novel, I recommend:
- - Style:
CinematicRealism (film-quality, great for emotional scenes) - Voice:
sys_ClassicYoungWoman (matches your young female protagonist) - Shot Mode:
thirdPersonNarration (for third-person narrative) - Format:
9:16, 720P (vertical HD for mobile platforms) - Title: "雨夜归途"
Does this look good, or would you like to change anything?"
If user has no preference, use recommended defaults. For full options, see Style Mapping Table and Voice Mapping Table.
DO NOT proceed to Task 1 until user confirms.
Task 1: Upload Text File to OSS
Prerequisite: Task 0 (Parameter Confirmation) MUST be completed.
Use helper script to automatically get credentials and upload:
CODEBLOCK6
Returns: FileURL (for subsequent job submission)
Task 2: Submit Storyboard Job
CODEBLOCK7
For complete parameter reference, see references/related-commands.md.
Task 3: Query Job Status
CODEBLOCK8
For complete parameter and response reference, see references/related-commands.md.
Status Flow and User Prompts:
| Status | SubStatus | Current Phase | User Prompt | Action |
|---|
| Configuring | Parsing | Entity Asset Parsing | "Parsing your script, AI is extracting characters, scenes and props..." | Wait |
| Configuring |
ParseSucc | Entity Asset Image Generation | "Script parsed! Now generating images for characters, scenes and props. You can preview the progress here:" |
Provide Entity Management Link |
| Editing | Creating | Shot Script Generation | "Entity assets ready! Now creating shot script, almost done..." | Wait |
| Editing | CreateSucc | Complete ✅ | "Shot script complete! You can now view and edit your storyboard:" |
Provide Editing Link |
| Editing | CreateFailed | Failed ❌ | "Shot script generation failed, please check error message or resubmit." | Troubleshoot |
Interactive Links:
| Status | Link | Purpose |
|---|
| ParseSucc | INLINECODE47 | Preview entity assets (characters, scenes, props) generation progress |
| CreateSucc |
https://www.yikeai.com/#/storyboard/editing?storyboardId={storyboardId} | Edit storyboard, generate videos, export final video |
Job Status Description:
| JobStatus | Description | User Prompt |
|---|
| Running | Job in progress | "Job is processing, usually takes a few minutes, please wait..." |
| Succeeded |
Job succeeded | "Job completed!" |
| Failed | Job failed | "Job failed, please check error message." |
| Suspended | Job suspended | "Job suspended, some shots failed, can be manually fixed in storyboard." |
Query Recommendation: Jobs usually take a few minutes. Recommend querying status every 30 seconds.
Task 4: Get Storyboard Link
Get storyboardId from JobResult.StoryboardInfoList and construct link:
CODEBLOCK9
Style Mapping Table
| StyleId | Name |
|---|
| RealisticPhotographyPro | Realistic Photography Pro |
| RealisticGuzhuangPro |
Realistic Chinese Period Pro |
| RealisticPhotography | Realistic Photography |
| RealisticGuzhuang | Realistic Chinese Period |
| RealisticXianxia | Realistic Xianxia |
| RealisticEra | Realistic Period |
| RealisticWasteland | Realistic Wasteland |
| GuofengAnime | 2D Chinese Style Anime |
| GuofengAnime3D | 3D Chinese Style Anime |
| Cartoon3D | 3D Cartoon |
| Photorealistic3D | Photorealistic 3D Render |
| SciFiRealism | Sci-Fi Realism |
| Chibi3D | 3D Chibi |
| ShojoManga | Shojo Manga |
| NewPeriodAnime | New Era Anime |
| FairyTale2D | 2D Fairy Tale |
| Wasteland2D | 2D Wasteland |
| InkWuxia | Ink Wuxia |
| ShadiaoMeme | Panda Meme Style |
| Chibi2D | 2D Chibi |
| Ghibli | Ghibli |
| SciFiComic | Cyberpunk |
| AmericanSuperhero | American Superhero |
| Hokusei | Hokusei |
| RealisticComic | Realistic Comic |
| CinematicRealism | Cinematic Realism |
| MinimalistRealism | Minimalist Realism |
| ShonenManga | Shonen Manga |
Narration Voice Mapping Table
| Voice ID | Description |
|---|
| sysClassicMiddleAgedWoman | Classic Female Narrator (25-45, wise) |
| sysClassicYoungWoman |
Classic Young Female (18-25, intellectual) |
| sys_IntellectualYoungWoman | Intellectual Young Female (18-25, intellectual) |
| sys_GentleYoungMan | Gentle Young Male (18-25, gentle) |
| sys_WiseYoungMan | Wise Young Male (18-25, wise) |
| sys_ClassicYoungMan | Classic Young Male (18-25, charming) |
| sys_thoughtfulBoy | Thoughtful Boy (10-15, well-behaved) |
| sys_SereneIntellect | Serene Intellectual Male (18-25, cool and rational) |
| sys_RichBassMale | Rich Bass Male (18-25, deep voice) |
| sys_CalmDeepMale | Calm Deep Male (25-40, steady and deep) |
| sys_MajesticBaritone | Majestic Baritone (40-60, authoritative) |
| sys_GravellySoulful | Gravelly Soulful Male (40-60, weathered) |
| sys_SweetBrightGirl | Sweet Bright Girl (10-15, lively) |
| sys_GracefulPoisedWoman | Graceful Poised Woman (18-25, elegant) |
| longbaizhi | Long Baizhi (20-30, witty female narrator) |
| sys_YoungGracefulWoman | Young Graceful Woman (18-25, gentle) |
| sys_MaturePoisedWoman | Mature Poised Woman (25-40, graceful) |
| sys_MatureWiseWoman | Mature Wise Woman (25-40, elegant and wise) |
| sys_ElderlyWistfulWoman | Elderly Wistful Woman (40-60, nostalgic) |
Shot Split Mode
| Mode | Description | Use Case | Supported Type |
|---|
| dialogue | Dialogue Mode | Dialogue-heavy scripts, short dramas | Script only |
| firstPersonNarration |
First Person Narration | Stories from protagonist's perspective, diary style | Novel/Script |
| firstPersonNarrationPureVO | First Person Pure VO | Inner monologue stories, prose | Novel/Script |
| thirdPersonNarration | Third Person Narration | Omniscient perspective stories, fairy tales, historical | Novel/Script |
Restriction: When source-type is Novel, dialogue mode is NOT supported.
Recommendation Guide:
Choose appropriate mode based on text type and content analysis:
Script:
- 1. High dialogue ratio (short dramas, chat format, comedy) → Recommend INLINECODE54
- First person narration → Recommend INLINECODE55
- Pure inner monologue/narration (prose, reflections) → Recommend INLINECODE56
- Third person narration → Recommend INLINECODE57
Novel:
- 1. "I" perspective + has dialogue (urban romance, mystery) → Recommend INLINECODE58
- Pure inner monologue/narration (prose, reflections) → Recommend INLINECODE59
- Third person narration (fairy tales, mythology, history) → Recommend INLINECODE60
Important: Before execution, describe mode features to user and let them confirm or choose.
Capability Scope
This skill automates:
- - Upload novel/script files to OSS
- Entity asset parsing (characters, scenes, props extraction)
- Entity asset image generation
- Shot script generation
- Job status tracking
After shot script completion, continue in UI:
Once the job reaches CreateSucc status, this skill's automation is complete. The following steps require the Yike Storyboard web interface:
- 1. Edit shot script - Adjust shot content, descriptions, and prompts
- Generate shot images/videos - AI generates images/videos for each shot
- Edit and assemble - Fine-tune timing, add transitions
- Export final video - Render and download the complete video
Next Step: Open the storyboard editing link and continue your video creation journey!
Reference Links
RAM Permission Policies |
|
references/related-commands.md | Related CLI Commands |
|
references/verification-method.md | Verification Methods |
Error Handling
| Error | Cause | Solution |
|---|
| MainAccountUserNotFound | Yike service not activated | Apply for access at Service Activation section |
| InvalidAccessKeyId |
Invalid AK/SK | Check credential configuration |
| Forbidden | Insufficient permissions | See RAM Permissions section |
| region can't be empty | OSS upload missing region | Add
--region cn-shanghai |
Note: If you receive MainAccountUserNotFound error, it means your account has not been whitelisted for the Yike service. Please visit https://www.yikeai.com and apply for access through the invitation application form.
Yike 分镜创作技能
通过对话界面帮助用户完成从小说/剧本到分镜的 AI 视频创作工作流。
前置条件
1. 阿里云 CLI 检查
预检查:需要阿里云 CLI >= 3.3.1
bash
aliyun version
确认版本 >= 3.3.1。如果未安装或版本过低,请参考 references/cli-installation-guide.md。
然后 [必须] 运行以下命令配置 CLI:
bash
启用自动插件安装
aliyun configure set --auto-plugin-install true
设置地域为 cn-shanghai(ICE 服务必需)
aliyun configure set --region cn-shanghai
2. ICE 插件安装
预检查:需要 ICE CLI 插件
bash
aliyun plugin install --names ice
确认插件已安装:
bash
aliyun ice --help
服务开通
1. 开通 IMS(智能媒体服务)
开通链接: https://ice.console.aliyun.com/guide/default
使用阿里云账号登录并开通 ICE 智能媒体服务。
2. 登录 yikeai 平台
平台链接: https://www.yikeai.com/#/home
访问产品网站并使用阿里云账号授权登录。
目前万镜·易刻处于邀测阶段。点击 申请体验 提交申请。
凭证验证
预检查:需要阿里云凭证
安全规则:
- - 禁止 读取、打印或输出 AK/SK 值
- 仅使用 aliyun configure list 检查凭证状态
bash
aliyun configure list
如果没有有效配置文件,请停止并:
- 1. 从 阿里云控制台 获取凭证
- 运行 aliyun configure 设置凭证
RAM 权限
本技能需要 ICE 权限:ice:CreateYikeAssetUpload、ice:SubmitYikeStoryboardJob、ice:GetYikeStoryboardJob。
完整权限策略请参见 references/ram-policies.md。
[必须] 权限错误处理: 当任何命令因权限错误失败时,请阅读 references/ram-policies.md 了解所需权限。
参数确认
在文件上传前通过自然对话与用户确认关键参数。
| 参数 | 必填 | 描述 | 默认值 |
|---|
| file_path | ✅ | 文本文件路径(txt/docx,≤5MB,≤30K 字符) | 用户提供 |
| title |
✅ | 分镜标题 | 从文本中提取 |
| source-type | ✅ | Novel 或 Script | 基于内容分析 |
| style | ✅ | 视觉风格 ID | 基于题材 |
| voice | ✅ | 旁白音色 ID | 基于主角 |
| shot-split-mode | ✅ | 镜头拆分模式 | 基于叙事风格 |
| ratio | 可选 | 16:9、9:16、4:3、3:4 | 9:16 |
| resolution | 可选 | 720P、1K、2K、4K | 720P |
推荐指南请参见 任务 0:参数确认。
文本类型分类
| 类型 | 值 | 描述 |
|---|
| 小说 | Novel | 以叙事、描写、心理活动为主,供阅读 |
| 剧本 |
Script | 以场景、对话、动作描述为主,供表演/拍摄 |
分类指南:
评估以下特征判断文本是小说还是剧本(不要仅凭对话存在判断——小说也可能有大量对话):
| 特征 | 剧本 | 小说 |
|---|
| 场景标记 | ✅ 有场次编号、时间、地点、内/外景 | ❌ 无明确场景标记 |
| 结构 |
✅ 角色名 + 对话 占主导 | ❌ 叙事文本占主导 |
| 动作提示 | ✅ 有舞台指示、镜头方向 | ❌ 无可表演特征 |
| 文学表达 | ❌ 较少 | ✅ 丰富的环境描写、心理活动、情感 |
分类规则:
- 1. 剧本:以场景、对话、动作描述为主
- 小说:以叙述、描写、心理活动为主
- 混合内容:判断主导特征,输出更像剧本或更像小说
重要:分类后,与用户确认文本类型,或让用户直接指定。
核心工作流
任务 0:参数确认
在上传前,分析文本并与用户确认关键参数。
步骤 1:分析文本内容
bash
head -c 1000
确定:题材、叙事风格(第一/第三人称)、主角特征。
步骤 2:推荐并确认参数
基于分析结果,通过自然对话向用户推荐并确认参数。
推荐指南:
| 参数 | 依据 | 示例 |
|---|
| style | 题材 | 现代都市 → CinematicRealism;古装剧 → RealisticGuzhuangPro;奇幻 → RealisticXianxia;动漫 → Ghibli |
| voice |
主角 | 年轻女性 → sys
ClassicYoungWoman;年轻男性 → sysGentleYoungMan;成熟男性 → sys_CalmDeepMale |
| shot-split-mode | 叙事方式 | 第三人称 → thirdPersonNarration;第一人称 → firstPersonNarration;对话密集的剧本 → dialogue |
| ratio | 平台 | 抖音/快手 → 9:16;YouTube → 16:9 |
| resolution | 质量 | 默认 720P;更高质量 1K/2K/4K |
默认值: 9:16、720P(竖屏高清,适合移动端)
⚠️ 约束: dialogue 模式仅适用于 Script 类型,不适用于 Novel。
确认对话示例:
根据您的现代都市爱情小说,我推荐:
- - 风格:CinematicRealism(电影质感,适合情感场景)
- 音色:sys_ClassicYoungWoman(匹配您的年轻女性主角)
- 镜头模式:thirdPersonNarration(第三人称叙事)
- 格式:9:16、720P(竖屏高清,适合移动平台)
- 标题:雨夜归途
这样设置可以吗?或者您想调整什么?
如果用户没有偏好,使用推荐的默认值。完整选项请参见 风格映射表 和 音色映射表。
在用户确认前,不要进入任务 1。
任务 1:上传文本文件到 OSS
前置条件: 必须完成任务 0(参数确认)。
使用辅助脚本自动获取凭证并上传:
bash
bash scripts/uploadtooss.sh
返回: FileURL(用于后续任务提交)
任务 2:提交分镜任务
bash
aliyun ice submit-yike-storyboard-job \
--file-url \
--source-type \
--style-id \
--narration-voice-id \
--aspect-ratio 9:16 \
--resolution 720P \
--shot-split-mode \
--shot-prompt-mode multi \
--video-model wan2.6-r2v-flash \
--exec-mode StoryboardOnly \
--title \
--region cn-shanghai \
--user-agent AlibabaCloud-Agent-Skills
完整参数参考请参见 references/related-commands.md。
任务 3:查询任务状态
bash
aliyun ice get-yike-storyboard-job \
--job-id \
--region cn