alibabacloud-yike-storyboard

Name: alibabacloud-yike-storyboard
Author: aliyun

github.com/aliyunクリエイティブ・メディア281188 回インストール1 日前に更新

リポジトリ

alibabacloud-yike-storyboard について

Alibaba Cloud の Agent スキルで、対話を通じて小説や脚本を編集可能な絵コンテに変換します。設定の確認からジョブ送信、進捗確認、編集リンクの提示まで行います。

主な機能

01小説と脚本の分類
02絵コンテ設定の確認支援
03テキストのアップロードとジョブ送信
04進捗確認と編集リンクの提示

活用シーン

01小説から絵コンテを作成
02脚本をショット構成に変換
03生成状況を追跡して編集画面を開く

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/aliyun/alibabacloud-aiops-skills --skill alibabacloud-yike-storyboard

インストール後、Claude Code で/alibabacloud-yike-storyboardを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/

acceptance-criteria.md

cli-installation-guide.md

ram-policies.md

related-commands.md

verification-method.md

scripts/

upload_to_oss.sh

詳細

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 を参照してください。

続いて、CLI を設定するために以下のコマンドを [必須] 実行してください。
# 自動プラグインインストールを有効化
aliyun configure set --auto-plugin-install true

# プラグインを最新バージョンに更新
aliyun plugin update

# リージョンを cn-shanghai に設定（ICE サービスで必須）
aliyun configure set --region cn-shanghai

[必須] CLI のユーザーエージェント — aliyun CLI コマンドを実行するたびに、次のオプションを含めてください。 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-yike-storyboard

2. ICE プラグインのインストール

事前確認：ICE CLI プラグインが必要です
aliyun plugin install --names ice
プラグインがインストールされていることを確認します。
aliyun ice --help

サービスの有効化

1. IMS（Intelligent Media Services）の有効化

有効化リンク： https://ice.console.aliyun.com/guide/default

Alibaba Cloud アカウントでログインし、ICE Intelligent Media Services を有効化してください。

2. yikeai プラットフォームへのログイン

プラットフォームリンク： https://www.yikeai.com/#/home

製品のウェブサイトにアクセスし、Alibaba Cloud アカウントでログインを承認してください。現在、Wanjing Yike は招待制です。アクセスを申請をクリックして申請を送信してください。

認証情報の確認

事前確認：Alibaba Cloud の認証情報が必要です

セキュリティルール：

AK/SK の値を読み取ったり、表示したり、出力したり しないでください

認証情報の状態の確認には aliyun configure list のみを使用してください
aliyun configure list
有効なプロファイルが存在しない場合は、処理を停止して次の手順を実行してください。

Alibaba Cloud コンソールから認証情報を取得します

aliyun configure を実行して認証情報を設定します

RAM 権限

このスキルには ICE 権限 ice:CreateYikeAssetUpload、ice:SubmitYikeStoryboardJob、ice:GetYikeStoryboardJob が必要です。

権限ポリシーの全容については、references/ram-policies.md を参照してください。

[必須] 権限エラーへの対応： コマンドが権限エラーで失敗した場合は、必要な権限を確認するために 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 がある	❌ 明示的なシーンの目印がない
構成	✅ 「登場人物名＋台詞」が中心	❌ 地の文が中心
動作の指示	✅ ト書き、カメラの指示がある	❌ 演じられる要素がない
文学的表現	❌ 最小限	✅ 豊かな環境描写、心理、感情

分類ルール：

脚本：シーン、台詞、動作の描写が中心
小説：語り、描写、心理的な動きが中心
混在する内容：優勢な特徴を判断し、「脚本に近い」または「小説に近い」と出力

重要：分類後、テキストの種類をユーザーに確認するか、ユーザーが直接指定できるようにしてください。

コアワークフロー

タスク 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（モバイル向けの縦型 HD）

⚠️ 制約： dialogue モードは Script タイプでのみ使用でき、Novel では使用できません。

確認の会話例：

「現代都市を舞台にした恋愛小説を拝見したところ、以下をおすすめします。

スタイル：CinematicRealism（映画のような品質で、感情的なシーンに最適です）

音声：sys_ClassicYoungWoman（若い女性の主人公に合っています）

ショットモード：thirdPersonNarration（三人称の語り向けです）

形式：9:16、720P（モバイルプラットフォーム向けの縦型 HD）

タイトル：「雨夜归途」

この内容でよろしいですか？変更したい点があればお知らせください。」

ユーザーに希望がない場合は、推奨されるデフォルトを使用します。すべての選択肢については、スタイル対応表とナレーション音声対応表を参照してください。

ユーザーの確認が取れるまで、タスク 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	SF リアリズム
Chibi3D	3D ちびキャラ
ShojoManga	少女漫画
NewPeriodAnime	新時代アニメ
FairyTale2D	2D おとぎ話
Wasteland2D	2D 荒廃世界
InkWuxia	水墨武侠
ShadiaoMeme	パンダミーム風
Chibi2D	2D ちびキャラ
Ghibli	ジブリ
SciFiComic	サイバーパンク
AmericanSuperhero	アメリカン・スーパーヒーロー
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 モードはサポートされていません。

推奨ガイド：

テキストの種類と内容の分析に基づいて、適切なモードを選択してください。

脚本：

会話の比率が高い（短編ドラマ、チャット形式、コメディ）→ dialogue を推奨
一人称ナレーション → firstPersonNarration を推奨
純粋な内面の独白／ナレーション（散文、内省）→ firstPersonNarrationPureVO を推奨
三人称ナレーション → thirdPersonNarration を推奨

小説：

「私」の視点＋会話あり（現代の恋愛もの、ミステリー）→ firstPersonNarration を推奨
純粋な内面の独白／ナレーション（散文、内省）→ firstPersonNarrationPureVO を推奨
三人称ナレーション（童話、神話、歴史もの）→ thirdPersonNarration を推奨

重要：実行前にモードの特徴をユーザーに説明し、確認または選択してもらってください。

機能の範囲

このスキルで自動化される作業：

小説／脚本ファイルを OSS にアップロード
エンティティアセットの解析（キャラクター、シーン、小道具の抽出）
エンティティアセット画像の生成
ショット脚本の生成
ジョブのステータス追跡

ショット脚本の完成後は、UI で作業を続けてください：

ジョブが CreateSucc ステータスに達すると、このスキルによる自動化は完了です。以降の手順には Yike Storyboard のウェブインターフェースが必要です。

ショット脚本を編集 - ショットの内容、説明、プロンプトを調整します
ショット画像／動画を生成 - AI が各ショットの画像／動画を生成します
編集して組み立て - タイミングを微調整し、トランジションを追加します
最終動画をエクスポート - 完成した動画をレンダリングしてダウンロードします

次のステップ：ストーリーボードの編集リンクを開き、動画制作を続けましょう！

参考リンク

参考資料	説明
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 にアクセスし、招待申請フォームからアクセスを申請してください。

Markdown 対応

ログインしてコメント

基本情報

作者: aliyun
リポジトリ: aliyun/alibabacloud-aiops-skills
カテゴリ: クリエイティブ・メディア
インストール数: 188
GitHub スター: 281

問題を報告