alibabacloud-yike-storyboard

Yike 分镜创作技能

通过对话界面，帮助用户完成从小说／剧本到分镜的 AI 视频创作工作流。

---

前置条件

1. Aliyun CLI 检查

预检查：需要 Aliyun CLI >= 3.3.3

aliyun version

确认版本 >= 3.3.3。如果尚未安装或版本过低， 运行 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash 进行更新， 或参阅 references/cli-installation-guide.md 了解安装说明。

然后**[MUST]**运行以下命令配置 CLI：

# 启用自动安装插件
aliyun configure set --auto-plugin-install true

# 将插件更新至最新版本
aliyun plugin update

# 将地域设置为 cn-shanghai（ICE 服务必需）
aliyun configure set --region cn-shanghai

[MUST] CLI User-Agent — 每次调用 aliyun CLI 命令都必须包含： --user-agent AlibabaCloud-Agent-Skills/alibabacloud-yike-storyboard

2. ICE 插件安装

预检查：需要 ICE CLI 插件

aliyun plugin install --names ice

确认插件已安装：

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 检查凭证状态

aliyun configure list

如果不存在有效的配置文件，请停止并：

1. 从阿里云控制台获取凭证
2. 运行 aliyun configure 设置凭证

---

RAM 权限

此技能需要 ICE 权限：ice:CreateYikeAssetUpload、ice:SubmitYikeStoryboardJob、ice:GetYikeStoryboardJob。

完整的权限策略请参阅 references/ram-policies.md。

**[MUST] 权限错误处理：**任何命令因权限错误而失败时，请阅读 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	主要包含用于表演或拍摄的场景、对话和动作描述

分类指南：

评估以下特征，判断文本是小说还是剧本（不要仅根据是否有对话来判断——小说也可能包含大量对话）：

特征	剧本	小说
场景标记	✅ 有场景编号、时间、地点、INT/EXT	❌ 没有明确的场景标记
结构	✅ 以「角色名称 + 对话」为主	❌ 以叙述文本为主
动作提示	✅ 有舞台指示、镜头指示	❌ 没有可供表演的内容
文学表达	❌ 较少	✅ 丰富的环境描写、心理活动和情感

分类规则：

1. 剧本：以场景、对话和动作描述为主
2. 小说：以叙述、描写和心理活动为主
3. 混合内容：判断占主导的特征，输出「更像剧本」或「更像小说」

重要提示：完成分类后，请与用户确认文本类型，或让用户直接指定。

---

核心工作流

任务 0：确认参数

上传前，分析文本并与用户确认关键参数。

步骤 1：分析文本内容

head -c 1000 <file_path>

确定：类型、叙事风格（第一人称/第三人称）、主角特征。

步骤 2：推荐并确认参数

根据分析结果给出建议，并通过自然对话与用户确认。

推荐指南：

参数	依据	示例
style	类型	现代都市 → CinematicRealism；年代剧 → RealisticGuzhuangPro；奇幻 → RealisticXianxia；动漫 → Ghibli
voice	主角	年轻女性 → sys_ClassicYoungWoman；年轻男性 → sys_GentleYoungMan；成熟男性 → sys_CalmDeepMale
shot-split-mode	叙事方式	第三人称 → thirdPersonNarration；第一人称 → firstPersonNarration；以对话为主的剧本 → dialogue
ratio	平台	TikTok/Douyin → 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 scripts/upload_to_oss.sh <file_path>

返回： FileURL（用于后续提交作业）

任务 2：提交分镜作业

aliyun ice submit-yike-storyboard-job \
  --file-url "<FileURL>" \
  --source-type <SourceType> \
  --style-id <StyleId> \
  --narration-voice-id <VoiceId> \
  --aspect-ratio "9:16" \
  --resolution 720P \
  --shot-split-mode <ShotSplitMode> \
  --shot-prompt-mode multi \
  --video-model "wan2.6-r2v-flash" \
  --exec-mode StoryboardOnly \
  --title "<Title>" \
  --region cn-shanghai \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-yike-storyboard

