alibabacloud-yike-storyboard

Original🇺🇸 English
Translated
1 scripts

Yike Storyboard Creation Skill - Complete AI video creation workflow from novel/script to storyboard via conversational interface. Use this skill when users want to create storyboards, produce videos, convert novels/scripts to videos, or generate shot scripts. Trigger scenarios: "storyboard", "novel to video", "shot script", "script parsing", "video creation", "convert novel to video", "generate storyboard".

3installs
Added on

NPX Install

npx skill4agent add aliyun/alibabacloud-aiops-skills alibabacloud-yike-storyboard

Tags

Translated version includes tags in frontmatter

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
bash
aliyun version
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:
bash
# Enable auto plugin installation
aliyun configure set --auto-plugin-install true

# Set region to cn-shanghai (required for ICE service)
aliyun configure set --region cn-shanghai

2. ICE Plugin Installation

Pre-check: ICE CLI Plugin required
bash
aliyun plugin install --names ice
Verify plugin is installed:
bash
aliyun ice --help

Service Activation

1. Activate IMS (Intelligent Media Services)

Log in with your Alibaba Cloud account and activate ICE Intelligent Media Services.

2. Log in to yikeai platform

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
bash
aliyun configure list
If no valid profile exists, STOP and:
  1. Get credentials from Alibaba Cloud Console
  2. 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.
ParameterRequiredDescriptionDefault
file_pathText file path (txt/docx, ≤5MB, ≤30K chars)User provides
titleStoryboard titleExtract from text
source-type
Novel
or
Script
Based on content analysis
styleVisual style IDBased on genre
voiceNarration voice IDBased on protagonist
shot-split-modeShot split modeBased on narrative style
ratioOptional
16:9
,
9:16
,
4:3
,
3:4
9:16
resolutionOptional
720P
,
1K
,
2K
,
4K
720P
See Task 0: Parameter Confirmation for recommendation guide.

Text Type Classification

TypeValueDescription
Novel
Novel
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):
FeatureScriptNovel
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
  2. Novel: Dominated by narration, description, psychological activity
  3. 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

bash
head -c 1000 <file_path>
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:
ParameterBased OnExamples
styleGenreModern Urban →
CinematicRealism
; Period Drama →
RealisticGuzhuangPro
; Fantasy →
RealisticXianxia
; Anime →
Ghibli
voiceProtagonistYoung Female →
sys_ClassicYoungWoman
; Young Male →
sys_GentleYoungMan
; Mature Male →
sys_CalmDeepMale
shot-split-modeNarrativeThird person →
thirdPersonNarration
; First person →
firstPersonNarration
; Dialogue-heavy Script →
dialogue
ratioPlatformTikTok/Douyin →
9:16
; YouTube →
16:9
resolutionQualityDefault
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:
bash
bash scripts/upload_to_oss.sh <file_path>
Returns:
FileURL
(for subsequent job submission)

Task 2: Submit Storyboard Job

bash
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
For complete parameter reference, see references/related-commands.md.

Task 3: Query Job Status

bash
aliyun ice get-yike-storyboard-job \
  --job-id <JobId> \
  --region cn-shanghai \
  --user-agent AlibabaCloud-Agent-Skills
For complete parameter and response reference, see references/related-commands.md.
Status Flow and User Prompts:
StatusSubStatusCurrent PhaseUser PromptAction
ConfiguringParsingEntity Asset Parsing"Parsing your script, AI is extracting characters, scenes and props..."Wait
ConfiguringParseSuccEntity Asset Image Generation"Script parsed! Now generating images for characters, scenes and props. You can preview the progress here:"Provide Entity Management Link
EditingCreatingShot Script Generation"Entity assets ready! Now creating shot script, almost done..."Wait
EditingCreateSuccComplete ✅"Shot script complete! You can now view and edit your storyboard:"Provide Editing Link
EditingCreateFailedFailed ❌"Shot script generation failed, please check error message or resubmit."Troubleshoot
Interactive Links:
StatusLinkPurpose
ParseSucc
https://www.yikeai.com/#/storyboard/entitiesManagement?storyboardId={storyboardId}
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:
JobStatusDescriptionUser Prompt
RunningJob in progress"Job is processing, usually takes a few minutes, please wait..."
SucceededJob succeeded"Job completed!"
FailedJob failed"Job failed, please check error message."
SuspendedJob 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:
https://www.yikeai.com/#/storyboard/editing?storyboardId={storyboardId}

Style Mapping Table

