小云雀

要解决什么问题

Agent 需要对接小云雀（剪映侧 AI 创作平台）时，往往要在「会话里让后端 Agent 自己编排」和「单次直调图片/视频模型」之间做路由，还要处理素材上传、thread_id/run_id 轮询、意图确认与 credits 消耗。本技能把这几条路径收敛成可执行的约定，避免用户侧 Agent 替后端写分镜或润色 prompt。

技能如何工作

执行路由是入口判断：

• 图片直出：用户明确要求模型直出或指定图片模型（如 seedream_5.0_pro）时，用 pippit-tool-cli generate-image，再用 query-result 每 10 秒轮询直到 completed=true。
• 视频直出：含首尾帧（--generate-type 1、按顺序两次 --image）等场景走 generate-video，同样轮询取 videos[].output_path。
• 会话编排：复杂编辑、MV/TVC、未要求直出时，用 submit_run.py / get_thread.py 发用户原文与 asset_id，由后端 Agent 编排。
• 短剧：短剧生成/续写等应转交 xyq-short-drama-skill，不要在本技能里假装跑完整短剧。

配套能力包括：创建会话/发消息、增量查询会话（after_seq）、上传图片/视频/mp3/wav（得 asset_id）、批量下载产物。可选环境变量 XYQ_OPENAPI_BASE / XYQ_BASE_URL，默认 https://xyq.jianying.com。鉴权为 Authorization: Bearer。

边界与注意点

用户侧职责是传话：不扩写、不翻译、不自行加风格词；真实提交前若未确认需征得用户同意。CLI 直出前须确认 pippit-tool-cli 在 PATH 中，不可用时应报错而非悄悄降级到会话 API。--resolution 等参数以用户与服务端为准，skill 侧不维护额外 allowlist。轮询最长 48 小时；连续查询失败 3 次则停止。单文件上传须小于 200MB。