SuperAPI AI 工具集

seedream-cli

设计与创作

查看项目

更新于 10-16 07:17

技能介绍

用途:seedream 是火山引擎方舟(Volcengine Ark)上 Seedream 图像模型的命令行界面,二进制名为 seedream,与 seedance 同仓库,可单独作为 npm 包发布,也随 seedance v0.2.0+ 捆绑。使用同步的 /api/v3/images/generations 接口,无任务轮询与任务数据库。

主要能力:唯一生成命令为 seedream generate,由提示词与参考图决定模式——文生图、图生图/编辑、多图融合(最多 10 张参考图)、连续图像组(2–4 张,Seedream 4.0+)。支持 --model(standard/4.0、5.0、pro 或原始 Ark 模型 ID)、--image/-i(可重复,URL、本地路径或 asset://)、--size(1024x1024、2048x2048、1K、2K、4K、adaptive)、--output/-o、--sequential、--seed、--watermark、--response-format(url 或 b64_json)、--quiet、--json。

使用方式:安装可执行 npm install -g seedream,或 npm install -g seedance(v0.2.0+ 捆绑),或 cargo install --git https://github.com/vaxin/seedance-cli --bin seedream。配置 API key:export ARK_API_KEY=your-key,或 seedream config set api_key <KEY>;配置存于 ~/.config/seedream/config.toml,环境变量优先。示例:seedream generate "A cozy ramen shop at midnight";编辑:seedream generate "Change the background to a snowy mountain at dawn" -i photo.jpg;融合:seedream generate "Blend these two characters into one scene" -i hero.png -i landscape.jpg -o fusion.jpg;连续组:seedream generate "The same tree across four seasons" --sequential 4 --size 2048x2048。

本地文件处理:本地参考图 ≤10MB 时内联为 base64 data URI,更大文件自动上传 TOS(需 TOS_ACCESS_KEY、TOS_SECRET_KEY、TOS_BUCKET 环境变量),URL 与 asset:// 直接透传。输出默认文件名 seedream-YYYYMMDD-HHMMSS.<ext>,扩展名按图像字节嗅探,通常为 .jpg;--quiet 仅打印保存路径。

限制:融合最多 10 张参考图;--sequential 必须在 2–4 之间;pro 别名模型 ID 未经验证,可能需在方舟控制台确认或传原始 ID;HTTP 429 为限流需退避重试;HTTP 404 表示模型未找到。提示词建议:图内文字用引号标注精确字符串,编辑时加“keep everything else identical”,融合时用序号指代参考图。

适用场景:脚本化批量图像生成、图像编辑与风格转换、多图融合、连续图像组创作。