Seedream 5.0 Lite图片编辑

解决的核心问题

在需要批量或自动化处理电商主图、商品详情页、广告 KV 等商业视觉时，直接调用裸 API 往往面临参数拼装繁琐、参考图上传逻辑复杂、任务状态轮询与结果下载容易遗漏等问题。本 Skill 将 AI Hive OpenAPI 的 public_model_seedream_5_0_lite 接口封装为标准化的命令行工具，让设计师和开发者能够通过简单的参数组合完成从参考图上传、价格快照获取到任务轮询和本地下载的完整闭环。

技能工作流与核心能力

脚本内部将整个调用链路拆分为几个关键模块：

• 配置与鉴权：通过 init 子命令或环境变量安全注入 sk-api-* 格式的 API Key，并写入权限为 0600 的本地配置文件。
• 参数校验与路由：在提交前使用 _validate_image_inputs() 确保至少传入一张参考图，并支持 COST_FIRST（默认）、SPEED_FIRST 和 SUCCESS_FIRST 三种路由策略，以适配不同场景下的成本与速度偏好。
• 任务编排：generate 子命令接收 --prompt 与 --image，自动完成参考图上传、获取实时 pricingSnapshot、提交任务并调用 poll_task() 进行轮询，最终将生成的 PNG/JPEG/WebP 图片下载至 ~/Downloads/AiHive。

适用边界与工程注意点

虽然该 Skill 固定了 publicModelId 以避免模型被意外替换，但在实际工程落地时仍需关注以下几点：

• 参考图角色需明确：多参考图场景下，需在提示词中清晰界定每张图的作用（如主体、材质、构图），避免模型因输入冲突产生幻觉。
• 文字生成需人工复核：对于必须逐字出现的商业文案，建议在提示词中用引号包围并指定位置，且最终交付前必须经过人工校验。
• 计费与超时控制：取得 taskId 后应严格基于原任务进行查询，避免重复提交导致扣费；若任务超时，应保留 taskId 以便后续继续轮询。