alicloud-ai-entry-modelstudio について
Alibaba Cloud Model Studio向けのルーティングスキルです。モデルやパラメーターの説明を重複させず、タスクに応じて既存のAIスキルへ案内します。
主な機能
- 01タスク別のスキル振り分け
- 02テキスト、コード、画像、動画、音声に対応
- 03該当しない機能の案内
- 04SDK、APIキー、非同期ポーリングの説明
活用シーン
- 01テキスト生成向けスキルの選択
- 02動画生成や画像編集スキルの特定
- 03不足機能に新しいスキルが必要か判断
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ cinience/ alicloud-skills --skill alicloud-ai-entry-modelstudioインストール後、Claude Code で/alicloud-ai-entry-modelstudioを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlreferences/sources.md
詳細
Category: タスク
Alibaba Cloud Model Studio エントリーポイント(ルーティング)
モデルやパラメーターの詳細が重複しないよう、リクエストを既存のローカルスキルにルーティングします。
前提条件
- SDK をインストールします(PEP 668 の制限を避けるため、仮想環境を推奨します)。
python3 -m venv .venv
. .venv/bin/activate
python -m pip install dashscope
DASHSCOPE_API_KEYを設定します(環境変数を推奨します。または、~/.alibabacloud/credentialsにdashscope_api_keyを設定します)。
ルーティングテーブル(現在、このリポジトリでサポートされている機能)
| 必要な機能 | 対象スキル |
|---|---|
| テキスト生成/推論/ツール呼び出し | skills/ai/text/alicloud-ai-text-qwen-generation/ |
| コーディング/リポジトリ推論 | skills/ai/code/alicloud-ai-code-qwen-coder/ |
| 複数ステップにわたる詳細なリサーチ | skills/ai/research/alicloud-ai-research-qwen-deep-research/ |
| テキストから画像への生成/画像生成 | skills/ai/image/alicloud-ai-image-qwen-image/ |
| 画像編集 | skills/ai/image/alicloud-ai-image-qwen-image-edit/ |
| テキストから動画への生成/画像から動画への生成(t2v/i2v) | skills/ai/video/alicloud-ai-video-wan-video/ |
| Wan 以外の PixVerse 動画生成 | skills/ai/video/alicloud-ai-video-aishi-generation/ |
| 参照画像から動画への生成(r2v) | skills/ai/video/alicloud-ai-video-wan-r2v/ |
| デジタルヒューマンの会話/歌唱アバター | skills/ai/video/alicloud-ai-video-digital-human/ |
| 表情豊かなポートレート動画(EMO) | skills/ai/video/alicloud-ai-video-emo/ |
| 軽量なポートレートアニメーション(LivePortrait) | skills/ai/video/alicloud-ai-video-liveportrait/ |
| モーション転送/ダンスアバター(AnimateAnyone) | skills/ai/video/alicloud-ai-video-animate-anyone/ |
| 絵文字/ミームのポートレート動画 | skills/ai/video/alicloud-ai-video-emoji/ |
| テキスト読み上げ(TTS) | skills/ai/audio/alicloud-ai-audio-tts/ |
| 音声認識/文字起こし(ASR) | skills/ai/audio/alicloud-ai-audio-asr/ |
| リアルタイム音声認識 | skills/ai/audio/alicloud-ai-audio-asr-realtime/ |
| リアルタイム TTS | skills/ai/audio/alicloud-ai-audio-tts-realtime/ |
| リアルタイム音声翻訳 | skills/ai/audio/alicloud-ai-audio-livetranslate/ |
| CosyVoice 音声クローン | skills/ai/audio/alicloud-ai-audio-cosyvoice-voice-clone/ |
| CosyVoice 音声デザイン | skills/ai/audio/alicloud-ai-audio-cosyvoice-voice-design/ |
| 音声クローン | skills/ai/audio/alicloud-ai-audio-tts-voice-clone/ |
| 音声デザイン | skills/ai/audio/alicloud-ai-audio-tts-voice-design/ |
| Omni マルチモーダル対話 | skills/ai/multimodal/alicloud-ai-multimodal-qwen-omni/ |
| 視覚的推論 | skills/ai/multimodal/alicloud-ai-multimodal-qvq/ |
| OCR/文書解析/表解析 | skills/ai/multimodal/alicloud-ai-multimodal-qwen-ocr/ |
| テキスト埋め込み | skills/ai/search/alicloud-ai-search-text-embedding/ |
| マルチモーダル埋め込み | skills/ai/search/alicloud-ai-search-multimodal-embedding/ |
| 再ランキング | skills/ai/search/alicloud-ai-search-rerank/ |
| ベクトル検索 | skills/ai/search/alicloud-ai-search-dashvector/ または skills/ai/search/alicloud-ai-search-opensearch/ または skills/ai/search/alicloud-ai-search-milvus/ |
| 文書理解 | skills/ai/text/alicloud-ai-text-document-mind/ |
| 動画編集 | skills/ai/video/alicloud-ai-video-wan-edit/ |
| 動画のリップシンク置換/リトーク | skills/ai/video/alicloud-ai-video-retalk/ |
| モデルリストのクロール/更新 | skills/ai/misc/alicloud-ai-misc-crawl-and-skill/ |
一致する項目がない場合
- まず、モデルの機能と入力/出力の種類を確認します。
- リポジトリに機能がない場合は、まず新しいスキルを追加します。
このリポジトリでよく不足している機能(残っている課題)
-
画像翻訳
-
バーチャル試着/デジタルヒューマン/高度な動画ペルソナ
-
マルチモーダル/ASR のダウンロードに失敗する場合は、上記の公開 URL を優先してください。
-
ASR のパラメーターエラーが発生する場合は、
input_audio.dataにデータ URI を使用してください。 -
マルチモーダル埋め込みで 400 エラーが発生する場合は、
input.contentsが配列であることを確認してください。
非同期タスクのポーリングテンプレート(動画/長時間実行タスク)
X-DashScope-Async: enable が task_id を返した場合は、次のようにポーリングします。
GET https://dashscope.aliyuncs.com/api/v1/tasks/<task_id>
Authorization: Bearer $DASHSCOPE_API_KEY
結果フィールドの例(成功時):
{
"output": {
"task_status": "SUCCEEDED",
"video_url": "https://..."
}
}
注意:
- 推奨ポーリング間隔:15~20秒、最大10回。
- 成功後、
output.video_urlをダウンロードします。
確認の質問(不明な点がある場合に質問)
- テキスト、画像、音声、動画のどれを扱っていますか?
- 生成、編集/理解、検索のどれを行いますか?
- 音声(TTS/ASR/リアルタイム翻訳)または検索(埋め込み/再ランキング/ベクターデータベース)が必要ですか?
- 実行可能なSDKスクリプトと、API/パラメーターのガイダンスのどちらを希望しますか?
参考資料
-
モデル一覧とリンク:
output/alicloud-model-studio-models-summary.md -
API/パラメーター/例:対象のサブスキル
SKILL.mdとreferences/*.mdを参照してください -
公式ソース一覧:
references/sources.md
検証
mkdir -p output/alicloud-ai-entry-modelstudio
echo "validation_placeholder" > output/alicloud-ai-entry-modelstudio/validate.txt
合格基準:コマンドが終了コード0で終了し、output/alicloud-ai-entry-modelstudio/validate.txt が生成されること。
出力と証跡
- 成果物、コマンド出力、API応答の概要を
output/alicloud-ai-entry-modelstudio/に保存します。 - 再現性を確保するため、証跡ファイルに主要なパラメーター(リージョン/リソースID/期間)を含めます。
ワークフロー
- ユーザーの意図、リージョン、識別子、および操作が読み取り専用か変更を伴うかを確認します。
- 接続と権限を確認するため、まず最小限の読み取り専用クエリを1つ実行します。
- 明示的なパラメーターと限定された範囲を指定して、対象の操作を実行します。
- 結果を確認し、出力/証跡ファイルを保存します。