用途:面向 Agent 的小云雀(xyq)综合创作技能,把用户的自然语言描述或参考素材提交给后端创作平台,生成或编辑图片、视频,并取回产物。
主要能力:生成(文生图、文生视频、图生视频、视频续写)、编辑(局部修改、元素替换、镜头调整、风格迁移)、复杂创作(一句话生成短剧、复刻风格做 TVC/宣传片、音乐生成 MV)。四类脚本:submit_run(创建会话或向已有会话发消息)、get_thread(按 thread_id、run_id、after_seq 增量轮询消息)、upload_file(上传图片或视频,返回 asset_id)、download_results(批量下载产物,可指定输出目录与前缀)。
必要用法:需设置环境变量 export XYQ_ACCESS_KEY="your-access-key",可选 XYQ_OPENAPI_BASE 或 XYQ_BASE_URL,默认 https://xyq.jianying.com,仅用 Python 标准库。典型流程:有本地参考文件先 upload_file 拿 asset_id;再 submit_run --message "..." [--thread-id] [--asset-ids ...] 拿到 thread_id、run_id、web_thread_link,并立即把链接展示给用户;然后每 10 秒 get_thread 增量轮询;若出现意图确认则向用户展示问题并用同一 thread_id 重新提交;产物 URL 出现后 download_results 下载并展示。
限制:上传仅支持 image/ 与 video/,单文件不超过 200MB,单次指令仅支持单个文件。轮询间隔 10 秒,连续 48 小时无结果应告知用户稍后再看;单次查询失败可重试一次,连续 3 次失败应停止。用户侧 Agent 只做上传、提交、传话和取件,不应替用户扩写或翻译 prompt、自行编排分镜,也不要在消息里添加自编提示词。完整参数细节与更多示例以资料为准。