完整参数说明请参阅 references/related-commands.md。

任务 3：查询任务状态

aliyun ice get-yike-storyboard-job \
  --job-id <JobId> \
  --region cn-shanghai \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-yike-storyboard

完整的参数和响应参考，请参阅 references/related-commands.md。

状态流转与用户提示：

状态	子状态	当前阶段	用户提示	操作
Configuring	Parsing	实体素材解析	"正在解析你的脚本，AI 正在提取角色、场景和道具……"	等待
Configuring	ParseSucc	实体素材图像生成	"脚本解析完成！正在为角色、场景和道具生成图像。你可以在此预览进度："	提供实体管理链接
Editing	Creating	分镜脚本生成	"实体素材已就绪！正在生成分镜脚本，即将完成……"	等待
Editing	CreateSucc	已完成 ✅	"分镜脚本已完成！现在可以查看和编辑你的故事板："	提供编辑链接
Editing	CreateFailed	失败 ❌	"分镜脚本生成失败，请检查错误信息或重新提交。"	排查问题

交互链接：

状态	链接	用途
ParseSucc	https://www.yikeai.com/#/storyboard/entitiesManagement?storyboardId={storyboardId}	预览实体素材（角色、场景、道具）的生成进度
CreateSucc	https://www.yikeai.com/#/storyboard/editing?storyboardId={storyboardId}	编辑故事板、生成视频并导出最终视频

任务状态说明：

JobStatus	描述	用户提示
Running	任务正在进行	"任务正在处理中，通常需要几分钟，请耐心等待……"
Succeeded	任务成功	"任务已完成！"
Failed	任务失败	"任务失败，请检查错误信息。"
Suspended	任务已暂停	"任务已暂停，部分镜头失败，可在故事板中手动修复。"

查询建议：任务通常需要几分钟。建议每隔 30 秒查询一次状态。

任务 4：获取故事板链接

从 JobResult.StoryboardInfoList 获取 storyboardId 并构造链接：

https://www.yikeai.com/#/storyboard/editing?storyboardId={storyboardId}

---

风格映射表

StyleId	名称
RealisticPhotographyPro	写实摄影 Pro
RealisticGuzhuangPro	写实中国古装 Pro
RealisticPhotography	写实摄影
RealisticGuzhuang	写实中国古装
RealisticXianxia	写实仙侠
RealisticEra	写实年代
RealisticWasteland	写实废土
GuofengAnime	2D 中国风动漫
GuofengAnime3D	3D 中国风动漫
Cartoon3D	3D 卡通
Photorealistic3D	照片级写实 3D 渲染
SciFiRealism	科幻写实
Chibi3D	3D Q 版
ShojoManga	少女漫画
NewPeriodAnime	新时代动漫
FairyTale2D	2D 童话
Wasteland2D	2D 废土
InkWuxia	水墨武侠
ShadiaoMeme	熊猫表情包风格
Chibi2D	2D Q 版
Ghibli	吉卜力
SciFiComic	赛博朋克
AmericanSuperhero	美国超级英雄
Hokusei	Hokusei
RealisticComic	写实漫画
CinematicRealism	电影级写实
MinimalistRealism	极简写实
ShonenManga	少年漫画

---

旁白音色映射表

