{"id":"geek-skills-seedream-imagegen","name":"seedream-imagegen","summary":"AI画像はByteDance Seedream 4.0 API(Segmind経由)を使って生成されます。","body":"# Seedream 4.0 图像生成\n\n通过 `scripts/generate_image.py` 调用 Seedream 4.0 生成专业级图像。\n\n## 验收标准（每次生成任务完成前自查）\n\n- [ ] 提示词经过结构化优化（[主题]+[风格]+[细节]+[质量词]），不是用户原话直接透传\n- [ ] size / aspect_ratio 与用途匹配（见参数对照表），不是默认值裸跑\n- [ ] 图像已落盘并把**实际文件路径**回报给用户\n- [ ] 重要用途（海报/品牌）生成 ≥3 张供选择\n- [ ] 告知了本次消耗（张数×分辨率），4K 提前说明更耗时耗额度\n\n## 不做什么\n\n- 不编辑、重绘、扩展已有图片——只做文生图（参考图仅用于风格指导）\n- 无 `SEGMIND_API_KEY` 时不硬试：告知用户去 segmind.com 获取，或改用环境内其他生图 skill\n- 不对生成内容的版权归属下结论\n- 用户只要一张随手配图时,不展开完整需求问卷,合理默认直接出\n\n## 工作流程\n\n### 1. 收集需求（缺什么问什么，不逐项走问卷）\n必需：图像内容描述。推荐确认：尺寸（默认 2K）、比例（默认 1:1）、数量（默认 1）。\n\n**用途 → 参数对照表**\n\n| 用途 | size | aspect_ratio | max_images |\n|------|------|--------------|------------|\n| 社交媒体 | 2K | 1:1 或 9:16 | 1-3 |\n| 网页横幅 | 2K | 16:9 或 21:9 | 1 |\n| 打印海报 | 4K | 4:3 或自定义 | 1-2 |\n| 产品图 | 2K | 3:2 或 4:3 | 3-5 |\n| 概念设计 | 2K | 16:9 | 5-10 |\n\n### 2. 优化提示词\n结构：[主题] + [风格] + [细节] + [质量修饰词]，补光照与氛围；需要图内文字时明确指定文字内容与字体风格；建议 200-300 词内。\n示例：\"一只猫\" → \"A fluffy orange tabby cat on a wooden windowsill, golden hour lighting, cozy interior, warm palette, professional photography, detailed fur texture\"。\n风格关键词库与更多范式：`references/prompt_engineering.md`。\n\n### 3. 执行\n\n```bash\npython scripts/generate_image.py \\\n  --prompt \"优化后的提示词\" \\\n  --size 2K --aspect-ratio 16:9 --max-images 1 \\\n  --output-dir ./outputs\n# API key 从环境变量 SEGMIND_API_KEY 读取，或用 --api-key 传入\n```\n\n高级用法（参考图 `image_input` ≤3 张 / 顺序批量 `sequential=True` 保持系列一致 / `size=custom` 自定义宽高）：\nPython 调用示例见 `references/quick_start.md`，参数完整说明见 `references/api_reference.md`。\n\n### 4. 迭代\n不满意时先问具体不满意什么，再对症调整：细节不足→加描述；风格不对→换风格关键词或上参考图；清晰度→升 4K；选择面→加张数。\n\n## 已知陷阱\n\n| 陷阱 | 具体表现 | 应对 |\n|------|---------|------|\n| 401 / 额度耗尽 | API 报 401 或 quota 错误 | 检查 SEGMIND_API_KEY；额度问题如实告知用户，不静默重试烧额度 |\n| 内容审核拒绝 | 提示词含敏感元素被拒 | 告知被拒原因类别，改写提示词规避后重试一次；连续被拒则停下与用户确认 |\n| 图内文字模糊 | 生成的海报文字发虚、错字 | 提示词明确指定文字内容+字体风格，加 \"high contrast, bold typography\"；升 4K；仍不行改\"留位后期加字\" |\n| 4K 时间预期 | 用户以为卡住 | 提前说明 2K 约 2 秒、4K 约 4-6 秒，批量线性叠加 |\n| 超限参数静默失败 | >15 张或 >3 参考图 | 生成前校验参数上限，超限先拆分或询问 |\n| 直接透传短提示词 | \"一只猫\"直接发 API，出图平庸 | 验收标准第一条：必须先优化 |\n\n## 参考文档（按需加载）\n\n| 文件 | 何时读 |\n|------|--------|\n| `references/prompt_engineering.md` | 优化提示词、查风格关键词库时 |\n| `references/api_reference.md` | 需要完整参数说明、错误码、性能指标时 |\n| `references/quick_start.md` | 需要 Python 调用示例（参考图/批量/自定义尺寸）时 |\n\n`evals/routing-evals.json` — 触发边界回归用例，改 description 后用仓库根 `scripts/run_routing_evals.py` 校验。","author":"@staruhub","ownerProfile":null,"authorContacts":null,"sourceUrl":"https://github.com/staruhub/ClaudeSkills/tree/main/lab/Geek-skills-seedream-imagegen","license":"MIT","category":"coding","lang":"multi","tokens":1221,"stars":0,"calls30d":2,"claimed":false,"visibility":"public","origin":"crawler","version":"0.1.0","createdAt":"2026-08-22","updatedAt":"2026-08-22","files":[{"path":"evals/routing-evals.json","size":1606,"sha256":"5b53ef975c5099c0f867fad84a8d95fd45a82fe3f517c790231a0438218c2614"},{"path":"references/api_reference.md","size":3239,"sha256":"f5915f28998349a05533c98a9680a0f40a1cbd779373ada5e1f74451fa73560e"},{"path":"references/prompt_engineering.md","size":4953,"sha256":"f2e567fe16303e8136b6335f088d852530395b3a3eb8a401b78100321ac329ec"},{"path":"references/quick_start.md","size":2307,"sha256":"168143dd7e374b908eb946df172f244cec9d15d9499b3727ee92befbe563c977"},{"path":"scripts/generate_image.py","size":12264,"sha256":"15db12f1d372afcaffedbad8ac473846e9972b8dc4ea28888a8414ca24986e19"}],"requires":{"mcp":[],"tools":[]},"safety":{"flags":[{"code":"net.endpoints","kind":"exfiltration","excerpt":"api.segmind.com, www.segmind.com","message":"bundled scripts reach 2 external host(s)","severity":"warn"}],"scannedAt":"2026-08-22","hasScripts":true,"networkEndpoints":["api.segmind.com","www.segmind.com"]}}