类别:服务 AIContent
使用方法:使用阿里云 OpenAPI(RPC)和官方 SDK 或 OpenAPI Explorer 管理 AIContent 资源。
工作流程:
- 确认区域、资源标识符和所需操作。
- 发现 API 列表和所需参数(见参考资料)。
- 使用 SDK 或 OpenAPI Explorer 调用 API。
- 使用 describe/list API 验证结果。
访问密钥优先级(必须遵循):
环境变量:ALICLOUD_ACCESS_KEY_ID / ALICLOUD_ACCESS_KEY_SECRET / ALICLOUD_REGION_ID
区域策略:ALICLOUD_REGION_ID 是可选的默认值。如果未设置,决定最合理的区域;如果不清楚,询问用户。
共享配置文件:~/.alibabacloud/credentials
API 发现:
产品代码:AiContent
默认 API 版本:20240611
使用 OpenAPI 元数据端点列出 API 和获取模式(见参考资料)。
高频操作模式:
- 清单/列表:更喜欢使用 List / Describe API 获取当前资源。
- 更改/配置:更喜欢使用 Create / Update / Modify / Set API 进行变异。
- 状态/故障排除:更喜欢使用 Get / Query / DescribeStatus API 进行诊断。
最小可执行快速入门:
在调用业务 API 之前使用元数据优先发现:python scripts/list_openapi_meta_apis.py
可选覆盖:python scripts/list_openapi_meta_apis.py --product-code --version
脚本在技能输出目录下写入 API 清单工件。
输出策略:
如果需要保存响应或生成的工件,请在以下目录下写入:output/aliyun-aicontent-generate/
验证:
mkdir -p output/aliyun-aicontent-generate
for f in skills/ai/content/aliyun-aicontent-generate/scripts/.py; do python3 -m py_compile "$f" done
echo "py_compile_ok" > output/aliyun-aicontent-generate/validate.txt
通过标准:命令退出 0 且 output/aliyun-aicontent-generate/validate.txt 被生成。
输出和证据:
将工件、命令输出和 API 响应摘要保存在 output/aliyun-aicontent-generate/ 下。
在证据文件中包含关键参数(区域/资源 ID/时间范围)以实现可复现性。
先决条件:
在执行之前配置最小权限的阿里云凭证。
更喜欢环境变量:ALICLOUD_ACCESS_KEY_ID、ALICLOUD_ACCESS_KEY_SECRET、可选的 ALICLOUD_REGION_ID。
如果区域不清楚,在运行变异操作之前询问用户。
参考资料:
来源:references/sources.md
GitHub
CLI
API