alicloud-media-ice について
Alibaba Cloud OpenAPI で Intelligent Cloud Editing(ICE)のリソースを管理するサービススキルです。API メタデータを調べてリソースを検証し、処理ジョブの投入・監視と実行証跡の保存を行います。
主な機能
- 01ICE API メタデータの探索
- 02メディア情報とワークフローの照会
- 03リソースと前提条件の検証
- 04メディアジョブの投入と監視
- 05操作証跡の保存
活用シーン
- 01メディアメタデータの確認
- 02メディアワークフローの設定
- 03処理ジョブの投入と追跡
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ cinience/ alicloud-skills --skill alicloud-media-iceインストール後、Claude Code で/alicloud-media-iceを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/sources.mdtemplates.mdscripts/list_openapi_meta_apis.py詳細
カテゴリ:サービス
Intelligent Cloud Editing(ICE)
検証
mkdir -p output/alicloud-media-ice
python -m py_compile skills/media/ice/alicloud-media-ice/scripts/list_openapi_meta_apis.py
echo "py_compile_ok" > output/alicloud-media-ice/validate.txt
合格基準:コマンドが終了コード 0 で終了し、output/alicloud-media-ice/validate.txt が生成されること。
出力とエビデンス
- API インベントリと操作のエビデンスを
output/alicloud-media-ice/に保存します。 - エビデンスファイルには、リージョン、ワークフロー ID、ジョブ ID、リクエストパラメーターを記録します。
Alibaba Cloud OpenAPI(RPC)と公式 SDK または OpenAPI Explorer を使用して、ICE リソースを管理します。 変更操作の前に、メタデータを優先して API を探索してください。
前提条件
- 最小権限の RAM AccessKey/STS 認証情報を準備します。
- 変更を行う前に、対象リージョン、入力/出力 OSS の場所、ワークフローの範囲を確認します。
- 処理ジョブを実行する前に、読み取り専用 API で現在の状態を照会します。
ワークフロー
- 対象のワークフロー/テンプレートと、メディアの入力/出力場所を確認します。
- メタデータと API Explorer を使用して、API 名と必須パラメーターを確認します。
- 読み取り専用 API を使用して、前提となるリソースを検証します。
- 処理ジョブを送信し、進行状況を監視します。
- 出力とエビデンスを
output/alicloud-media-ice/に保存します。
AccessKey の優先順位
- 環境変数:
ALICLOUD_ACCESS_KEY_ID/ALICLOUD_ACCESS_KEY_SECRET/ALICLOUD_REGION_ID。 - 共有設定ファイル:
~/.alibabacloud/credentials。
リージョンが不明確な場合は、書き込み操作の前に確認してください。
API の探索
- プロダクトコード:
ice - デフォルト API バージョン:
2020-11-09 - メタデータソース:
https://api.aliyun.com/meta/v1/products/ice/versions/2020-11-09/api-docs.json
実行可能な最小クイックスタート
python skills/media/ice/alicloud-media-ice/scripts/list_openapi_meta_apis.py
任意のオーバーライド:
python skills/media/ice/alicloud-media-ice/scripts/list_openapi_meta_apis.py \
--product-code ice \
--version 2020-11-09 \
--output-dir output/alicloud-media-ice
一般的な操作の対応表
- メディア情報とメタデータ:
GetMediaInfo、SearchMedia、UpdateMediaMeta - ワークフロー/テンプレート:
CreateMediaWorkflow、UpdateMediaWorkflow、ListMediaWorkflowExecutions - ジョブの送信:
SubmitMediaProducingJob、SubmitBatchMediaProducingJob、GetMediaProducingJob - 編集/素材:
CreateSourceLocation、AddMedia、GetDefaultMaterial - タスクのステータス/トラブルシューティング:
GetTaskInfo、ListJobs、GetBatchMediaProducingJob
出力ポリシー
生成されたすべてのファイルと実行エビデンスを、次の場所に書き込みます:
output/alicloud-media-ice/
参考資料
- ソース一覧:
references/sources.md - タスクテンプレート:
references/templates.md
コメント
Markdown 対応