alibabacloud-yike-storyboard：一刻故事板创作技能 - 通过对话方式完成从小说到成片的AI视频创作流程。当用户想要创建故事板、制作视频、将小说/剧本转化为视频、生成分镜脚本时使用此技能。

一刻故事板创作 Skill

通过对话界面帮助用户完成从小说/剧本到故事板的 AI 视频创作工作流。

前置条件

1. Aliyun CLI 检查

预检查：需要 Aliyun CLI >= 3.3.3
```bash
aliyun version
```
验证版本 >= 3.3.3。如果未安装或版本过低，
运行 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash 更新，
或参阅 references/cli-installation-guide.md 获取安装说明。
然后 [必须] 运行以下命令配置 CLI：
```bash
# 启用插件自动安装
aliyun configure set --auto-plugin-install true
# 更新插件到最新
aliyun plugin update
# 设置地域为 cn-shanghai（ICE 服务必需）
aliyun configure set --region cn-shanghai
```

[必须] CLI User-Agent —— 每次调用 aliyun CLI 命令都必须包含：

--user-agent AlibabaCloud-Agent-Skills/alibabacloud-yike-storyboard

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
```
如果不存在有效 profile，请停止并：
1. 从 阿里云控制台 获取凭证
2. 运行 aliyun configure 设置凭证

RAM 权限

本 Skill 需要 ICE 权限：ice:CreateYikeAssetUpload、ice:SubmitYikeStoryboardJob、ice:GetYikeStoryboardJob。

完整权限策略见 references/ram-policies.md。

[必须] 权限错误处理： 当任何命令因权限错误失败时，阅读 references/ram-policies.md 获取所需权限。

参数确认

通过自然对话在文件上传前与用户确认关键参数。

推荐指南见任务 0：参数确认。

文本类型分类

分类指南：

评估以下特征判断文本是小说还是剧本（不要仅凭对话存在与否判断——小说也可能有大量对话）：

分类规则：

1. 剧本：由场景、对话、动作描述主导
2. 小说：由叙事、描写、心理活动主导
3. 混合内容：判断主导特征，输出“更像剧本”或“更像小说”

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

核心工作流

任务 0：参数确认

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

#### 步骤 1：分析文本内容

head -c 1000 <file_path>

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

#### 步骤 2：推荐并确认参数

基于分析，通过自然对话推荐并与用户确认。

推荐指南：

默认： 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。

状态流和用户提示：

交互链接：

任务状态说明：

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

任务 4：获取故事板链接

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

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

风格映射表

旁白声音映射表

分镜模式

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

推荐指南：

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

剧本：

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

小说：

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

重要：执行前，向用户描述模式特征并让其确认或选择。

能力范围

本 Skill 自动化：

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

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

一旦任务达到 CreateSucc 状态，本 Skill 的自动化即完成。以下步骤需要一刻故事板 Web 界面：

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

下一步：打开故事板编辑链接，继续您的视频创作之旅！

参考链接

错误处理

注意：如果收到 MainAccountUserNotFound 错误，表示您的账号尚未被加入 Yike 服务白名单。请访问 https://www.yikeai.com 并通过邀请申请表申请访问。

文档 6 / 6：alibabacloud-pai-feature-store-featuredb-usage-query