SuperAPI AI 工具集

generate

编程与开发

查看项目

更新于 10-15 21:33

技能介绍

用途:VelsGenerate 是 Node.js 命令行工具(零依赖,Node >= 18),通过 KIE API(kie.ai)调用上百种模型生成图片、视频和音频。

主要能力:模型注册表为动态实时数据,不内置固定列表,可用 velsgenerate models --refresh --json 从 docs.kie.ai 更新,并按类别或关键词搜索;支持文生图、图生视频、文生视频、音乐、TTS、图像编辑与放大等任务。

安装与配置:npx -y velsgenerate setup 可下载 CLI 并运行向导(配置 API 密钥并校验余额);已全局安装则用 velsgenerate setup;持久安装用 npm i -g velsgenerate。密钥也可通过 export KIE_API_KEY=... 或 velsgenerate config --set-key 设置,用 velsgenerate credits 检查余额。

常用命令:models 查询模型;upload 上传本地文件获取 fileUrl;run 运行模型,支持 --prompt、--image、--set、--json-input、--wait、--timeout、--download;status 与 wait 查询任务;download 下载结果。--set 的值按 JSON 解析,--json-input 可传原始 JSON。

使用建议:先查模型再运行,始终加 --json 获取机器可读输出;结果 URL 约 24 小时有效,应尽快下载;视频和音乐耗时较长,建议 --timeout 900 或更高。

限制:需自备 KIE API 密钥;错误码含义为 401 密钥问题、402 余额不足、422 输入无效、429 限流、451 输入图片未下载、455 维护、501 生成失败。模型 id 不应凭记忆使用,须先查询。密钥不要放在命令行参数中(config --set-key 除外)。