关于 alicloud-media-vod
用于通过 Alibaba Cloud OpenAPI 管理 ApsaraVideo VOD 资源的服务技能,面向媒体上传、处理、播放和配置操作。它支持先发现 API 并进行只读验证,再执行操作并保存证据。
主要功能
- 01发现 VOD API 元数据
- 02上传与管理媒体资源
- 03配置转码模板并提交任务
- 04提交快照和 AI 任务
- 05保存操作证据
适用场景
- 01上传并查询媒体
- 02提交转码或快照任务
- 03设置播放授权与水印
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ cinience/ alicloud-skills --skill alicloud-media-vod安装后在 Claude Code 中输入/alicloud-media-vod确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/sources.mdtemplates.mdscripts/list_openapi_meta_apis.py详细介绍
Category: 服务
ApsaraVideo VOD
验证
mkdir -p output/alicloud-media-vod
python -m py_compile skills/media/vod/alicloud-media-vod/scripts/list_openapi_meta_apis.py
echo "py_compile_ok" > output/alicloud-media-vod/validate.txt
通过标准:命令退出码为 0,且生成了 output/alicloud-media-vod/validate.txt。
输出与证据
- 将 API 清单和操作证据保存在
output/alicloud-media-vod/下。 - 在证据文件中保留地域、媒体 ID、模板 ID 和请求参数。
使用 Alibaba Cloud OpenAPI(RPC)和官方 SDK 或 OpenAPI Explorer 管理 VOD 资源。 优先通过元数据发现 API,再执行变更操作。
前提条件
- 准备遵循最小权限原则的 RAM AccessKey/STS 凭据。
- 在进行更改前,确认目标地域和媒体范围。
- 首先使用只读的
Describe*/List*API。
工作流
- 确认目标媒体 ID、存储范围和所需操作。
- 通过元数据和 API Explorer 查找 API 名称及必需参数。
- 执行只读验证调用。
- 执行上传、处理、播放或配置操作。
- 将输出和证据保存在
output/alicloud-media-vod/下。
AccessKey 优先级
- 环境变量:
ALICLOUD_ACCESS_KEY_ID/ALICLOUD_ACCESS_KEY_SECRET/ALICLOUD_REGION_ID。 - 共享配置文件:
~/.alibabacloud/credentials。
如果地域不明确,请在执行写入操作前询问。
API 发现
- 产品代码:
vod - 默认 API 版本:
2017-03-21 - 元数据来源:
https://api.aliyun.com/meta/v1/products/vod/versions/2017-03-21/api-docs.json
最简可执行快速入门
python skills/media/vod/alicloud-media-vod/scripts/list_openapi_meta_apis.py
可选覆盖项:
python skills/media/vod/alicloud-media-vod/scripts/list_openapi_meta_apis.py \
--product-code vod \
--version 2017-03-21 \
--output-dir output/alicloud-media-vod
常见操作映射
- 上传和资产:
CreateUploadVideo、CreateUploadImage、GetPlayInfo、SearchMedia - 媒体管理:
GetVideoInfo、UpdateVideoInfo、DeleteVideo - 转码/模板:
AddTranscodeTemplateGroup、UpdateTranscodeTemplateGroup、SubmitTranscodeJobs - 截图/AI 任务:
SubmitSnapshotJob、SubmitAIJob、GetJobDetail - 安全/播放授权:
GetVideoPlayAuth、SetMessageCallback、SetDefaultWatermark
输出策略
将所有生成的文件和执行证据写入:
output/alicloud-media-vod/
参考资料
- 来源列表:
references/sources.md - 任务模板:
references/templates.md
评论
支持 Markdown