seedream-imagegen

1# Seedream 4.0 图像生成
2 
3通过 `scripts/generate_image.py` 调用 Seedream 4.0 生成专业级图像。
4 
5## 验收标准（每次生成任务完成前自查）
6 
7- [ ] 提示词经过结构化优化（[主题]+[风格]+[细节]+[质量词]），不是用户原话直接透传
8- [ ] size / aspect_ratio 与用途匹配（见参数对照表），不是默认值裸跑
9- [ ] 图像已落盘并把**实际文件路径**回报给用户
10- [ ] 重要用途（海报/品牌）生成 ≥3 张供选择
11- [ ] 告知了本次消耗（张数×分辨率），4K 提前说明更耗时耗额度
12 
13## 不做什么
14 
15- 不编辑、重绘、扩展已有图片——只做文生图（参考图仅用于风格指导）
16- 无 `SEGMIND_API_KEY` 时不硬试：告知用户去 segmind.com 获取，或改用环境内其他生图 skill
17- 不对生成内容的版权归属下结论
18- 用户只要一张随手配图时,不展开完整需求问卷,合理默认直接出
19 
20## 工作流程
21 
22### 1. 收集需求（缺什么问什么，不逐项走问卷）
23必需：图像内容描述。推荐确认：尺寸（默认 2K）、比例（默认 1:1）、数量（默认 1）。
24 
25**用途 → 参数对照表**
26 
27| 用途 | size | aspect_ratio | max_images |
28|------|------|--------------|------------|
29| 社交媒体 | 2K | 1:1 或 9:16 | 1-3 |
30| 网页横幅 | 2K | 16:9 或 21:9 | 1 |
31| 打印海报 | 4K | 4:3 或自定义 | 1-2 |
32| 产品图 | 2K | 3:2 或 4:3 | 3-5 |
33| 概念设计 | 2K | 16:9 | 5-10 |
34 
35### 2. 优化提示词
36结构：[主题] + [风格] + [细节] + [质量修饰词]，补光照与氛围；需要图内文字时明确指定文字内容与字体风格；建议 200-300 词内。
37示例："一只猫" → "A fluffy orange tabby cat on a wooden windowsill, golden hour lighting, cozy interior, warm palette, professional photography, detailed fur texture"。
38风格关键词库与更多范式：`references/prompt_engineering.md`。
39 
40### 3. 执行
41 
42```bash
43python scripts/generate_image.py \
44  --prompt "优化后的提示词" \
45  --size 2K --aspect-ratio 16:9 --max-images 1 \
46  --output-dir ./outputs
47# API key 从环境变量 SEGMIND_API_KEY 读取，或用 --api-key 传入
48```
49 
50高级用法（参考图 `image_input` ≤3 张 / 顺序批量 `sequential=True` 保持系列一致 / `size=custom` 自定义宽高）：
51Python 调用示例见 `references/quick_start.md`，参数完整说明见 `references/api_reference.md`。
52 
53### 4. 迭代
54…