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

bash

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:

bash

# Enable auto plugin installation
aliyun configure set --auto-plugin-install true

# Update plugins to latest
aliyun plugin update

# Set region to cn-shanghai (required for ICE service)
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

bash

aliyun plugin install --names ice

Verify plugin is installed:

bash

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

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.

ParameterRequiredDescriptionDefaultfile_path✅Text file path (txt/docx, ≤5MB, ≤30K chars)User providestitle✅Storyboard titleExtract from textsource-type✅Novel or ScriptBased on content analysisstyle✅Visual style IDBased on genrevoice✅Narration voice IDBased on protagonistshot-split-mode✅Shot split modeBased on narrative styleratioOptional16:9, 9:16, 4:3, 3:4``9:16resolutionOptional720P, 1K, 2K, 4K``720P

See Task 0: Parameter Confirmation for recommendation guide.

---

Text Type Classification#

TypeValueDescriptionNovelNovelPrimarily narrative, descriptive, psychological content for readingScriptScriptPrimarily 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):

FeatureScriptNovelScene Markers✅ Has scene numbers, time, location, INT/EXT❌ No explicit scene markersStructure✅ "Character Name + Dialogue" dominant❌ Narrative text dominantAction Cues✅ Has stage directions, camera directions❌ No performable featuresLiterary 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 OnExamplesstyleGenreModern Urban → CinematicRealism; Period Drama → RealisticGuzhuangPro; Fantasy → RealisticXianxia; Anime → GhiblivoiceProtagonistYoung Female → sys_ClassicYoungWoman; Young Male → sys_GentleYoungMan; Mature Male → sys_CalmDeepMaleshot-split-modeNarrativeThird person → thirdPersonNarration; First person → firstPersonNarration; Dialogue-heavy Script → dialogueratioPlatformTikTok/Douyin → 9:16; YouTube → 16:9resolutionQualityDefault 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/alibabacloud-yike-storyboard

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/alibabacloud-yike-storyboard

For complete parameter and response reference, see references/related-commands.md.

Status Flow and User Prompts:

StatusSubStatusCurrent PhaseUser PromptActionConfiguringParsingEntity Asset Parsing"Parsing your script, AI is extracting characters, scenes and props..."WaitConfiguringParseSuccEntity Asset Image Generation"Script parsed! Now generating images for characters, scenes and props. You can preview the progress here:"Provide Entity Management LinkEditingCreatingShot Script Generation"Entity assets ready! Now creating shot script, almost done..."WaitEditingCreateSuccComplete ✅"Shot script complete! You can now view and edit your storyboard:"Provide Editing LinkEditingCreateFailedFailed ❌"Shot script generation failed, please check error message or resubmit."Troubleshoot

Interactive Links:

StatusLinkPurposeParseSucchttps://www.yikeai.com/#/storyboard/entitiesManagement?storyboardId={storyboardId}Preview entity assets (characters, scenes, props) generation progressCreateSucchttps://www.yikeai.com/#/storyboard/editing?storyboardId={storyboardId}Edit storyboard, generate videos, export final video

Job Status Description:

JobStatusDescriptionUser PromptRunningJob 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:

text

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

---

Style Mapping Table#

StyleIdNameRealisticPhotographyProRealistic Photography ProRealisticGuzhuangProRealistic Chinese Period ProRealisticPhotographyRealistic PhotographyRealisticGuzhuangRealistic Chinese PeriodRealisticXianxiaRealistic XianxiaRealisticEraRealistic PeriodRealisticWastelandRealistic WastelandGuofengAnime2D Chinese Style AnimeGuofengAnime3D3D Chinese Style AnimeCartoon3D3D CartoonPhotorealistic3DPhotorealistic 3D RenderSciFiRealismSci-Fi RealismChibi3D3D ChibiShojoMangaShojo MangaNewPeriodAnimeNew Era AnimeFairyTale2D2D Fairy TaleWasteland2D2D WastelandInkWuxiaInk WuxiaShadiaoMemePanda Meme StyleChibi2D2D ChibiGhibliGhibliSciFiComicCyberpunkAmericanSuperheroAmerican SuperheroHokuseiHokuseiRealisticComicRealistic ComicCinematicRealismCinematic RealismMinimalistRealismMinimalist RealismShonenMangaShonen Manga

---

Narration Voice Mapping Table#

Voice IDDescriptionsys_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 TypedialogueDialogue ModeDialogue-heavy scripts, short dramasScript onlyfirstPersonNarrationFirst Person NarrationStories from protagonist's perspective, diary styleNovel/ScriptfirstPersonNarrationPureVOFirst Person Pure VOInner monologue stories, proseNovel/ScriptthirdPersonNarrationThird 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#

ReferenceDescriptionreferences/cli-installation-guide.mdCLI Installation Guidereferences/ram-policies.mdRAM Permission Policiesreferences/related-commands.mdRelated CLI Commandsreferences/verification-method.mdVerification Methods

---

Error Handling#

ErrorCauseSolutionMainAccountUserNotFoundYike service not activatedApply for access at Service Activation sectionInvalidAccessKeyIdInvalid AK/SKCheck credential configurationForbiddenInsufficient permissionsSee RAM Permissions sectionregion 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.