用途
本技能用于管理 Spotify Ads API 中的创意素材（creative assets），即广告投放所需的音频、视频和图片文件。它提供上传、列出、查询详情、归档与取消归档等操作。
主要能力
- 上传素材：支持音频（MP3、WAV、OGG）、视频（MP4、MOV）、图片（PNG、JPEG）。上传采用两步流程：先创建素材元数据，再上传文件。
- 列出素材：可按类型（audio、video、image）筛选，未指定类型时列出全部素材。
- 查询详情：获取指定素材的完整信息，包括名称、类型、状态、时长、尺寸、宽高比、URL 等。
- 归档与取消归档：通过批量操作接口对素材进行归档或恢复。
使用方式
参数格式为 <operation> [arg]，支持的操作包括：
upload <file_path>— 上传新素材list [audio|video|image]— 列出素材，可选按类型筛选get <asset_id>— 获取指定素材详情archive <asset_id>— 归档素材unarchive <asset_id>— 取消归档
未提供参数时，会询问要执行的操作。
上传流程
- 根据文件扩展名判断素材类型（.mp3/.wav/.ogg 为 AUDIO，.mp4/.mov 为 VIDEO，.png/.jpg/.jpeg 为 IMAGE），无法识别时需用户指定。
- 提示输入素材名称（2-120 字符），默认使用不含扩展名的文件名。
- 创建素材元数据，从响应中提取 id。
- 上传文件：文件 ≤ 20MB 使用简单上传；文件 > 20MB 使用分块上传（启动会话、按 max_chunk_size_mb 分块、逐块上传、完成会话、清理临时分块）。上传使用原始 curl 以支持 multipart 表单数据。
- 轮询处理状态：每 3 秒查询一次，最长 60 秒，直到状态从 PROCESSING 变为 READY 或 REJECTED。
- 展示最终素材详情（ID、名称、类型、状态、URL、时长、尺寸、宽高比等）。若被 REJECTED，提示文件可能不符合格式要求。
环境设置
需设置插件根目录并定义请求包装器：
PLUGIN_ROOT="${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}"
api() { "$PLUGIN_ROOT/scripts/api-request.sh" assets "$@"; }
首次调用 Ads API v3 前，需阅读并遵循 $PLUGIN_ROOT/skills/api-reference/references/live-openapi.md。可通过 api --env 获取设置值（TOKEN、AD_ACCOUNT_ID、AUTO_EXECUTE、BASE_URL、SDK_HEADER、SKILL_HEADER、PLUGIN_VERSION），输出可安全 eval。
适用场景
适用于需要通过 Spotify Ads API 管理广告创意素材的自动化流程，例如批量上传广告音频/视频/图片、查询素材处理状态、整理素材库等。
限制
- 简单上传最大文件为 20MB，超过需使用分块上传。
- 素材名称长度限制为 2-120 字符。
- 音频建议 128kbps 以上、44.1kHz 以上采样率；视频建议宽高比为 16:9、1.91:1、1:1、9:16。
- 执行行为受 auto_execute 控制：为 true 时直接执行 API 调用；为 false 时先展示 curl 命令并请求确认。
- 出错时展示响应体中的错误信息。