音色 ID	描述
sys_ClassicMiddleAgedWoman	经典女性旁白（25-45 岁，睿智）
sys_ClassicYoungWoman	经典年轻女性（18-25 岁，知性）
sys_IntellectualYoungWoman	知性年轻女性（18-25 岁，知性）
sys_GentleYoungMan	温柔年轻男性（18-25 岁，温和）
sys_WiseYoungMan	睿智年轻男性（18-25 岁，睿智）
sys_ClassicYoungMan	经典年轻男性（18-25 岁，迷人）
sys_thoughtfulBoy	沉思少年（10-15 岁，乖巧）
sys_SereneIntellect	沉静知性男性（18-25 岁，冷静理性）
sys_RichBassMale	浑厚低音男性（18-25 岁，嗓音低沉）
sys_CalmDeepMale	沉稳低沉男性（25-40 岁，沉着低沉）
sys_MajesticBaritone	威严男中音（40-60 岁，威严）
sys_GravellySoulful	沙哑深情男性（40-60 岁，沧桑）
sys_SweetBrightGirl	甜美活泼女孩（10-15 岁，活泼）
sys_GracefulPoisedWoman	优雅沉稳女性（18-25 岁，优雅）
longbaizhi	Long Baizhi（20-30 岁，风趣的女性旁白）
sys_YoungGracefulWoman	年轻优雅女性（18-25 岁，温柔）
sys_MaturePoisedWoman	成熟沉稳女性（25-40 岁，优雅）
sys_MatureWiseWoman	成熟睿智女性（25-40 岁，优雅睿智）
sys_ElderlyWistfulWoman	怀旧年长女性（40-60 岁，怀旧）

---

分镜拆分模式

模式	描述	使用场景	支持类型
dialogue	对话模式	对话较多的剧本、短剧	仅剧本
firstPersonNarration	第一人称旁白	主角视角的故事、日记体	小说/剧本
firstPersonNarrationPureVO	第一人称纯旁白	内心独白故事、散文	小说/剧本
thirdPersonNarration	第三人称旁白	全知视角故事、童话、历史题材	小说/剧本

限制：当 source-type 为 Novel 时，不支持 dialogue 模式。

推荐指南：

根据文本类型和内容分析选择合适的模式：

剧本：

1. 对话比例高（短剧、聊天形式、喜剧）→ 推荐 dialogue
2. 第一人称旁白 → 推荐 firstPersonNarration
3. 纯内心独白/旁白（散文、随笔）→ 推荐 firstPersonNarrationPureVO
4. 第三人称旁白 → 推荐 thirdPersonNarration

小说：

1. “我”视角 + 有对话（都市爱情、悬疑）→ 推荐 firstPersonNarration
2. 纯内心独白/旁白（散文、随笔）→ 推荐 firstPersonNarrationPureVO
3. 第三人称旁白（童话、神话、历史）→ 推荐 thirdPersonNarration

重要提示：执行前，向用户说明各模式的特点，并让用户确认或选择。

---

能力范围

此技能可自动完成：

• 将小说/剧本文件上传到 OSS
• 解析实体资产（提取角色、场景、道具）
• 生成实体资产图片
• 生成分镜脚本
• 跟踪任务状态

分镜脚本完成后，请在 UI 中继续操作：

当任务状态达到 CreateSucc 后，此技能的自动化流程即告完成。以下步骤需要使用 Yike Storyboard 网页界面：

1. 编辑分镜脚本 - 调整分镜内容、描述和提示词
2. 生成分镜图片/视频 - AI 为每个分镜生成图片/视频
3. 编辑和拼接 - 微调时长、添加转场
4. 导出最终视频 - 渲染并下载完整视频

下一步：打开分镜编辑链接，继续创作视频！

---

参考链接

参考	描述
references/cli-installation-guide.md	CLI 安装指南
references/ram-policies.md	RAM 权限策略
references/related-commands.md	相关 CLI 命令
references/verification-method.md	验证方法

---

错误处理

错误	原因	解决方案
MainAccountUserNotFound	Yike 服务尚未激活	请在服务激活部分申请访问权限
InvalidAccessKeyId	AK/SK 无效	检查凭据配置
Forbidden	权限不足	请参阅 RAM 权限部分
region can't be empty	OSS 上传缺少区域	添加 --region cn-shanghai

注意：如果收到 MainAccountUserNotFound 错误，表示你的账户尚未加入 Yike 服务的白名单。请访问 https://www.yikeai.com，并通过[邀请申请表](https://survey.aliyun.com/apps/zhiliao/0FZ3TNiNP)申请访问权限。