chanjing-openapi-tools

用途

Chanjing OpenAPI Tools 面向蝉镜开放平台的非媒体生成工作流，提供一组命令行工具，用于查询平台资源信息、管理分片上传以及生成创意 Briefing。使用该工具需要已配置的蝉镜 OpenAPI AK/SK。

主要能力

该工具覆盖以下开放平台接口：

GET /open/v1/tag_list：查询公共资源标签。
POST /open/v1/consume_detail：查询消耗明细。
GET /open/v1/price/catalog：查询价格目录。
POST /open/v1/common/create_multipart_upload：创建分片上传。
POST /open/v1/common/complete_multipart_upload：完成分片上传。
GET /open/v1/common/file_detail：查询文件详情。
POST /open/v1/creative/creative_briefing：按商品生成创意雷达 Briefing。

使用方式

通过 Python 脚本调用，命令示例：

python3 skills/chanjing-openapi-tools/scripts/openapi_tools.py consume-detail \
  --start-time '2026-08-01 00:00:00' --end-time '2026-08-02 00:00:00'
python3 skills/chanjing-openapi-tools/scripts/openapi_tools.py price-catalog --item-code <item_code>
python3 skills/chanjing-openapi-tools/scripts/openapi_tools.py create-multipart-upload \
  --file-size 1048576 --name source.mp4 --service video
python3 skills/chanjing-openapi-tools/scripts/openapi_tools.py complete-multipart-upload --upload-id <upload_id>
python3 skills/chanjing-openapi-tools/scripts/openapi_tools.py file-detail --id <file_id>
python3 skills/chanjing-openapi-tools/scripts/openapi_tools.py creative-briefing \
  --product-name '产品名称' --creative-hint '卖点方向'

全部命令输出接口返回的 data 字段 JSON。

适用场景

适用于需要查询蝉镜平台标签、消耗明细、价格目录，管理分片上传流程，或按商品生成创意 Briefing 的场景。

限制

分片上传的具体分片传输按创建接口返回的签名和分片规则执行；本工具不直接读取或上传本地文件。使用前需配置蝉镜 OpenAPI AK/SK。

技能介绍

用途

主要能力

使用方式

适用场景

限制