| name | alibabacloud-yike-storyboard |
| description | 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".
|
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.3 required
aliyun version
Verify version >= 3.3.3. If not installed or version is too low,
run curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash to update,
or see references/cli-installation-guide.md for installation instructions.
Then [MUST] run the following commands to configure CLI:
aliyun configure set --auto-plugin-install true
aliyun plugin update
aliyun configure set --region cn-shanghai
[MUST] CLI User-Agent — Every aliyun CLI command invocation must include:
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-yike-storyboard
2. ICE Plugin Installation
Pre-check: ICE CLI Plugin required
aliyun plugin install --names ice
Verify plugin is installed:
aliyun ice --help
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
aliyun configure list
If no valid profile exists, STOP and:
- 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 | 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):
| 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:
- 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
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:
| Parameter | Based On | Examples |
|---|
| style | Genre | Modern Urban → CinematicRealism; Period Drama → RealisticGuzhuangPro; Fantasy → RealisticXianxia; Anime → Ghibli |
| 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:
bash scripts/upload_to_oss.sh <file_path>
Returns: FileURL (for subsequent job submission)
Task 2: Submit Storyboard Job
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
For complete parameter reference, see references/related-commands.md.
Task 3: Query Job Status
aliyun ice get-yike-storyboard-job \
--job-id <JobId> \
--region cn-shanghai \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-yike-storyboard
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 | 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:
| 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:
https://www.yikeai.com/#/storyboard/editing?storyboardId={storyboardId}
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 |
|---|
| sys_ClassicMiddleAgedWoman | Classic Female Narrator (25-45, wise) |
| sys_ClassicYoungWoman | 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:
- High dialogue ratio (short dramas, chat format, comedy) → Recommend
dialogue
- First person narration → Recommend
firstPersonNarration
- Pure inner monologue/narration (prose, reflections) → Recommend
firstPersonNarrationPureVO
- Third person narration → Recommend
thirdPersonNarration
Novel:
- "I" perspective + has dialogue (urban romance, mystery) → Recommend
firstPersonNarration
- Pure inner monologue/narration (prose, reflections) → Recommend
firstPersonNarrationPureVO
- 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:
- 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
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.