StyleIdName
RealisticPhotographyProRealistic Photography Pro
RealisticGuzhuangProRealistic Chinese Period Pro
RealisticPhotographyRealistic Photography
RealisticGuzhuangRealistic Chinese Period
RealisticXianxiaRealistic Xianxia
RealisticEraRealistic Period
RealisticWastelandRealistic Wasteland
GuofengAnime2D Chinese Style Anime
GuofengAnime3D3D Chinese Style Anime
Cartoon3D3D Cartoon
Photorealistic3DPhotorealistic 3D Render
SciFiRealismSci-Fi Realism
Chibi3D3D Chibi
ShojoMangaShojo Manga
NewPeriodAnimeNew Era Anime
FairyTale2D2D Fairy Tale
Wasteland2D2D Wasteland
InkWuxiaInk Wuxia
ShadiaoMemePanda Meme Style
Chibi2D2D Chibi
GhibliGhibli
SciFiComicCyberpunk
AmericanSuperheroAmerican Superhero
HokuseiHokusei
RealisticComicRealistic Comic
CinematicRealismCinematic Realism
MinimalistRealismMinimalist Realism
ShonenMangaShonen Manga

Narration Voice Mapping Table

Voice IDDescription
sys_ClassicMiddleAgedWomanClassic Female Narrator (25-45, wise)
sys_ClassicYoungWomanClassic Young Female (18-25, intellectual)
sys_IntellectualYoungWomanIntellectual Young Female (18-25, intellectual)
sys_GentleYoungManGentle Young Male (18-25, gentle)
sys_WiseYoungManWise Young Male (18-25, wise)
sys_ClassicYoungManClassic Young Male (18-25, charming)
sys_thoughtfulBoyThoughtful Boy (10-15, well-behaved)
sys_SereneIntellectSerene Intellectual Male (18-25, cool and rational)
sys_RichBassMaleRich Bass Male (18-25, deep voice)
sys_CalmDeepMaleCalm Deep Male (25-40, steady and deep)
sys_MajesticBaritoneMajestic Baritone (40-60, authoritative)
sys_GravellySoulfulGravelly Soulful Male (40-60, weathered)
sys_SweetBrightGirlSweet Bright Girl (10-15, lively)
sys_GracefulPoisedWomanGraceful Poised Woman (18-25, elegant)
longbaizhiLong Baizhi (20-30, witty female narrator)
sys_YoungGracefulWomanYoung Graceful Woman (18-25, gentle)
sys_MaturePoisedWomanMature Poised Woman (25-40, graceful)
sys_MatureWiseWomanMature Wise Woman (25-40, elegant and wise)
sys_ElderlyWistfulWomanElderly Wistful Woman (40-60, nostalgic)

Shot Split Mode

ModeDescriptionUse CaseSupported Type
dialogueDialogue ModeDialogue-heavy scripts, short dramasScript only
firstPersonNarrationFirst Person NarrationStories from protagonist's perspective, diary styleNovel/Script
firstPersonNarrationPureVOFirst Person Pure VOInner monologue stories, proseNovel/Script
thirdPersonNarrationThird Person NarrationOmniscient perspective stories, fairy tales, historicalNovel/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
    dialogue
  2. First person narration → Recommend
    firstPersonNarration
  3. Pure inner monologue/narration (prose, reflections) → Recommend
    firstPersonNarrationPureVO
  4. Third person narration → Recommend
    thirdPersonNarration
Novel:
  1. "I" perspective + has dialogue (urban romance, mystery) → Recommend
    firstPersonNarration
  2. Pure inner monologue/narration (prose, reflections) → Recommend
    firstPersonNarrationPureVO
  3. Third person narration (fairy tales, mythology, history) → Recommend
    thirdPersonNarration
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
  2. Generate shot images/videos - AI generates images/videos for each shot
  3. Edit and assemble - Fine-tune timing, add transitions
  4. Export final video - Render and download the complete video
Next Step: Open the storyboard editing link and continue your video creation journey!

Reference Links

ReferenceDescription
references/cli-installation-guide.mdCLI Installation Guide
references/ram-policies.mdRAM Permission Policies
references/related-commands.mdRelated CLI Commands
references/verification-method.mdVerification Methods

Error Handling

ErrorCauseSolution
MainAccountUserNotFoundYike service not activatedApply for access at Service Activation section
InvalidAccessKeyIdInvalid AK/SKCheck credential configuration
ForbiddenInsufficient permissionsSee RAM Permissions section
region can't be emptyOSS upload missing regionAdd
--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.