SuperAPI AI 工具集

renoise-cli

设计与创作

查看项目

更新于 10-15 17:17

技能介绍

用途:在智能体工作流中通过本地 renoise 命令行调用 Renoise AI 平台,完成鉴权、能力检查、媒体分析、生成视频/图像/音频、上传素材、查询任务状态与结果。平台 URL 为 https://www.renoise.ai。

主要能力:renoise version、auth status --json、model --json、analyze、task create/wait/get/result/cancel/list/cost/chain/tags、material、upload、account status/history 等。命令是鉴权、命令、模型、能力、默认值、校验、API 行为、上传、任务状态和输出格式的唯一事实来源,不应在插件中维护模型表。

使用方式:每个生成会话先运行预检,执行 check-plugin.mjs 和 install-cli.mjs --ensure,Unix 导出 PATH="${HOME}/.local/bin:${PATH}",Windows 将 $env:LOCALAPPDATA\Renoise\bin 加入 Path,再确认 renoise 可用。选择模型时先读 model-routing,若用户指定模型则保留,否则按所需能力筛选,并运行 renoise model <model> --json 确认参数。根据本地图片或视频分析使用 renoise analyze <local-media-path> --target image|video --language <user-language> --json。生成时先创建任务并记录 task.id,再单独等待;若 wait 超时或中断,重跑 wait 而不是 create。付费前必须完成最终提示词、用 renoise task cost 估算、计算批量与附加成本、对比账户余额,并展示提示词和参数以获得明确批准;任何提示词、模型、参数、素材映射、次数或估算变化都需重新批准。素材用 renoise upload 上传一次并复用 ID,提示词中用 @material:<ID> 引用。

适用场景:图片或视频理解与分析、AI 视频/图像/音频生成、参考媒体重制、源视频编辑、多段叙事与角色连续性工作流、素材库管理、任务成本估算与账户查询。

限制:task create 是付费操作边界,必须取得明确批准;不要引用静态价格;不要自行推测内容审核结果,仅在 CLI/API 返回 INPUT_/OUTPUT_ 明确错误时报告并停止;不要在插件端实现模型表或 API 逻辑;不要把 API key 粘贴到聊天;不要假设角色组合跨模型通用;本地分析不独立探测视频精确时长,需要在执行来源限制或估算自动时长编辑前自行验证。平台地址不要使用 renoise.com。部分脚本(batch-generate.sh、generate-preview.mjs、analyze-beats.py)为本地实现工具,使用前应查看帮助或源码,不应在 Hosted Agent 中运行。