image-gen-seedream 使用说明书

Seedream 图片生成(火山方舟 Ark)· 文生图 + 参考图生图(单图/多图)· 仅用 Python 标准库
类型 图片生成 / 文生图 + 图生图
输入 提示词 +(可选)参考图(本地 / URL,最多 14 张)+ 火山方舟 API Key + 尺寸 / 比例
输出 本地图片(默认 ./seedream_output/seedream_时间戳_序号.扩展名)
触发词 用 Seedream 生成图片 / 文生图 / 图生图 / 参考图生图 / 给我画一张…(且指定火山方舟 doubao-seedream)

一、你该对我说什么(人话示例)

你只要说清楚「画什么 / 参考哪张图 / 什么比例」,并把火山方舟的 API Key 给我。Key 只在运行时传入,不会落盘、不会写进任何文件或记忆。

二、工作流程(3 步)

步骤环节谁来做
1收集输入:提示词、参考图(可选)、尺寸、Key你提供
2调用脚本生成自动
3下载 / 呈现结果自动
💡 两种模式:① 文生图——只给提示词;② 参考图生图——给 1~14 张参考图(本地或 URL)+ 提示词,生成风格 / 内容对齐的新图。默认模型 doubao-seedream-5-0-260128(Seedream 5.0 lite)。

三、实战范例(照抄即可用)

场景 A:文生图(只给提示词)

ARK_API_KEY="你的火山方舟Key" python "/skills/image-gen-seedream/generate.py" ^
       --prompt "星际穿越,黑洞里冲出一辆复古列车,电影大片,末日既视感,oc渲染,光线追踪,深蓝,暗黑风" ^
       --size "2K" --watermark true

提示词很长时,可先写到 .txt 文件,再用 --prompt-file 路径.txt 传入。

场景 B:参考图生图(本地图)

ARK_API_KEY="你的火山方舟Key" python "/skills/image-gen-seedream/generate.py" ^
       --prompt "把这张头像变成赛博朋克风格,霓虹光,下雨的街道" ^
       --image "D:/头像.png" --image "D:/参考风格.jpg" ^
       --size "1728x2304" --watermark false

参考图用 URL 时,--image 直接传链接即可;本地图脚本会自动转 base64(jpeg/png/webp/bmp/tiff/gif/heic/heif,单张 ≤30MB、≤6000×6000px)。

跑完脚本会打印 OK + 每张图的本地路径 + 一行 __META__{...} JSON,我用 present_files 把图直接给你看 / 下载。

四、常用参数速查

参数默认说明
--prompt必填提示词(中/英均可,建议 ≤300 汉字)
--image可选(可重复)参考图:本地路径或 URL,最多 14 张;文生图留空
--size2K分辨率档位 1K/2K/3K/4K,或显式 WxH 像素(如 2048x2048)。两种写法不可混用
--modeldoubao-seedream-5-0-260128换模型时指定
--watermarktrue是否打「AI生成」水印
--sequentialdisabledauto=组图(按提示词自动判断数量)
--response-formaturlb64_json=返回 base64(自动解码保存)
--outdir./seedream_output输出目录

常用预设尺寸(W×H 像素)

比例W×H
1:12048×2048
3:4(竖)1728×2304
4:3(横)2304×1728
9:16(竖屏)1440×2560
16:9(横屏)2560×1440
21:9(超宽)3024×1296

总像素约 [2560x1440, 4096x4096],宽高比范围 [1/16, 16]。

五、⚠️ 必读提醒(内容审核 + 路径)

火山方舟 Seedream 内容审核非常严格(2026-08-02 实测)。以下中文关键词会触发 InputTextSensitiveContentDetected(HTTP 400):

良性中文提示词(风景、动物、日常场景)正常通过——审核是关键词级别,不是全中文拦截。

六、环境与路径(本机已验证)

项本机状态
依赖仅 Python 标准库(urllib / base64 / json),无需 pip install ✓
端点https://ark.cn-beijing.volces.com/api/v3/images/generations(POST,JSON,Bearer 鉴权)
脚本位置/skills/image-gen-seedream/generate.py
📌 一句话总结:给我一句画什么(可选加参考图)+ 你的火山方舟 Key,我调 Seedream 出图存到本地给你看;注意避开那几个会触发审核的敏感词,带标题的海报建议底图生成 + 本地叠字。
← 返回 SKILL 库