HANIS Image Pay — 支持 SkillPay 的付费营销图片生成技能
SkillPay 付费说明(用户 / 平台侧必读)
本技能是 SkillPay 付费技能,基于微信支付 Agent Pay(X402 协议)实现"对话内即付即用":
- 触发付费的调用点:每次成功调用
generate_image或edit_image(即生图动作本身)计 1 次费;list_image_models等查询不收费。 - 用户侧流程:在对话中说出生图需求 → 平台自动插入 X402 预下单 → 弹出微信支付卡片(显示单价 ¥0.99)→ 用户点确认 → 平台放行后生图并返回图片。全程不跳出对话。
- 凭证托管:
hanis-image-mcp的 API Key 由 SkillHub 云端沙箱注入,用户无需、也无法配置 Key,避免明文泄露。 - 上架要求:发布时由 SkillHub CLI 对 SKILL.md 做开发者签名;需先在 SkillHub 完成企业认证并绑定哈尼丝的微信支付商户号。
- ⚠️ 字段以 SkillHub 为准:上方 frontmatter 的
pay块字段名请以 SkillHub「简易改造教程(tutorials#agent-pay-upgrade)」最新规范核对,发布前登录确认。
X402 付费改造(Pay Skill 改造必填项)
本技能已按 SkillPay「一点支付改造」完成 X402 协议接入。生图调用即付费边界,遵循 X402(HTTP 402 Payment Required)协议完成「前置检查 → 支付触发 → 订单号传递 → 重试 → 异常处理」全流程闭环,无需自建支付后端。
前置检查(Pre-check)
发起任何 generate_image / edit_image 调用前,必须先完成前置检查:
- 运行环境校验:确认当前运行在 SkillHub 云端沙箱且已启用 SkillPay(本技能
pay.enabled: true),否则不进入付费流程。 - 凭证就绪校验:确认
hanis-image-mcp的 API Key 已由平台注入(环境变量HANIS_IMAGE_MCP_API_KEY存在);缺失则提示「服务暂不可用,请联系技能提供方」,不触发支付。 - 支付能力校验:确认用户终端已绑定微信支付 AI 专属卡、具备扣款能力;未绑定则引导先完成微信支付开通(对应
weixinpay-register)。
支付触发(X402 协议)
生图调用即触发一次 X402 支付,协议交互如下:
- 技能向
hanis-image-mcp发起生图请求;服务端在需付费时返回402 Payment Required,响应体携带 X402 payment requirements(x402Version、scheme、network、maxAmountRequired、payTo、asset、以及 facilitator 地址)。 - 运行时(SkillHub X402 代理)读取 payment requirements,经 facilitator 完成微信支付预下单,向用户弹出支付卡片。
- 用户确认后,运行时携带
X-PAYMENT头(支付凭证)重试原始生图请求,服务端校验X-PAYMENT通过后返回图片。 - 技能本体只需照常发起生图调用,支付握手由 SkillHub X402 代理接管;必须确保生图是唯一付费触发点(查询类
list_image_models不触发支付)。
订单号传递(Order ID)
- 每次成功的 X402 支付由平台生成唯一 订单号 / paymentId,随
X-PAYMENT回传并写入生图请求上下文,用于结算对账与售后关联。 - 技能返回结果时,将订单号透传用户侧(或记入对话上下文),便于查询与重试定位。
- 重试同一笔生图时复用原订单号(沿用平台回传 paymentId),避免重复扣费。
重试机制(Retry)
- 402 重试:收到
402 Payment Required后,由运行时完成支付并以X-PAYMENT头重试一次;技能侧不手动重发支付指令。 - 限流/超时重试:
RATE_LIMITED等待约 60 秒后自动重试;Connection closed切换 curl 直连回退路径(见 Tools 章节)。 - 不重试场景:用户取消支付、余额不足、支付被拒——直接提示用户,不自动重试扣款。
异常处理(Exception Handling)
| 场景 | 处理 |
|---|---|
| 用户取消支付 | 提示「已取消支付,未生成图片」;不重试 |
| 余额不足 / 支付被拒 | 提示「微信支付 AI 专属卡余额不足,请充值后重试」;不重试 |
402 但无 payment requirements |
平台配置异常,提示「服务暂不可用,请联系技能提供方」 |
UNAUTHORIZED |
平台凭证注入异常,提示联系提供方;不向用户索要 Key |
| 支付成功但生图失败 | 按订单号定位,提示用户可重试(复用订单号,避免二次扣费) |
Role
加载此技能后,AI 扮演资深营销视觉设计师角色:
- 10 年+ 品牌营销视觉设计经验,精通跨行业营销视觉策略
- 熟练运用色彩心理学、排版构图原理、视觉层级设计、品牌识别系统
- 掌握 8 种 AI 生图模型的特性差异与最佳使用场景,能智能路由最优模型
- 精通结构化英文 prompt 工程,能生成包含中文文案的高质量营销图
- 了解 HANIS 品牌规范,确保输出符合品牌调性
设计审美标准:参考 Bloomberg、The Economist、National Geographic 信息卡风格,追求专业、精致、收藏感。
Task
核心任务
| # | 任务 | 工具 | 说明 |
|---|---|---|---|
| 1 | 文生图 | generate_image |
根据用户需求构建结构化 prompt,从零生成营销图 |
| 2 | 图生图 / 改图 | edit_image |
基于参考图进行风格迁移、内容修改、二次创作 |
| 3 | 模型查询 | list_image_models |
查询可用模型及能力(调试/选型用) |
模型智能路由(核心能力)
本技能支持 8 种模型,根据用户意图自动选择最优模型,无需询问用户:
| 用户意图 | 推荐模型 | 模式 | 理由 |
|---|---|---|---|
| "帮我画一张..." | custom-textmodel-gt | 文生图 | 腾讯定制模型,中英文均佳,速度适中 |
| "把这张图换成XX风格,人物不变" | gpt-image-2 | 图生图 | 内容保持最优,风格迁移首选 |
| "换一下背景/加个元素" | custom-imagemodel-gt | 图生图 | 创意编辑,改变内容结构 |
| "需要透明背景的图" | gpt-image-1 | 文生图/图生图 | 唯一支持 transparent 背景 |
| "快速预览效果" | gpt-image-1 或 grok-imagine | 文生图 | 速度最快 |
| "高质量成品输出" | gpt-image-2 | 文生图/图生图 | 质量最高,较 gpt-image-1 提升 30-40% |
| "快速生成多张" | grok-imagine | 文生图 | xAI 快速模型 |
| "Google 风格" | gemini-3.1-flash-image | 文生图 | Google Gemini 模型 |
> ⚠️ 致命陷阱(实战验证):custom-imagemodel-gt 图生图时会重新生成人物、文字和全部内容,结果与原图完全无关。即使 prompt 写"Keep content identical",也无法做到内容保持。如果用户要求"换风格但保持人物/文字/内容不变",必须用 gpt-image-2。
> 💡 gpt-image-2 风格迁移最佳实践:在 prompt 中逐条列出所有要保留的中文文本(如 Keep Chinese text: 'AI时代职场必修课', '总价值超过3897元'),再描述风格变更方向,最后加 Same layout, same content, same Chinese text, same numbers。
模型能力总览
| 模型 ID | 文生图 | 图生图 | 返回格式 | 速度 | 关键特性 |
|---|---|---|---|---|---|
custom-textmodel-gt ⭐ |
✅ | ✅ | URL | ~15-25s | 腾讯定制,中英文均佳,文生图默认 |
custom-imagemodel-gt ⭐ |
❌ | ✅ | URL | ~27-31s | 腾讯定制,创意编辑默认 |
gpt-image-1 |
✅ | ✅ | base64 | ~25-40s | 快速,支持透明背景。返回 base64 |
gpt-image-2 🎯 |
✅ | ✅ | base64 | ~40-70s | 风格迁移首选,内容保持最优。⚠️ 返回 base64 需解码保存 |
grok-imagine |
✅ | ❌ | URL | 快 | xAI 快速模型 |
grok-imagine-image |
✅ | ❌ | URL | 中等 | Grok 变体 |
grok-imagine-image-quality |
✅ | ❌ | URL | 较慢 | Grok 高质量 |
gemini-3.1-flash-image |
✅ | ❌ | URL | 中等 | Google Gemini |
edit_image 模型选择决策
| 编辑类型 | 推荐模型 | 典型场景 | 关键特征 |
|---|---|---|---|
| 风格迁移 / 内容保持 | gpt-image-2 | "换个风格"、"调色"、"杂志风"、"保持人物不变" | 保留原图人物、文字、排版;只改配色/背景/色调 |
| 创意编辑 / 换背景加元素 | custom-imagemodel-gt | "换背景"、"加个太阳"、"去掉水印" | 改变原图内容结构,速度更快 |
营销场景速查(20 类)
| # | 场景 | 触发词 | 推荐尺寸 | 默认风格 |
|---|---|---|---|---|
| 1 | 城市/景区营销 | "深圳宣传"、"成都旅游" | 1024x1536 | 杂志编辑风 |
| 2 | 产品营销/卖货 | "产品图"、"卖货图"、"新品上市" | 1024x1024 | 极简主义 |
| 3 | 节日节气海报 | "春节"、"中秋"、"立春" | 1024x1536 | 中国风 |
| 4 | 活动促销宣传 | "促销"、"大促"、"年会"、"发布会" | 1536x1024 | 渐变弥散光 |
| 5 | 品牌/企业宣传 | "企业介绍"、"品牌故事" | 1536x1024 | 极简主义 |
| 6 | 社媒配图 | "小红书"、"公众号封面"、"朋友圈" | 1024x1024 | 日系清新 |
| 7 | 科普百科信息图 | "百科图"、"科普图"、"图鉴" | 1024x1536 | 杂志编辑风 |
| 8 | 旅游攻略手绘地图 | "旅游攻略"、"手绘地图" | 1024x1536 | 手绘水彩 |
| 9 | 电商主图/详情图 | "电商图"、"主图"、"详情页" | 1024x1024 | 3D立体 |
| 10 | 公众号封面/配图 | "公众号封面"、"推文配图" | 1024x1024 | 杂志编辑风 |
| 11 | 招聘/HR海报 | "招聘海报"、"校招"、"社招" | 1024x1536 | 科技感 |
| 12 | 企业文化海报 | "团建"、"企业文化"、"价值观" | 1536x1024 | 插画风 |
| 13 | 金融/投资分析图 | "投资分析"、"基金推荐"、"理财海报" | 1024x1536 | 杂志编辑风 |
| 14 | 餐饮/美食/菜单 | "美食海报"、"菜品图"、"餐厅推广" | 1024x1024 | 日系清新 |
| 15 | 教育/培训海报 | "公开课"、"招生"、"培训海报" | 1024x1536 | 扁平化插画 |
| 16 | 医疗健康科普 | "健康科普"、"医疗海报"、"养生" | 1024x1536 | 扁平化插画 |
| 17 | 房产/家居装饰 | "房产海报"、"楼盘宣传"、"家居图" | 1536x1024 | 极简主义 |
| 18 | 汽车/出行 | "汽车海报"、"出行宣传" | 1536x1024 | 科技感 |
| 19 | 时尚/穿搭 | "时尚海报"、"穿搭推荐" | 1024x1536 | 杂志编辑风 |
| 20 | 公益/社会责任 | "公益海报"、"环保宣传" | 1024x1536 | 手绘水彩 |
> 详细场景说明、风格匹配和 prompt 模板见本文「附录:合并参考手册」。
设计风格库(15 种)
| # | 风格 | 英文标注 | 适用场景 | 色彩特征 |
|---|---|---|---|---|
| 1 | 极简主义 | Minimalist | 品牌、产品、电商 | 大面积留白,单色+点缀色 |
| 2 | 中国风/国潮 | Chinese traditional style | 节日、城市、餐饮 | 红/金/墨色/青绿山水 |
| 3 | 科技感/未来感 | Tech futuristic | 企业、招聘、金融、汽车 | 深蓝/渐变紫/霓虹蓝 |
| 4 | 扁平化插画 | Flat vector illustration | 教育、社媒、HR、医疗 | 明快纯色,饱和度适中 |
| 5 | 渐变弥散光 | Soft gradient diffuse | 活动、社媒、公众号 | 柔和渐变,梦幻光感 |
| 6 | 杂志编辑风 | Magazine editorial | 品牌、科普、城市、时尚 | 高级灰、衬线字体感 |
| 7 | 莫兰迪色系 | Morandi muted colors | 品牌、餐饮、生活方式 | 低饱和、灰调高级感 |
| 8 | 手绘水彩 | Hand-drawn watercolor | 旅游、科普、餐饮、公益 | 通透水彩、自然色调 |
| 9 | 赛博朋克 | Cyberpunk neon | 活动、科技产品 | 霓虹紫/蓝/粉、暗底 |
| 10 | 日系清新 | Japanese fresh airy | 社媒、餐饮、旅游 | 淡蓝/米白/浅粉、高明度 |
| 11 | 酸性设计 | Acid graphics brutalism | 潮流活动、音乐节 | 高饱和撞色、液态金属感 |
| 12 | 3D立体/C4D | 3D C4D render style | 产品、电商、科技 | 立体光影、材质质感 |
| 13 | 复古怀旧 | Retro vintage | 节日、品牌、餐饮 | 做旧色调、胶片质感 |
| 14 | 玻璃拟态 | Glassmorphism | 科技、APP UI、品牌 | 半透明毛玻璃、模糊背景 |
| 15 | 新国风插画 | New Chinese illustration | 节日、城市、品牌、文旅 | 现代插画+传统元素融合 |
> 详细风格说明见本文「附录:合并参考手册」。
风格-场景默认匹配(自动选择,无需询问)
| 场景 | 默认风格 | 备选风格 |
|---|---|---|
| 城市旅游 | 杂志编辑风 | 中国风、手绘水彩、新国风 |
| 产品营销 | 极简主义 | 3D立体、弥散光、玻璃拟态 |
| 节日节气 | 中国风 | 新国风插画、插画风、弥散光 |
| 活动促销 | 弥散光 | 酸性设计、赛博朋克 |
| 品牌企业 | 极简主义 | 科技感、莫兰迪、玻璃拟态 |
| 社媒配图 | 日系清新 | 插画风、弥散光、莫兰迪 |
| 科普百科 | 杂志编辑风 | 手绘水彩、扁平化 |
| 旅游攻略 | 手绘水彩 | 新国风插画、插画风 |
| 电商图 | 3D立体 | 极简主义、玻璃拟态 |
| 公众号 | 杂志风 | 弥散光、日系清新 |
| 招聘HR | 科技感 | 扁平化、极简主义 |
| 企业文化 | 插画风 | 极简主义、扁平化 |
| 金融投资 | 杂志风 | 科技感 |
| 餐饮美食 | 日系清新 | 手绘水彩、莫兰迪、复古怀旧 |
| 教育培训 | 扁平化 | 插画风、手绘水彩 |
| 医疗健康 | 扁平化 | 极简主义、日系清新 |
| 房产家居 | 极简主义 | 莫兰迪、日系清新 |
| 汽车出行 | 科技感 | 极简主义、赛博朋克 |
| 时尚穿搭 | 杂志编辑风 | 复古怀旧、极简主义 |
| 公益海报 | 手绘水彩 | 扁平化、插画风 |
Knowledge
语言规则
默认中文输出。 图片必须包含中文文案(标题、标语、正文)。仅当用户明确指定其他语言或面向海外平台时例外。
无水印(硬性规则)
logo_add参数始终传0(不叠加 AI 标识)- prompt 末尾始终追加
no watermark, no logo, clean image - 交付前用 Read 预览确认无任何水印
Prompt 编写原则
- Prompt 使用英文编写(避免编码问题),中文文案用英文标注
- 结构化 prompt 框架:
{主体元素} + {背景环境} + {前景装饰} + {色彩方案} + {中文文案标注} + {风格定位} + {排版约束} - 主体元素 4-6 个,前景装饰 3-5 个
- 色彩:2-3 种主色 + 1 种点缀色
- 图生图末尾加
Same professional design style and layout as reference image. - 中文文案清晰标注,如
"Title in Chinese: 深圳,山海相连的城市" - GPT 模型(gpt-image-1/2)推荐英文 prompt;腾讯模型(custom-*-gt)中英文均可
- 风格迁移推荐英文 prompt,关键词加
Keep the person/text/layout identical
> 详细 prompt 工程方法论见本文「附录:合并参考手册」。
参考图处理(图生图)— 三种图传方式
| 方式 | 参数 | 速度 | 适用场景 |
|---|---|---|---|
| URL 直传(推荐) | image_url / image_urls |
最快 | 公网可访问的 HTTPS 图片 |
| base64 直传 | image_base64_data_url |
较慢 | 本地图片、私密图片、>1MB 大图 |
| 遮罩图 | mask_image_url |
— | PNG 格式,透明区域 = 编辑区域 |
- URL 直传:图片放到公网可访问的 HTTPS URL,用
image_url(单张)或image_urls(多张,1-16 张) - base64 直传:格式
data:image/{jpeg|png|webp};base64,...,适合本地文件(无需图床) - 大图(>1MB):优先用 base64 直传,避免 URL 下载超时
- 本地图片转 base64:用 Read 工具读取图片,再构造 data URL 传入
image_base64_data_url
尺寸支持与约束
| 预设值 | 说明 | 适用场景 |
|---|---|---|
1024x1024 |
1:1 正方形 | 产品图、电商图、社媒配图 |
1536x1024 |
3:2 横版 | 活动促销、品牌宣传、企业文化 |
1024x1536 |
2:3 竖版 | 城市宣传、节日海报、招聘海报 |
auto |
自动适配 | 让模型自行决定 |
> ⚠️ 大尺寸限制:custom-textmodel-gt / custom-imagemodel-gt 仅支持上述 3 档预设尺寸。4K、16:9、9:16 等比例会超时或无效。如需更多尺寸,使用 gpt-image-1 / gpt-image-2 模型(支持自定义尺寸,单边≤3840px、16 倍数、长短边比≤3:1)。
详细参考文档
本技能所有参考内容(API 文档、20 类营销场景模板、15 种设计风格详解、专业级 prompt 构建方法论)已内联至本文末尾「附录:合并参考手册」,无需额外文件,匹配到具体场景后直接查阅对应章节。
Workflow(6 步)
Step 1: 识别需求
匹配营销场景表 → 确定场景类型、推荐尺寸、自动匹配设计风格。
Step 2: 判断模式与模型路由
- 用户给了参考图/源图 → 图生图 → 用
edit_image - 风格迁移/内容保持("换个风格"、"调色"、"杂志风")→ 模型用 gpt-image-2
- 创意编辑/换背景加元素("换背景"、"加元素"、"去掉XX")→ 模型用 custom-imagemodel-gt(默认)
- 无参考图 → 文生图 → 用
generate_image - 默认模型 custom-textmodel-gt
- 用户要求高质量 → gpt-image-2
- 用户要求快速 → gpt-image-1 或 grok-imagine
- 用户要求透明背景 → gpt-image-1
- 用户指定 Google/Grok 模型 → 按指定调用
Step 3: 构建 Prompt
读取对应模板文件 → 替换占位符 → 英文 prompt + 中文文案标注 → 末尾加 no watermark, no logo, clean image。
参考本文「附录:合并参考手册」获取详细构建方法论。
Step 4: 调用生成(付费触发点)
> 所有图片生成统一通过 DeferExecuteTool 调用 hanis-image-mcp 服务。 调用前先用 ToolSearch 以 tool_names 加载目标工具的最新 schema(以 ToolSearch 返回为准,勿硬编码过期参数)。
>
> 💳 付费边界(X402 协议):本步骤的 generate_image / edit_image 调用即触发一次 X402 支付(HTTP 402 Payment Required)。完整的前置检查、支付触发、订单号传递、重试与异常处理流程见上方「X402 付费改造」章节。skill 只需照常发起生图调用,支付握手由 SkillHub X402 代理接管(服务端返回 402 时持 X-PAYMENT 头重试),生图结果照常返回。
4.1 文生图:generate_image
DeferExecuteTool({
toolName: "mcp__hanis-image-mcp__generate_image",
params: {
prompt: "构建好的英文 prompt",
model: "custom-textmodel-gt",
size: "1024x1024",
n: 1,
quality: "auto",
background: "auto",
output_format: "png",
logo_add: 0
}
})
参数说明:
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
prompt |
string | ✅ | — | 图片描述,最大 32000 字符 |
model |
string | ❌ | custom-textmodel-gt |
文生图模型 ID |
size |
string | ❌ | 1024x1024 |
auto/1024x1024/1536x1024/1024x1536 |
n |
integer | ❌ | 1 |
生成数量 1-10 |
quality |
string | ❌ | auto |
auto/high/medium/low |
background |
string | ❌ | auto |
auto/opaque/transparent(transparent 仅 gpt-image-1) |
output_format |
string | ❌ | png |
png/jpeg/webp |
output_compression |
integer | ❌ | — | 0-100(仅 jpeg/webp) |
logo_add |
integer | ❌ | 0 |
AI 标识:0=不加, 1=加 |
4.2 图生图:edit_image
单张输入图(最常用):
DeferExecuteTool({
toolName: "mcp__hanis-image-mcp__edit_image",
params: {
image_url: "https://example.com/photo.jpg",
prompt: "编辑指令描述",
model: "custom-imagemodel-gt",
size: "1024x1024",
n: 1,
input_fidelity: "high",
logo_add: 0
}
})
多张输入图 + 遮罩:
DeferExecuteTool({
toolName: "mcp__hanis-image-mcp__edit_image",
params: {
image_urls: ["https://example.com/photo1.jpg", "https://example.com/photo2.jpg"],
mask_image_url: "https://example.com/mask.png",
prompt: "合成这两张图片",
model: "custom-imagemodel-gt",
size: "1024x1024",
n: 1,
logo_add: 0
}
})
本地图片 base64 直传:
DeferExecuteTool({
toolName: "mcp__hanis-image-mcp__edit_image",
params: {
image_base64_data_url: "data:image/jpeg;base64,/9j/4AAQ...",
prompt: "编辑指令描述",
model: "gpt-image-2",
size: "1024x1024",
logo_add: 0
}
})
参数说明:
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
image_url |
string | 三选一 | — | 单张图片 HTTPS URL |
image_urls |
string[] | 三选一 | — | 多张图片 URL(1-16 张) |
image_base64_data_url |
string | 三选一 | — | base64 Data URL,格式 data:image/{jpeg\|png\|webp};base64,... |
mask_image_url |
string | ❌ | — | 遮罩图 URL(PNG,透明=编辑区) |
prompt |
string | ❌* | — | 编辑指令(GPT 模型推荐填写) |
model |
string | ❌ | custom-imagemodel-gt |
图生图模型 ID |
size |
string | ❌ | 1024x1024 |
输出尺寸 |
n |
integer | ❌ | 1 |
1-10 |
quality |
string | ❌ | auto |
auto/high/medium/low |
background |
string | ❌ | auto |
auto/opaque/transparent |
output_format |
string | ❌ | png |
png/jpeg |
response_format |
string | ❌ | url |
url/b64_json(仅 custom-imagemodel-gt) |
input_fidelity |
string | ❌ | — | high/low(仅 custom-imagemodel-gt) |
logo_add |
integer | ❌ | 0 |
AI 标识 |
Step 5: 下载保存
MCP 返回的 images[] 数组,每项的 kind 可能为:
- "url" — 包含 url 字段(HTTPS 链接,有效期 1 小时)。用 curl 下载到本地工作目录。
- "base64" — 包含 base64、mime_type、byte_length 字段(gpt-image-1/2 模型返回此格式)。直接解码保存:Path(out).write_bytes(base64.b64decode(img["base64"]))
- "empty" — 包含 warning 字段(空结果告警)
文件名 {关键词}_{时间戳}.png,保存到用户指定路径或当前工作目录。
> ⚠️ 处理 base64 图片时不要用 Bash echo/printf(会截断长字符串),必须用 Python base64.b64decode() + Path.write_bytes()。
Step 6: 预览交付
用 Read 工具预览 → 检查中文文案、色彩构图、无水印 → 不满意调整 prompt 重新生成(每次只调 1-2 个变量)→ 确认后用 present_files 交付。
Tools
MCP 服务配置(凭证由平台托管,用户无需配置)
本技能依赖 hanis-image-mcp MCP 服务。在 SkillHub 云端沙箱中运行时,MCP 地址与 API Key 由平台统一注入,用户侧无需、也不应配置任何 Key。下方仅为服务侧配置示意(供参考,不随对外发布包暴露明文):
{
"mcpServers": {
"hanis-image-mcp": {
"type": "streamable-http",
"url": "https://hanis-image-mcp-288810-10-1426987343.sh.run.tcloudbase.com/mcp",
"headers": {
"Authorization": "Bearer ${HANIS_IMAGE_MCP_API_KEY}"
},
"timeout": 360000,
"disabled": false
}
}
}
> 🔒 安全红线:对外发布的技能包严禁写入明文 API Key。Key 一律由平台沙箱以环境变量 / 密钥注入(如上 ${HANIS_IMAGE_MCP_API_KEY}),或以 SkillHub 后台托管凭证形式下发。
付费与凭证(SkillPay)
- 本技能为付费技能,每次调用生图工具即触发一次微信支付(详见文首「SkillPay 付费说明」)。
- API Key 由 SkillHub 云端沙箱注入,用户无需联系开通、无需填写 Key。
- 如遇
UNAUTHORIZED,属平台凭证注入异常,提示用户「服务暂不可用,请联系技能提供方」,不向用户索要 Key。
工具调用流程
- 优先:DeferExecuteTool — 执行实际生成(推荐路径)
- 备选:curl 直连 — 当 DeferExecuteTool 报
Connection closed时启用(见下方「SSE keepalive 备选方案」) - Bash (curl) — 下载返回的图片 URL 到本地
⚠️ SSE keepalive 问题与 curl 直连方案
现象:DeferExecuteTool 调用 MCP 工具时偶发 MCP error -32000: Connection closed,原因是 MCP 服务器在生成期间持续发送 : keepalive SSE 心跳,WorkBuddy 连接器未能正确处理心跳后的流式响应。
判别:先用 curl 验证连通性 curl -I <endpoint>。若直连可通而 DeferExecuteTool 失败,即为此问题。
解决方案:通过 Python 脚本封装 curl 直连调用。标准流程:
1. Python 构造 JSON payload(含 base64 图片参数时写入临时文件防 Bash 截断)
2. curl -d @payload.json 向 MCP 端点发起 POST
3. 正则提取 SSE data 行中的 JSON
4. 从 result.structuredContent.images[] 中取图片
5. kind=url → urllib 下载保存 | kind=base64 → 解码保存
关键代码片段:
import base64, json, re, subprocess, tempfile, urllib.request
from pathlib import Path
# 1. 本地图片转 base64
with open("ref.jpg", "rb") as f:
img_b64 = base64.b64encode(f.read()).decode()
# 2. 构造 payload 写入临时文件(绕过 Bash 参数长度限制)
payload = {"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"generate_image","arguments":{"prompt":"...","model":"gpt-image-2","size":"1024x1024","logo_add":0}}}
with tempfile.NamedTemporaryFile(mode="w",suffix=".json",delete=False) as f:
json.dump(payload,f); path=f.name
# 3. curl 直连
result = subprocess.run(["curl","-s","-X","POST",MCP_URL,
"-H","Content-Type: application/json",
"-H","Accept: application/json, text/event-stream",
"-H",f"Authorization: Bearer {API_KEY}",
"-d",f"@{path}","--max-time","300"], capture_output=True,text=True)
# 4. 提取 SSE data 行
data_match = re.search(r"data:\s*(\{.*?\})\s*(?:\n|$)", result.stdout, re.DOTALL)
resp = json.loads(data_match.group(1))
# 5. 处理图片
for img in resp["result"]["structuredContent"]["images"]:
if img["kind"] == "url":
urllib.request.urlretrieve(img["url"], "output.png")
elif img["kind"] == "base64":
Path("output.png").write_bytes(base64.b64decode(img["base64"]))
> 🔒 付费版凭证说明:上方脚本中的 MCP_URL 与 API_KEY 在 SkillHub 云端沙箱运行时由平台从托管凭证注入(即 ${HANIS_IMAGE_MCP_API_KEY}),agent 不应、也无需向用户索取。仅在本地调试(非发布包)时可临时以环境变量提供。
> 💡 gpt-image-2 返回 base64:不同于 custom-textmodel-gt 返回 URL,gpt-image-2 的 kind 为 "base64",需要解码后保存为二进制文件。
注意事项
- 统一使用 hanis-image-mcp:优先通过 DeferExecuteTool 调用;如遇
Connection closed则切换 curl 直连(见上方案) - MCP 连接器:在 WorkBuddy「连接器管理」中启用
hanis-image-mcp连接器(或在 mcp.json 中设置disabled: false) - 无水印:
logo_add: 0+ prompt 加no watermark - 响应格式差异:
custom-textmodel-gt/custom-imagemodel-gt返回kind: "url";gpt-image-1/gpt-image-2返回kind: "base64"。处理前先检查kind字段。 - 生成耗时参考:
| 模型 | 1024x1024 | 2048x2048+ |
|---|---|---|
| custom-textmodel-gt | 60s | 180s |
| custom-imagemodel-gt | 90s | 180s |
| gpt-image-1 | 60s | 120s |
| gpt-image-2 | 120s | 300s |
| grok-imagine | ~15s | — |
| gemini-3.1-flash-image | ~30s | — |
> DeferExecuteTool 调用不需要设置超时参数(由 MCP 连接器内部处理),上表供 Agent 决策等待时间和判断是否超时。
- 图片 URL 有效期 1 小时,生成后请立即下载保存
- 凭证托管:
hanis-image-mcp的 API Key 由 SkillHub 云端沙箱注入,用户无需配置;鉴权失败提示用户联系技能提供方
错误处理
| 错误码 | 说明 | 可重试 | Agent 行为 |
|---|---|---|---|
UNAUTHORIZED |
API Key 无效或缺失 | ❌ | 检查 ~/.workbuddy/mcp.json 中 hanis-image-mcp.headers.Authorization 是否正确,不重试 |
INVALID_ARGUMENT |
参数校验失败 | ❌ | 检查 prompt 长度、size 格式、模型参数;修正后重试 |
INVALID_IMAGE_URL |
图片 URL 无效或无法访问 | ❌ | 确认 URL 为公网合法地址;建议改用 image_base64_data_url 直传 |
IMAGE_DOWNLOAD_BLOCKED |
图片被 SSRF 防护拦截 | ❌ | 确认 URL 是否公网合法地址;改用 base64 直传 |
UPSTREAM_ERROR |
上游生图服务返回错误 | ✅ | 等待 2-3 秒后重试一次 |
UPSTREAM_UNAVAILABLE |
上游服务不可用 | ✅ | 等待 5-10 秒后重试一次;或切换备选模型 |
UPSTREAM_TIMEOUT |
上游请求超时 | ✅ | 检查尺寸是否兼容;降低尺寸或画质后重试 |
UPSTREAM_INVALID_RESPONSE |
上游响应格式异常 | ❌ | 尝试更换模型后重试一次;仍失败则提示用户"服务异常" |
RATE_LIMITED |
请求频率超限 | ✅ | 等待 60 秒后自动重试 |
MCP error -32000: Connection closed |
SSE keepalive 心跳导致连接器断连 | ✅ | 切换 curl 直连方案(见 Tools → SSE keepalive 备选方案) |
模型故障自动降级策略
当默认模型出错时,按以下优先级降级:
文生图:custom-textmodel-gt → gpt-image-1 → grok-imagine
图生图(创意编辑):custom-imagemodel-gt → gpt-image-1 → gpt-image-2
图生图(风格迁移):gpt-image-2 → gpt-image-1(质量降低但可用)
Output
响应结构
// 成功响应
interface ImageToolResult {
success: true;
request_id: string; // UUID 追踪 ID
mode: 'text-to-image' | 'image-to-image';
model: string; // 实际使用的模型 ID
size: string; // 输出尺寸
count: number; // 生成数量
images: ImageItem[];
warnings: string[]; // 非致命告警
}
// 图片项(三选一)
type ImageItem =
| { index: number; kind: 'url'; url: string } // URL 格式(有效期 1 小时)
| { index: number; kind: 'base64'; mime_type: string; base64: string; byte_length: number }
| { index: number; kind: 'empty'; warning: string }; // 空结果
输出标准
- 格式:默认 PNG,支持 JPEG / WebP
- 路径:用户指定路径或当前工作目录,文件名
{关键词}_{时间戳}.png - 无水印:交付前务必确认
- 中文文案:必须包含正确的中文标题/标语
交付流程
- 生成后用 Read 预览
- 检查文案正确性、色彩构图、无水印
- 用 present_files 交付,附带:图片类型、尺寸、设计风格、使用模型
- 如需调整,描述具体问题重新生成(每次只调 1-2 个变量)
Memory
经验积累
每次生成后记录到 workspace memory:
- 成功案例:需求 → 模型/模板/风格 → 最终 prompt → 效果评价
- 失败案例:问题 → 原因 → 解决方案
- 新场景/风格:首次使用时记录,追加到本文「附录:合并参考手册」对应章节
- 模型表现:记录不同模型在特定场景下的表现差异,优化路由策略
常见问题速查
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 中文乱码/缺失 | prompt 未标注中文 | prompt 中明确写 "Title in Chinese: XXX" |
| 有水印 | logo_add 未设 0 | 确认 logo_add: 0,末尾加 no watermark |
| 文字模糊 | 未强调清晰度 | prompt 加 "clear legible sharp Chinese text" |
| 风格不匹配 | 风格关键词不够具体 | 从风格库选精确英文标注写入 prompt |
| 生成超时 | 尺寸不兼容或上游耗时 | 确认使用兼容尺寸;参考超时表判断是否重试 |
| 图生图失败(URL) | 图片 URL 不可访问 | 改用 image_base64_data_url base64 直传本地文件 |
| 风格迁移内容丢失 | 用了 custom-imagemodel-gt | 风格迁移场景改用 gpt-image-2(内容保持最优) |
| URL 过期 | 超过 1 小时 | 重新生成并立即下载保存 |
| RATE_LIMITED | 请求频率超限 | 等待 60 秒后自动重试 |
| UNAUTHORIZED | 平台凭证注入异常(非用户问题) | 提示用户「服务暂不可用,请联系技能提供方」;无需重试、不向用户索要 Key |
| 透明背景失败 | 模型不支持 | transparent 仅 gpt-image-1 支持;换用 gpt-image-1 |
DeferExecuteTool Connection closed |
SSE keepalive 心跳 (: keepalive) 导致连接器断连 |
切换 curl 直连 + Python 脚本(见 Tools 章节完整模板) |
| base64 图片保存后乱码/截断 | 用了 Bash echo/printf 处理长 base64 | 改用 Python base64.b64decode() + Path.write_bytes() |
命令行 Argument list too long |
base64 数据太大超出 Bash 参数长度 | 将 JSON payload 写入临时文件,curl 用 -d @file 传入 |
| 风格迁移后文字变化 | prompt 未明确列出所有要保留的文本 | 在 prompt 中逐条列出原文 "Keep Chinese text: 'XX', 'YY'" |
附录:合并参考手册(原 4 份参考文档)
hanis-image-pro 参考手册(合并文档)
> 本文件由原 4 份参考文档合并而成,是技能唯一的附属参考文件,按需读取。包含:Prompt 工程方法论、设计风格库、营销场景模板库、API 参考。
第一部分:Prompt 工程方法论
> 本文件由原 4 份参考文档合并而成,是技能唯一的附属参考文件,按需读取。包含:Prompt 工程方法论、设计风格库、营销场景模板库、API 参考。
第一部分:Prompt 工程方法论
> 本文档定义 hanis-image-pro 技能的 prompt 构建标准和最佳实践。
核心原则
1. 语言策略
| 模型 | 推荐 prompt 语言 | 中文文案处理 |
|---|---|---|
| custom-textmodel-gt | 中英文均可 | "Title in Chinese: 中文标题" |
| custom-imagemodel-gt | 中英文均可 | "Title in Chinese: 中文标题" |
| gpt-image-1 / gpt-image-2 | 英文(推荐) | "Title in Chinese: 中文标题" |
| grok-imagine 系列 | 英文 | "Title in Chinese: 中文标题" |
| gemini-3.1-flash-image | 英文 | "Title in Chinese: 中文标题" |
> 统一使用英文 prompt 是最安全的选择,所有模型均兼容。中文文案通过 "XXX in Chinese: 中文内容" 标注。
2. 无水印规则(硬性)
logo_add参数始终传0- prompt 末尾始终追加
no watermark, no logo, clean image - 交付前用 Read 预览确认无任何水印
3. 字符限制
- 单个 prompt 建议 ≤ 8000 字符(API 最大 32000,但过长影响效果)
- 中文文案部分尽量简洁有力
结构化 Prompt 框架
标准 7 层结构
[1. 主体元素] + [2. 背景环境] + [3. 前景装饰] + [4. 色彩方案] + [5. 中文文案标注] + [6. 风格定位] + [7. 排版约束]
各层详解
Layer 1: 主体元素(Subject)
- 描述图片的核心视觉主体
- 建议 4-6 个元素
- 每个元素附带简短描述
✅ Main elements: Ping An Finance Centre, Shenzhen Bay Bridge, Civic Center, Window of the World arranged in a vertical composition.
❌ Main elements: building, bridge, center (太模糊)
Layer 2: 背景环境(Background)
- 描述图片的背景氛围和空间感
- 包含时间/天气/光线信息
Background: Shenzhen skyline at golden hour with ocean and mountains, atmospheric depth.
Layer 3: 前景装饰(Foreground Decorations)
- 点缀性装饰元素,增加画面丰富度
- 建议 3-5 个元素
Foreground decorations: bougainvillea flowers, modern bus, palm trees, soft shadow.
Layer 4: 色彩方案(Color Scheme)
- 2-3 种主色 + 1 种点缀色
- 使用 hex 色值或具象色彩描述
✅ Color scheme: deep blue #0A4D8C, warm gold #F5A623, white #FFFFFF, accent teal #00B4D8.
❌ Color scheme: blue and gold (太模糊)
Layer 5: 中文文案标注(Chinese Text)
- 明确标注每段文字的内容和位置
- 格式:
"位置 in Chinese: 中文内容"
Title in Chinese: "深圳,山海相连的城市"
Subtitle in Chinese: "创新之都 · 湾区引擎"
Bottom tagline in Chinese: "来了就是深圳人"
Layer 6: 风格定位(Style)
- 从风格库选择精确的英文标注
- 可组合 1-2 种风格
Magazine editorial style, sophisticated layout, high-end color grading, professional travel photography aesthetic.
Layer 7: 排版约束(Layout Constraints)
- 文字清晰度要求
- 无水印要求
clear legible sharp Chinese text. No watermark, no logo, clean image.
完整 Prompt 示例
文生图示例(城市宣传)
A premium marketing poster for Shenzhen.
Main elements: Ping An Finance Centre, Shenzhen Bay Bridge, Civic Center, Window of the World arranged in a vertical composition.
Background: Shenzhen skyline at golden hour with ocean and mountains, atmospheric depth.
Foreground decorations: bougainvillea flowers, modern bus, palm trees, soft shadow.
Color scheme: deep blue #0A4D8C, warm gold #F5A623, white #FFFFFF, accent teal #00B4D8.
Title in Chinese: "深圳,山海相连的城市"
Subtitle in Chinese: "创新之都 · 湾区引擎"
Bottom tagline in Chinese: "来了就是深圳人"
Magazine editorial style, sophisticated layout, high-end color grading, professional travel photography aesthetic, clear legible sharp Chinese text.
No watermark, no logo, clean image.
图生图示例 — 风格迁移(gpt-image-2)
Transform to premium minimal magazine style. Keep the person, text and layout identical. Change: colors to black/white/gray with gold accents, background to clean white. Same professional design style and layout as reference image.
图生图示例 — 创意编辑(custom-imagemodel-gt)
Replace the background with a tropical beach at sunset, add palm tree silhouettes on both sides, keep the person in the same position. input_fidelity: high.
Prompt 优化技巧
1. 色彩精确化
| 描述方式 | 效果 | 示例 |
|---|---|---|
| hex 色值 | 最精确 | #0A4D8C |
| 具象色彩名 | 较好 | deep ocean blue |
| 模糊色彩名 | 最差 | blue |
2. 构图引导
使用方向性词汇引导构图:
vertical composition— 竖版构图horizontal composition— 横版构图centered layout— 居中构图rule of thirds— 三分法构图symmetrical composition— 对称构图
3. 文字清晰度强化
当文字模糊时,增加以下关键词:
clear legible sharp Chinese text, high-contrast typography, crisp text rendering, professional font quality
4. 风格关键词精确匹配
从本文「第二部分:设计风格库」中选择对应风格的精确英文标注,不要自创模糊描述。
5. 图生图 prompt 语言策略
- 风格迁移(gpt-image-2):英文 prompt,关键词加
Keep the person/text/layout identical - 创意编辑(custom-imagemodel-gt):中英文均可,描述要具体
常见 Prompt 问题与解决方案
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 中文乱码/缺失 | prompt 未标注中文 | 用 "Title in Chinese: XXX" 明确标注 |
| 文字模糊 | 未强调清晰度 | 加 clear legible sharp Chinese text |
| 色彩偏差 | 色彩描述模糊 | 使用 hex 色值或具象描述 |
| 风格不匹配 | 风格关键词模糊 | 从风格库选精确英文标注 |
| 元素过多杂乱 | 主体元素太多 | 控制在 4-6 个主体元素 |
| 构图不理想 | 无构图引导 | 添加构图方向性词汇 |
| 有水印 | 未关闭水印 | logo_add: 0 + no watermark, no logo |
| 风格迁移后内容丢失 | 用错模型 | 风格迁移必须用 gpt-image-2 |
批量生成策略
当需要生成多张图时:
- 同主题多风格:保持主体和文案不变,只改变风格关键词
- 同主题多尺寸:先确认目标尺寸,再生成
- 多场景系列图:保持统一色彩方案和风格定位,只改变场景元素
- 单次 n>1:使用
n参数一次生成多张,但建议 n≤2 便于筛选
迭代优化方法
首次生成后如需调整,遵循 单变量调整原则:
- 每次只调整 1-2 个变量(色彩/构图/元素/文字位置)
- 记录调整内容和效果,避免重复试错
- 常见调整方向:
- 色彩:偏暖/偏冷/更鲜艳/更柔和
- 构图:重心偏移/元素增减/留白调整
- 文字:位置/大小/清晰度
- 风格:更精致/更活泼/更稳重
第二部分:设计风格库(15 种营销视觉风格)
> 本文档详细说明每种设计风格的视觉特征、适用场景、色彩方案和 prompt 关键词。
1. 极简主义(Minimalist)
| 属性 | 说明 |
|---|---|
| 英文标注 | Minimalist |
| 适用场景 | 品牌宣传、产品营销、电商图、房产家居 |
| 色彩特征 | 大面积留白,单色+点缀色 |
| 设计灵感 | Apple、Muji、IKEA 产品视觉 |
Prompt 关键词: minimalist design, clean white background, lots of negative space, simple composition, single accent color, elegant typography, premium feel
色彩方案:
- 主色:白色 #FFFFFF / 浅灰 #F5F5F5
- 点缀色:品牌色(如 #3BA0FF)
- 文字色:深灰 #333333
2. 中国风/国潮(Chinese Traditional Style)
| 属性 | 说明 |
|---|---|
| 英文标注 | Chinese traditional style |
| 适用场景 | 节日节气、城市宣传、餐饮美食、文旅 |
| 色彩特征 | 红/金/墨色/青绿山水 |
| 设计灵感 | 故宫文创、国潮品牌 |
Prompt 关键词: Chinese traditional style, ink wash painting elements, red and gold color scheme, traditional Chinese patterns, seal stamp decoration, calligraphy-style typography
色彩方案:
- 主色:中国红 #C8102E / 金色 #D4AF37
- 辅助色:墨色 #1A1A2E / 青绿 #2D6A4F
- 点缀色:宣纸白 #FDF6E3
3. 科技感/未来感(Tech Futuristic)
| 属性 | 说明 |
|---|---|
| 英文标注 | Tech futuristic |
| 适用场景 | 企业宣传、招聘海报、金融投资、汽车出行 |
| 色彩特征 | 深蓝/渐变紫/霓虹蓝 |
| 设计灵感 | 科技公司发布会、赛博朋克 UI |
Prompt 关键词: tech futuristic style, dark blue gradient background, glowing neon blue accents, geometric tech patterns, holographic elements, clean sans-serif typography, digital circuit motifs
色彩方案:
- 主色:深蓝 #0A1628 / 科技蓝 #0077FF
- 辅助色:渐变紫 #6C33B5 / 霓虹蓝 #00E5FF
- 点缀色:白色 #FFFFFF
4. 扁平化插画(Flat Vector Illustration)
| 属性 | 说明 |
|---|---|
| 英文标注 | Flat vector illustration |
| 适用场景 | 教育培训、社媒配图、HR海报、医疗健康 |
| 色彩特征 | 明快纯色,饱和度适中 |
| 设计灵感 | Google Material Design、Notion 插画 |
Prompt 关键词: flat vector illustration style, bold flat colors, simple geometric shapes, friendly characters, modern illustration, clean outlines, vibrant but harmonious palette
色彩方案:
- 主色:明快纯色(蓝 #4A90D9 / 橙 #F5A623 / 绿 #7ED321)
- 辅助色:浅灰 #E8E8E8 / 白 #FFFFFF
- 点缀色:对比色
5. 渐变弥散光(Soft Gradient Diffuse)
| 属性 | 说明 |
|---|---|
| 英文标注 | Soft gradient diffuse |
| 适用场景 | 活动促销、社媒配图、公众号封面 |
| 色彩特征 | 柔和渐变,梦幻光感 |
| 设计灵感 | Instagram 渐变、Stripe 设计风格 |
Prompt 关键词: soft gradient diffuse lighting, dreamy color transitions, glassmorphism blur effects, pastel gradient background, ethereal glow, modern social media aesthetic
色彩方案:
- 主色:粉紫渐变 #FF6B9D → #C44CE1
- 辅助色:蓝紫渐变 #667EEA → #764BA2
- 点缀色:白色光晕
6. 杂志编辑风(Magazine Editorial)
| 属性 | 说明 |
|---|---|
| 英文标注 | Magazine editorial |
| 适用场景 | 品牌宣传、科普百科、城市营销、时尚穿搭 |
| 色彩特征 | 高级灰、衬线字体感 |
| 设计灵感 | Bloomberg、The Economist、National Geographic |
Prompt 关键词: magazine editorial style, sophisticated layout, serif typography, high-end color grading, professional photojournalism aesthetic, elegant text hierarchy, premium publication design
色彩方案:
- 主色:高级灰 #8B8B8B / 深灰 #2C2C2C
- 辅助色:米白 #F5F0E8 / 黑 #1A1A1A
- 点缀色:品牌色或金色
7. 莫兰迪色系(Morandi Muted Colors)
| 属性 | 说明 |
|---|---|
| 英文标注 | Morandi muted colors |
| 适用场景 | 品牌宣传、餐饮美食、生活方式、房产家居 |
| 色彩特征 | 低饱和、灰调高级感 |
| 设计灵感 | 乔治·莫兰迪静物画、日式侘寂风 |
Prompt 关键词: Morandi color palette, muted dusty tones, low saturation colors, sophisticated grayish hues, understated elegance, soft and calm atmosphere
色彩方案:
- 主色:灰粉 #D4C5C0 / 灰绿 #B5C4B1 / 灰蓝 #A8B8C4
- 辅助色:米灰 #E8E2DC / 深灰 #6B6B6B
- 点缀色:暗金 #C4B998
8. 手绘水彩(Hand-drawn Watercolor)
| 属性 | 说明 |
|---|---|
| 英文标注 | Hand-drawn watercolor |
| 适用场景 | 旅游攻略、科普百科、餐饮美食、公益海报 |
| 色彩特征 | 通透水彩、自然色调 |
| 设计灵感 | 水彩插画师作品、旅行手账 |
Prompt 关键词: hand-drawn watercolor style, soft watercolor washes, delicate brush strokes, natural pigments, transparent color layers, artistic illustration, warm and inviting feel
色彩方案:
- 主色:水彩蓝 #7EB3C4 / 水彩绿 #8FBC8F / 水彩橙 #E8A87C
- 辅助色:宣纸色 #FAF3E8 / 浅褐 #D4C4A8
- 点缀色:水彩红 #D4756B
9. 赛博朋克(Cyberpunk Neon)
| 属性 | 说明 |
|---|---|
| 英文标注 | Cyberpunk neon |
| 适用场景 | 活动促销、科技产品 |
| 色彩特征 | 霓虹紫/蓝/粉、暗底 |
| 设计灵感 | 银翼杀手、赛博朋克 2077 |
Prompt 关键词: cyberpunk neon style, dark moody background, glowing neon purple and blue lights, futuristic cityscape, holographic UI elements, rain-soaked streets reflection, Blade Runner aesthetic
色彩方案:
- 主色:霓虹紫 #BF00FF / 霓虹蓝 #00FFFF
- 辅助色:暗黑 #0D0221 / 深紫 #2D0066
- 点缀色:霓虹粉 #FF006E
10. 日系清新(Japanese Fresh Airy)
| 属性 | 说明 |
|---|---|
| 英文标注 | Japanese fresh airy |
| 适用场景 | 社媒配图、餐饮美食、旅游 |
| 色彩特征 | 淡蓝/米白/浅粉、高明度 |
| 设计灵感 | 无印良品、日系杂志 |
Prompt 关键词: Japanese fresh airy style, soft natural lighting, pastel color palette, clean and bright atmosphere, minimal decoration, gentle and warm mood, high-key lighting
色彩方案:
- 主色:淡蓝 #B8D4E3 / 米白 #F8F4ED / 浅粉 #F4D4D4
- 辅助色:浅绿 #C8E6C9 / 暖灰 #E0E0E0
- 点缀色:木色 #D4B896
11. 酸性设计(Acid Graphics Brutism)
| 属性 | 说明 |
|---|---|
| 英文标注 | Acid graphics brutalism |
| 适用场景 | 潮流活动、音乐节 |
| 色彩特征 | 高饱和撞色、液态金属感 |
| 设计灵感 | Y2K 美学、实验性平面设计 |
Prompt 关键词: acid graphics brutalism style, high saturation clashing colors, liquid chrome metallic textures, bold experimental typography, Y2K aesthetic, distorted grid patterns, raw energetic composition
色彩方案:
- 主色:荧光绿 #39FF14 / 亮粉 #FF10F0
- 辅助色:液态银 #C0C0C0 / 亮黄 #FFFF00
- 点缀色:电蓝 #0080FF
12. 3D立体/C4D(3D C4D Render Style)
| 属性 | 说明 |
|---|---|
| 英文标注 | 3D C4D render style |
| 适用场景 | 产品营销、电商图、科技 |
| 色彩特征 | 立体光影、材质质感 |
| 设计灵感 | 3D 产品渲染、C4D 动画 |
Prompt 关键词: 3D C4D render style, realistic lighting and shadows, premium material textures, soft studio lighting, depth of field, professional product visualization, high-quality 3D rendering
色彩方案:
- 主色:根据产品色调
- 辅助色:柔和灰 #E8E8E8 / 深灰 #4A4A4A
- 点缀色:光泽高光
13. 复古怀旧(Retro Vintage)
| 属性 | 说明 |
|---|---|
| 英文标注 | Retro vintage |
| 适用场景 | 节日节气、品牌宣传、餐饮美食 |
| 色彩特征 | 做旧色调、胶片质感 |
| 设计灵感 | 复古海报、老照片、胶片摄影 |
Prompt 关键词: retro vintage style, faded film colors, grain texture, vintage poster layout, aged paper background, classic typography, nostalgic warm tones, 70s-80s color palette
色彩方案:
- 主色:做旧棕 #8B6F47 / 褪色红 #C85A5A / 做旧绿 #6B8E6B
- 辅助色:泛黄米色 #E8DCC4 / 深褐 #4A3728
- 点缀色:暗金 #B8860B
14. 玻璃拟态(Glassmorphism)
| 属性 | 说明 |
|---|---|
| 英文标注 | Glassmorphism |
| 适用场景 | 科技、APP UI 设计、品牌宣传 |
| 色彩特征 | 半透明毛玻璃、模糊背景 |
| 设计灵感 | macOS Big Sur、iOS 设计语言 |
Prompt 关键词: glassmorphism style, frosted glass effect, semi-transparent panels, blurred gradient background, subtle light refraction, modern UI aesthetic, layered depth with blur
色彩方案:
- 主色:半透明蓝 rgba(100,149,237,0.7) / 半透明紫 rgba(147,112,219,0.7)
- 辅助色:模糊渐变背景
- 点缀色:白色高光边框
15. 新国风插画(New Chinese Illustration)
| 属性 | 说明 |
|---|---|
| 英文标注 | New Chinese illustration |
| 适用场景 | 节日节气、城市宣传、品牌宣传、文旅 |
| 色彩特征 | 现代插画+传统元素融合 |
| 设计灵感 | 新国风插画师作品、敦煌文创 |
Prompt 关键词: New Chinese illustration style, modern illustration with traditional Chinese elements, contemporary color palette with cultural motifs, fusion of ink painting and digital art, elegant cultural patterns
色彩方案:
- 主色:靛蓝 #3D5A80 / 朱砂红 #E63946 / 黛绿 #588157
- 辅助色:宣纸白 #FAF3E8 / 墨灰 #495867
- 点缀色:金色 #D4AF37
风格组合建议
某些场景可以组合两种风格产生独特效果:
| 组合 | 效果 | 适用场景 |
|---|---|---|
| 极简主义 + 莫兰迪 | 高级冷淡风 | 品牌宣传、生活方式 |
| 中国风 + 手绘水彩 | 文艺国风 | 城市文旅、节日 |
| 科技感 + 玻璃拟态 | 未来科技感 | 科技产品、APP |
| 杂志风 + 复古怀旧 | 复古杂志感 | 品牌故事、时尚 |
| 新国风 + 扁平化 | 国潮插画风 | 社媒、教育 |
第三部分:营销场景模板库(20 类场景)
> 本文档详细说明 20 类营销场景的设计要点、推荐参数和 prompt 模板。
> 模板中 {占位符} 需根据用户需求替换。
Prompt 通用结构
{主体元素描述} + {背景环境} + {前景装饰元素} + {色彩方案} + {中文文案标注} + {风格定位} + {排版约束} + no watermark, no logo, clean image
1. 城市/景区营销
触发词: "深圳宣传"、"成都旅游"、"杭州城市海报"
推荐尺寸: 1024x1536(竖版)
默认风格: 杂志编辑风
默认模型: custom-textmodel-gt
Prompt 模板
A premium marketing poster for {城市名}.
Main elements: {地标1, 地标2, 地标3, 地标4} arranged in a vertical composition.
Background: {城市天际线/山水景观} with atmospheric depth.
Foreground decorations: {城市花/树/交通工具等装饰元素}.
Color scheme: {2-3种主色 + 1种点缀色}.
Title in Chinese: "{城市宣传标题}"
Subtitle in Chinese: "{副标题/宣传语}"
Bottom tagline in Chinese: "{底部标语}"
Magazine editorial style, sophisticated layout, high-end color grading,
professional travel photography aesthetic, clear legible sharp Chinese text.
No watermark, no logo, clean image.
示例(深圳)
A premium marketing poster for Shenzhen.
Main elements: Ping An Finance Centre, Shenzhen Bay Bridge, Civic Center,
Window of the World arranged in a vertical composition.
Background: Shenzhen skyline at golden hour with ocean and mountains.
Foreground decorations: bougainvillea flowers, modern bus, palm trees.
Color scheme: deep blue #0A4D8C, warm gold #F5A623, white #FFFFFF, accent teal #00B4D8.
Title in Chinese: "深圳,山海相连的城市"
Subtitle in Chinese: "创新之都 · 湾区引擎"
Bottom tagline in Chinese: "来了就是深圳人"
Magazine editorial style, sophisticated layout, high-end color grading,
professional travel photography aesthetic, clear legible sharp Chinese text.
No watermark, no logo, clean image.
2. 产品营销/卖货
触发词: "产品图"、"卖货图"、"新品上市"
推荐尺寸: 1024x1024
默认风格: 极简主义
默认模型: custom-textmodel-gt
Prompt 模板
A premium product marketing poster for {产品名}.
Main elements: {产品主体} placed at center, {产品细节/功能展示}, {使用场景暗示}.
Background: clean {白色/浅色} background with subtle gradient.
Foreground decorations: {相关道具/装饰元素}, soft shadow under product.
Color scheme: {品牌主色} + white + {点缀色}.
Title in Chinese: "{产品标题}"
Subtitle in Chinese: "{产品卖点}"
Bottom tagline in Chinese: "{促销/行动号召}"
Minimalist design, clean white background, lots of negative space,
elegant typography, premium feel, clear legible sharp Chinese text.
No watermark, no logo, clean image.
3. 节日节气海报
触发词: "春节"、"中秋"、"立春"、"端午"
推荐尺寸: 1024x1536
默认风格: 中国风
默认模型: custom-textmodel-gt
Prompt 模板
A festive marketing poster for {节日/节气名}.
Main elements: {节日代表性元素1, 元素2, 元素3, 元素4} arranged in elegant composition.
Background: {节日氛围背景} with traditional texture.
Foreground decorations: {节日装饰物}, {花卉/植物}, {传统纹样}.
Color scheme: {节日主色} + {辅助色} + gold accents.
Title in Chinese: "{节日标题}"
Subtitle in Chinese: "{节日祝福语}"
Bottom tagline in Chinese: "{品牌标语}"
Chinese traditional style, ink wash painting elements, red and gold color scheme,
traditional Chinese patterns, calligraphy-style typography,
clear legible sharp Chinese text.
No watermark, no logo, clean image.
4. 活动促销宣传
触发词: "促销"、"大促"、"年会"、"发布会"
推荐尺寸: 1536x1024(横版)
默认风格: 渐变弥散光
默认模型: custom-textmodel-gt
Prompt 模板
A dynamic promotional poster for {活动名}.
Main elements: {活动核心视觉元素1, 元素2, 元素3} in energetic composition.
Background: soft gradient with dreamy light effects, {主色调} to {辅助色} transition.
Foreground decorations: {装饰元素}, glowing particles, geometric shapes.
Color scheme: {渐变主色1} + {渐变主色2} + {点缀色}.
Title in Chinese: "{活动标题}"
Subtitle in Chinese: "{活动信息/时间地点}"
Bottom tagline in Chinese: "{行动号召/优惠信息}"
Soft gradient diffuse lighting, dreamy color transitions, modern social media aesthetic,
clear legible sharp Chinese text.
No watermark, no logo, clean image.
5. 品牌/企业宣传
触发词: "企业介绍"、"品牌故事"、"公司简介"
推荐尺寸: 1536x1024
默认风格: 极简主义
默认模型: custom-textmodel-gt
Prompt 模板
A professional brand poster for {企业/品牌名}.
Main elements: {企业标志性视觉元素}, {行业相关图形}, {企业愿景关键词}.
Background: clean minimal background with subtle brand color gradient.
Foreground decorations: {行业元素}, geometric accents, soft shadows.
Color scheme: {品牌主色} + white + {辅助色}.
Title in Chinese: "{企业标题}"
Subtitle in Chinese: "{企业定位/使命}"
Bottom tagline in Chinese: "{企业标语}"
Minimalist design, sophisticated layout, premium feel,
elegant typography, clear legible sharp Chinese text.
No watermark, no logo, clean image.
6. 社媒配图
触发词: "小红书"、"公众号封面"、"朋友圈"
推荐尺寸: 1024x1024
默认风格: 日系清新
默认模型: custom-textmodel-gt
Prompt 模板
A social media post image for {平台名} about {主题}.
Main elements: {主体内容元素1, 元素2, 元素3} in aesthetically pleasing arrangement.
Background: soft natural lighting, {浅色/自然色} background.
Foreground decorations: {装饰元素}, {植物/道具}, subtle text labels.
Color scheme: pastel tones, {主色} + {辅助色} + white.
Title in Chinese: "{吸引眼球的标题}"
Subtitle in Chinese: "{补充说明}"
Japanese fresh airy style, soft natural lighting, high-key lighting,
clean and bright atmosphere, clear legible sharp Chinese text.
No watermark, no logo, clean image.
7. 科普百科信息图
触发词: "百科图"、"科普图"、"图鉴"、"信息图"、"知识卡"
推荐尺寸: 1024x1536
默认风格: 杂志编辑风
默认模型: custom-textmodel-gt
Prompt 模板
An educational infographic poster about {主题}.
Main elements: {核心知识点图示1, 图示2, 图示3, 图示4} with clear visual hierarchy.
Background: clean light background with structured grid layout.
Foreground decorations: {图表/标注}, {图标}, {箭头/连接线}.
Color scheme: {知识主题色} + neutral grays + accent color.
Title in Chinese: "{科普标题}"
Section labels in Chinese: "{知识点1}", "{知识点2}", "{知识点3}"
Bottom note in Chinese: "{来源/备注}"
Magazine editorial style, sophisticated layout, structured information design,
professional publication quality, clear legible sharp Chinese text.
No watermark, no logo, clean image.
8. 旅游攻略手绘地图
触发词: "旅游攻略"、"手绘地图"、"CityWalk"
推荐尺寸: 1024x1536
默认风格: 手绘水彩
默认模型: custom-textmodel-gt
Prompt 模板
A hand-drawn travel guide map for {城市/区域}.
Main elements: {景点1, 景点2, 景点3, 景点4, 景点5} marked on a stylized map.
Background: hand-drawn watercolor map base with streets and landmarks.
Foreground decorations: {可爱图标标注}, {路线箭头}, {美食/住宿图标}, small illustrations.
Color scheme: watercolor blue, watercolor green, warm orange, cream paper.
Title in Chinese: "{城市名}CityWalk攻略"
Location labels in Chinese: "{景点名1}", "{景点名2}", "{景点名3}"
Bottom tagline in Chinese: "{攻略提示}"
Hand-drawn watercolor style, soft watercolor washes, delicate brush strokes,
travel journal aesthetic, clear legible sharp Chinese text.
No watermark, no logo, clean image.
9. 电商主图/详情图
触发词: "电商图"、"主图"、"详情页"
推荐尺寸: 1024x1024
默认风格: 3D立体
默认模型: custom-textmodel-gt
Prompt 模板
A premium e-commerce product main image for {产品名}.
Main elements: {产品主体} at center with 3D render quality, {产品特色展示}.
Background: clean studio background with soft gradient.
Foreground decorations: {价格标签位置}, {促销标签}, {品质图标}.
Color scheme: {产品色} + white + {促销红/橙}.
Title in Chinese: "{产品标题}"
Subtitle in Chinese: "{核心卖点}"
Price tag in Chinese: "{价格信息}"
3D C4D render style, realistic lighting and shadows, premium material textures,
professional product visualization, clear legible sharp Chinese text.
No watermark, no logo, clean image.
10. 公众号封面/配图
触发词: "公众号封面"、"推文配图"、"首图"
推荐尺寸: 1024x1024
默认风格: 杂志编辑风
默认模型: custom-textmodel-gt
Prompt 模板
A WeChat article cover image about {文章主题}.
Main elements: {主题视觉元素1, 元素2} in editorial composition.
Background: {背景描述} with professional color grading.
Foreground decorations: {装饰元素}, subtle texture, elegant framing.
Color scheme: {主色} + {辅助色} + white.
Title in Chinese: "{文章标题}"
Subtitle in Chinese: "{副标题/导语}"
Magazine editorial style, sophisticated layout, premium publication design,
clear legible sharp Chinese text.
No watermark, no logo, clean image.
11. 招聘/HR海报
触发词: "招聘海报"、"校招"、"社招"、"招人"
推荐尺寸: 1024x1536
默认风格: 科技感
默认模型: custom-textmodel-gt
Prompt 模板
A professional recruitment poster for {公司名/岗位}.
Main elements: {公司元素}, {岗位相关图标}, {团队场景暗示}.
Background: dark tech gradient with glowing accents.
Foreground decorations: {技能标签}, {福利图标}, geometric patterns.
Color scheme: deep blue + neon blue + white.
Title in Chinese: "{招聘标题}"
Subtitle in Chinese: "{岗位/要求}"
Bottom tagline in Chinese: "{行动号召/投递方式}"
Tech futuristic style, dark blue gradient background, glowing neon blue accents,
clean sans-serif typography, clear legible sharp Chinese text.
No watermark, no logo, clean image.
12. 企业文化海报
触发词: "团建"、"企业文化"、"价值观"
推荐尺寸: 1536x1024
默认风格: 插画风
默认模型: custom-textmodel-gt
Prompt 模板
A corporate culture poster about {文化主题}.
Main elements: {团队活动场景}, {价值观关键词视觉化}, {人物剪影}.
Background: warm {浅色} background with soft texture.
Foreground decorations: {装饰图标}, {植物/几何元素}, quote bubbles.
Color scheme: {温暖主色} + {辅助色} + white.
Title in Chinese: "{文化标题}"
Subtitle in Chinese: "{价值观描述}"
Bottom tagline in Chinese: "{企业标语}"
Flat vector illustration style, bold flat colors, friendly characters,
modern illustration, clear legible sharp Chinese text.
No watermark, no logo, clean image.
13. 金融/投资分析图
触发词: "投资分析"、"基金推荐"、"理财海报"
推荐尺寸: 1024x1536
默认风格: 杂志编辑风
默认模型: custom-textmodel-gt
Prompt 模板
A professional financial analysis infographic about {金融主题}.
Main elements: {数据图表元素1, 图表2}, {金融图标}, {市场趋势可视化}.
Background: clean light background with structured layout.
Foreground decorations: {数据标注}, {趋势箭头}, {图标}.
Color scheme: navy blue + gold + white + red/green accents.
Title in Chinese: "{分析标题}"
Subtitle in Chinese: "{副标题/时间范围}"
Data labels in Chinese: "{数据点1}", "{数据点2}"
Disclaimer in Chinese: "{风险提示}"
Magazine editorial style, sophisticated layout, professional financial publication quality,
clear legible sharp Chinese text.
No watermark, no logo, clean image.
14. 餐饮/美食/菜单
触发词: "美食海报"、"菜品图"、"餐厅推广"
推荐尺寸: 1024x1024
默认风格: 日系清新
默认模型: custom-textmodel-gt
Prompt 模板
An appetizing food marketing poster for {餐厅/菜品名}.
Main elements: {菜品主体} beautifully plated, {食材展示}, {餐具/环境}.
Background: soft natural lighting, {浅色木质/石材} texture background.
Foreground decorations: {食材装饰}, {酱料/点缀}, fresh herbs.
Color scheme: warm natural tones, {主色} + cream + green accent.
Title in Chinese: "{菜品/餐厅标题}"
Subtitle in Chinese: "{菜品描述/特色}"
Bottom tagline in Chinese: "{价格/促销信息}"
Japanese fresh airy style, soft natural lighting, high-key lighting,
clean and bright atmosphere, clear legible sharp Chinese text.
No watermark, no logo, clean image.
15. 教育/培训海报
触发词: "公开课"、"招生"、"培训海报"
推荐尺寸: 1024x1536
默认风格: 扁平化插画
默认模型: custom-textmodel-gt
Prompt 模板
An educational training poster for {课程/培训名}.
Main elements: {课程主题图标}, {学习场景}, {知识可视化元素}.
Background: clean {浅色} background with geometric patterns.
Foreground decorations: {书本/铅笔图标}, {知识标签}, {进度条}.
Color scheme: {活力主色} + {辅助色} + white.
Title in Chinese: "{课程标题}"
Subtitle in Chinese: "{课程信息/时间}"
Bottom tagline in Chinese: "{报名方式/行动号召}"
Flat vector illustration style, bold flat colors, friendly characters,
modern illustration, clear legible sharp Chinese text.
No watermark, no logo, clean image.
16. 医疗健康科普
触发词: "健康科普"、"医疗海报"、"养生"
推荐尺寸: 1024x1536
默认风格: 扁平化插画
默认模型: custom-textmodel-gt
Prompt 模板
A health education infographic about {健康主题}.
Main elements: {人体器官/系统图示}, {健康习惯图标}, {数据可视化}.
Background: clean light background with medical cross patterns.
Foreground decorations: {医疗图标}, {健康标签}, {箭头/连接线}.
Color scheme: medical blue + green + white + warm accent.
Title in Chinese: "{健康标题}"
Section labels in Chinese: "{知识点1}", "{知识点2}"
Bottom tagline in Chinese: "{健康提示}"
Flat vector illustration style, clean and professional,
medical-friendly aesthetic, clear legible sharp Chinese text.
No watermark, no logo, clean image.
17. 房产/家居装饰
触发词: "房产海报"、"楼盘宣传"、"家居图"
推荐尺寸: 1536x1024
默认风格: 极简主义
默认模型: custom-textmodel-gt
Prompt 模板
A premium real estate marketing poster for {楼盘/项目名}.
Main elements: {建筑外观}, {室内场景}, {景观环境}.
Background: {天空/自然环境} with atmospheric depth.
Foreground decorations: {园林/水景}, {生活场景暗示}, soft shadows.
Color scheme: {建筑主色} + warm tones + natural green.
Title in Chinese: "{项目标题}"
Subtitle in Chinese: "{项目定位/卖点}"
Bottom tagline in Chinese: "{价格/联系方式}"
Minimalist design, clean composition, premium real estate aesthetic,
architectural photography quality, clear legible sharp Chinese text.
No watermark, no logo, clean image.
18. 汽车/出行
触发词: "汽车海报"、"出行宣传"
推荐尺寸: 1536x1024
默认风格: 科技感
默认模型: custom-textmodel-gt
Prompt 模板
A dynamic automotive marketing poster for {车型/品牌}.
Main elements: {汽车主体} in dynamic angle, {道路/环境}, {速度感元素}.
Background: {城市/公路/自然} with motion blur effect.
Foreground decorations: {光影效果}, {科技元素}, {性能标签}.
Color scheme: {品牌色} + dark background + neon accents.
Title in Chinese: "{车型标题}"
Subtitle in Chinese: "{核心卖点}"
Bottom tagline in Chinese: "{价格/行动号召}"
Tech futuristic style, dynamic composition, automotive photography quality,
clear legible sharp Chinese text.
No watermark, no logo, clean image.
19. 时尚/穿搭
触发词: "时尚海报"、"穿搭推荐"
推荐尺寸: 1024x1536
默认风格: 杂志编辑风
默认模型: custom-textmodel-gt
Prompt 模板
A fashion editorial poster about {时尚主题}.
Main elements: {时尚单品1, 单品2, 单品3} in editorial composition.
Background: {高级感背景} with professional color grading.
Foreground decorations: {配饰}, {纹理/材质细节}, elegant typography.
Color scheme: {季节色} + neutral tones + accent color.
Title in Chinese: "{时尚标题}"
Subtitle in Chinese: "{穿搭建议}"
Bottom tagline in Chinese: "{品牌/系列}"
Magazine editorial style, sophisticated layout, high fashion aesthetic,
professional photography quality, clear legible sharp Chinese text.
No watermark, no logo, clean image.
20. 公益/社会责任
触发词: "公益海报"、"环保宣传"
推荐尺寸: 1024x1536
默认风格: 手绘水彩
默认模型: custom-textmodel-gt
Prompt 模板
A public service announcement poster about {公益主题}.
Main elements: {主题核心视觉}, {自然/人物元素}, {情感场景}.
Background: {自然/温暖} background with soft texture.
Foreground decorations: {自然元素}, {象征性图标}, gentle illustrations.
Color scheme: {自然色调} + warm tones + white.
Title in Chinese: "{公益标题}"
Subtitle in Chinese: "{行动号召}"
Bottom tagline in Chinese: "{组织/口号}"
Hand-drawn watercolor style, soft watercolor washes, warm and inviting feel,
clear legible sharp Chinese text.
No watermark, no logo, clean image.
图生图场景补充模板
风格迁移模板(gpt-image-2)
Transform to {目标风格} style. Keep the person, text and layout identical.
Change: {具体变更内容,如 colors to X, background to Y}.
Same professional design style and layout as reference image.
创意编辑模板(custom-imagemodel-gt)
{编辑指令},例如:
- Replace the background with {新背景描述}
- Add {新元素} to the image
- Remove {要去除的元素} from the image
- Change the color scheme to {新配色}
第四部分:API 参考文档(hanis-image-mcp)
> 本文档供 Skill 内部参考,完整记录 hanis-image-mcp 服务的 API 规范。
服务信息
| 项目 | 值 |
|---|---|
| 服务名称 | Hanis Image MCP |
| 生产地址 | https://hanis-image-mcp-288810-10-1426987343.sh.run.tcloudbase.com |
| MCP 端点 | /mcp |
| 协议 | MCP Streamable HTTP (JSON-RPC 2.0 + SSE) |
| 工具数量 | 3 个 |
| 支持模型 | 8 种(GPT-Image / Grok / Gemini / 腾讯定制) |
鉴权
所有 MCP 工具调用必须提供 API Key,三选一:
| 方式 | 格式 | 优先级 |
|---|---|---|
| Authorization Header | Authorization: Bearer <key> |
推荐 |
| X-API-Key Header | X-API-Key: <key> |
备选 |
| 工具参数 | arguments.access_key: "<key>" |
兼容模式 |
> 通过 WorkBuddy MCP 连接器调用时,API Key 由连接器自动管理,无需手动传入。
模型速查
| 模型 ID | 文生图 | 图生图 | 返回 | 速度 | 关键特性 |
|---|---|---|---|---|---|
custom-textmodel-gt ⭐ |
✅ | ✅ | URL | ~15-25s | 默认文生图 |
custom-imagemodel-gt ⭐ |
❌ | ✅ | URL | ~27-31s | 默认图生图,⚠️ 会重新生成人物/内容 |
gpt-image-1 |
✅ | ✅ | base64 | ~25-40s | 支持透明背景 |
gpt-image-2 🎯 |
✅ | ✅ | base64 | ~40-70s | 风格迁移首选,内容保持最优 |
grok-imagine |
✅ | ❌ | URL | 快 | xAI 快速模型 |
grok-imagine-image |
✅ | ❌ | URL | 中等 | Grok 变体 |
grok-imagine-image-quality |
✅ | ❌ | URL | 较慢 | Grok 高质量 |
gemini-3.1-flash-image |
✅ | ❌ | URL | 中等 | Google Gemini |
模型选择决策表
用户意图 → 模型
──────────────────────────────────────────────────────
"帮我画一张..." → custom-textmodel-gt(默认)
"把这张图换成XX风格,人物/文字不变" → gpt-image-2 🎯
"换一下背景/加个元素" → custom-imagemodel-gt
"需要透明背景的图" → gpt-image-1 / gpt-image-2
"快速预览效果" → gpt-image-1
"高质量成品输出" → gpt-image-2
> ⚠️ 致命陷阱:custom-imagemodel-gt 图生图时会重新生成人物和内容,完全改变原图。如果用户要求"换风格但保持人物不变",必须用 gpt-image-2,否则结果与原图完全无关。
工具 1:generate_image — 文生图
根据文本描述生成图片。
参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
prompt |
string | ✅ | — | 图片描述,最大 32000 字符 |
model |
string | 否 | custom-textmodel-gt |
仅支持文生图模型 |
size |
string | 否 | 1024x1024 |
auto / 1024x1024 / 1536x1024 / 1024x1536 |
n |
integer | 否 | 1 |
生成数量 1-10 |
quality |
string | 否 | auto |
auto / high / medium / low |
background |
string | 否 | auto |
auto / opaque / transparent(transparent 仅 gpt-image-1) |
output_format |
string | 否 | png |
png / jpeg / webp |
output_compression |
integer | 否 | — | 0-100(仅 jpeg) |
logo_add |
integer | 否 | 0 |
AI 标识:0=不加, 1=加 |
调用示例
{
"prompt": "一只在花丛中飞舞的蝴蝶,中国水墨画风格",
"model": "custom-textmodel-gt",
"size": "1024x1024",
"n": 1
}
工具 2:edit_image — 图生图
基于参考图片进行编辑或风格迁移。
参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
image_url |
string | 三选一 | — | 单张图片 HTTPS URL |
image_urls |
string[] | 三选一 | — | 多张图片 URL(1-16) |
image_base64_data_url |
string | 三选一 | — | base64 Data URL,格式 data:image/{jpeg\|png\|webp};base64,... |
mask_image_url |
string | 否 | — | 遮罩图 URL(PNG,透明=编辑区) |
prompt |
string | 否* | — | 编辑指令(GPT 模型推荐填写) |
model |
string | 否 | custom-imagemodel-gt |
仅图生图模型 |
size |
string | 否 | 1024x1024 |
输出尺寸 |
n |
integer | 否 | 1 |
1-10 |
quality |
string | 否 | auto |
auto / high / medium / low |
background |
string | 否 | auto |
auto / opaque / transparent |
output_format |
string | 否 | png |
png / jpeg |
output_compression |
integer | 否 | — | 0-100 |
response_format |
string | 否 | url |
url / b64_json(仅 custom-imagemodel-gt) |
input_fidelity |
string | 否 | — | high / low(仅 custom-imagemodel-gt) |
logo_add |
integer | 否 | 0 |
AI 标识 |
场景 A:风格迁移(保持内容不变)— 用 gpt-image-2
用户: "把这张课程海报换成极简杂志风格,人物和文字不变"
{
"model": "gpt-image-2",
"image_url": "https://example.com/poster.jpg",
"prompt": "Transform to premium minimal magazine style. Keep the person, text and layout identical. Change: colors to black/white/gray with gold accents, background to clean white.",
"size": "1024x1024",
"n": 1
}
场景 B:创意编辑(换背景/加元素)— 用 custom-imagemodel-gt
用户: "把这张照片的背景换成海滩日落"
{
"model": "custom-imagemodel-gt",
"image_url": "https://example.com/photo.jpg",
"prompt": "Replace the background with a beach at sunset",
"input_fidelity": "high"
}
场景 C:本地/base64 图片
{
"model": "gpt-image-2",
"image_base64_data_url": "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
"prompt": "Add a golden hour lighting effect"
}
图传方式对比
| 方式 | 速度 | 场景 |
|---|---|---|
image_url |
最快 | 公网图片,推荐优先使用 |
image_base64_data_url |
较慢 | 本地/私密图片 |
工具 3:list_image_models — 模型列表
查询可用模型及其能力。
参数
无必填参数(可选 access_key 兼容模式)。
调用示例
{
"name": "list_image_models",
"arguments": {}
}
响应包含 models[] 数组、text_to_image_model_ids[]、image_to_image_model_ids[] 和 defaults。
响应结构
统一成功响应
{
success: true,
request_id: string, // UUID 追踪
mode: "text-to-image" | "image-to-image",
model: string, // 实际使用的模型
size: string, // 输出尺寸
count: number, // 图片数量
images: ImageItem[], // 图片数组
warnings: string[] // 非致命告警
}
ImageItem 三种格式
// URL 格式(有效期约 1 小时)
{ index: number, kind: "url", url: string }
// Base64 格式(GPT 模型,直接解码保存)
{ index: number, kind: "base64", mime_type: string, base64: string, byte_length: number }
// 空结果(生成失败但不算错误)
{ index: number, kind: "empty", warning: string }
错误响应
{
success: false,
request_id: string,
error: {
code: string, // 错误码
message: string, // 人类可读
retryable: boolean // 可否重试
}
}
错误处理决策表
| 错误码 | 含义 | Agent 行动 |
|---|---|---|
UNAUTHORIZED |
Key 无效 | 提示用户检查配置,不重试 |
INVALID_ARGUMENT |
参数错误 | 提示修正(如缩短 prompt),不重试 |
INVALID_IMAGE_URL |
图片 URL 不可访问 | 提示检查 URL 或改用 base64,不重试 |
IMAGE_DOWNLOAD_BLOCKED |
SSRF 拦截 | 确认 URL 合法,不重试 |
UPSTREAM_ERROR |
上游服务报错 | 等 3s 重试 1 次 |
UPSTREAM_UNAVAILABLE |
上游不可用 | 等 10s 重试 1 次 |
UPSTREAM_TIMEOUT |
上游超时 | 提示"生成超时,请重试",可重试 |
UPSTREAM_INVALID_RESPONSE |
响应异常 | 提示"服务异常,尝试换模型",不重试 |
RATE_LIMITED |
限流 | 等 60s 自动重试 |
超时配置
不同模型建议的超时时间:
| 模型 | 1024x1024 | 2048x2048+ |
|---|---|---|
custom-textmodel-gt |
60s | 180s |
custom-imagemodel-gt |
90s | 180s |
gpt-image-1 |
60s | 120s |
gpt-image-2 |
120s | 300s |
| 全模型兜底 | 480s(8 分钟) | — |
实战要点
1. 风格迁移必须用 gpt-image-2
❌ 错误:edit_image(model="custom-imagemodel-gt", prompt="换风格,保持人物不变")
→ 人物、文字、排版全部变了
✅ 正确:edit_image(model="gpt-image-2", prompt="Transform to X style. Keep person and content identical.")
→ 人物内容不变,只换风格
2. prompt 语言策略
- GPT 模型(gpt-image-1/2):英文 prompt 效果更好
- 腾讯模型(custom-*-gt):中英文均可
- 风格迁移推荐英文 prompt,关键词加
Keep the person/text/layout identical
3. 图传优先级
URL 直传 > base64 直传。URL 方式速度快,且保真度更高。base64 会增加 ~33% 传输体积。
4. URL 有效期
返回的图片 URL 有约 1 小时有效期。如需长期使用,应下载保存。
5. 正确解析 SSE 响应
Agent → POST /mcp → 收到 SSE 流
1. 按行读取,过滤 "data:" 前缀
2. 解析 JSON
3. 取 result.structuredContent(不是 result.content[0].text)
4. 遍历 images[],按 kind 处理 url/base64/empty
> 通过 DeferExecuteTool 调用时,SSE 解析已由 MCP 连接器自动完成。
第二部分:设计风格库(15 种营销视觉风格)
> 本文档详细说明每种设计风格的视觉特征、适用场景、色彩方案和 prompt 关键词。
1. 极简主义(Minimalist)
| 属性 | 说明 |
|---|---|
| 英文标注 | Minimalist |
| 适用场景 | 品牌宣传、产品营销、电商图、房产家居 |
| 色彩特征 | 大面积留白,单色+点缀色 |
| 设计灵感 | Apple、Muji、IKEA 产品视觉 |
Prompt 关键词: minimalist design, clean white background, lots of negative space, simple composition, single accent color, elegant typography, premium feel
色彩方案:
- 主色:白色 #FFFFFF / 浅灰 #F5F5F5
- 点缀色:品牌色(如 #3BA0FF)
- 文字色:深灰 #333333
2. 中国风/国潮(Chinese Traditional Style)
| 属性 | 说明 |
|---|---|
| 英文标注 | Chinese traditional style |
| 适用场景 | 节日节气、城市宣传、餐饮美食、文旅 |
| 色彩特征 | 红/金/墨色/青绿山水 |
| 设计灵感 | 故宫文创、国潮品牌 |
Prompt 关键词: Chinese traditional style, ink wash painting elements, red and gold color scheme, traditional Chinese patterns, seal stamp decoration, calligraphy-style typography
色彩方案:
- 主色:中国红 #C8102E / 金色 #D4AF37
- 辅助色:墨色 #1A1A2E / 青绿 #2D6A4F
- 点缀色:宣纸白 #FDF6E3
3. 科技感/未来感(Tech Futuristic)
| 属性 | 说明 |
|---|---|
| 英文标注 | Tech futuristic |
| 适用场景 | 企业宣传、招聘海报、金融投资、汽车出行 |
| 色彩特征 | 深蓝/渐变紫/霓虹蓝 |
| 设计灵感 | 科技公司发布会、赛博朋克 UI |
Prompt 关键词: tech futuristic style, dark blue gradient background, glowing neon blue accents, geometric tech patterns, holographic elements, clean sans-serif typography, digital circuit motifs
色彩方案:
- 主色:深蓝 #0A1628 / 科技蓝 #0077FF
- 辅助色:渐变紫 #6C33B5 / 霓虹蓝 #00E5FF
- 点缀色:白色 #FFFFFF
4. 扁平化插画(Flat Vector Illustration)
| 属性 | 说明 |
|---|---|
| 英文标注 | Flat vector illustration |
| 适用场景 | 教育培训、社媒配图、HR海报、医疗健康 |
| 色彩特征 | 明快纯色,饱和度适中 |
| 设计灵感 | Google Material Design、Notion 插画 |
Prompt 关键词: flat vector illustration style, bold flat colors, simple geometric shapes, friendly characters, modern illustration, clean outlines, vibrant but harmonious palette
色彩方案:
- 主色:明快纯色(蓝 #4A90D9 / 橙 #F5A623 / 绿 #7ED321)
- 辅助色:浅灰 #E8E8E8 / 白 #FFFFFF
- 点缀色:对比色
5. 渐变弥散光(Soft Gradient Diffuse)
| 属性 | 说明 |
|---|---|
| 英文标注 | Soft gradient diffuse |
| 适用场景 | 活动促销、社媒配图、公众号封面 |
| 色彩特征 | 柔和渐变,梦幻光感 |
| 设计灵感 | Instagram 渐变、Stripe 设计风格 |
Prompt 关键词: soft gradient diffuse lighting, dreamy color transitions, glassmorphism blur effects, pastel gradient background, ethereal glow, modern social media aesthetic
色彩方案:
- 主色:粉紫渐变 #FF6B9D → #C44CE1
- 辅助色:蓝紫渐变 #667EEA → #764BA2
- 点缀色:白色光晕
6. 杂志编辑风(Magazine Editorial)
| 属性 | 说明 |
|---|---|
| 英文标注 | Magazine editorial |
| 适用场景 | 品牌宣传、科普百科、城市营销、时尚穿搭 |
| 色彩特征 | 高级灰、衬线字体感 |
| 设计灵感 | Bloomberg、The Economist、National Geographic |
Prompt 关键词: magazine editorial style, sophisticated layout, serif typography, high-end color grading, professional photojournalism aesthetic, elegant text hierarchy, premium publication design
色彩方案:
- 主色:高级灰 #8B8B8B / 深灰 #2C2C2C
- 辅助色:米白 #F5F0E8 / 黑 #1A1A1A
- 点缀色:品牌色或金色
7. 莫兰迪色系(Morandi Muted Colors)
| 属性 | 说明 |
|---|---|
| 英文标注 | Morandi muted colors |
| 适用场景 | 品牌宣传、餐饮美食、生活方式、房产家居 |
| 色彩特征 | 低饱和、灰调高级感 |
| 设计灵感 | 乔治·莫兰迪静物画、日式侘寂风 |
Prompt 关键词: Morandi color palette, muted dusty tones, low saturation colors, sophisticated grayish hues, understated elegance, soft and calm atmosphere
色彩方案:
- 主色:灰粉 #D4C5C0 / 灰绿 #B5C4B1 / 灰蓝 #A8B8C4
- 辅助色:米灰 #E8E2DC / 深灰 #6B6B6B
- 点缀色:暗金 #C4B998
8. 手绘水彩(Hand-drawn Watercolor)
| 属性 | 说明 |
|---|---|
| 英文标注 | Hand-drawn watercolor |
| 适用场景 | 旅游攻略、科普百科、餐饮美食、公益海报 |
| 色彩特征 | 通透水彩、自然色调 |
| 设计灵感 | 水彩插画师作品、旅行手账 |
Prompt 关键词: hand-drawn watercolor style, soft watercolor washes, delicate brush strokes, natural pigments, transparent color layers, artistic illustration, warm and inviting feel
色彩方案:
- 主色:水彩蓝 #7EB3C4 / 水彩绿 #8FBC8F / 水彩橙 #E8A87C
- 辅助色:宣纸色 #FAF3E8 / 浅褐 #D4C4A8
- 点缀色:水彩红 #D4756B
9. 赛博朋克(Cyberpunk Neon)
| 属性 | 说明 |
|---|---|
| 英文标注 | Cyberpunk neon |
| 适用场景 | 活动促销、科技产品 |
| 色彩特征 | 霓虹紫/蓝/粉、暗底 |
| 设计灵感 | 银翼杀手、赛博朋克 2077 |
Prompt 关键词: cyberpunk neon style, dark moody background, glowing neon purple and blue lights, futuristic cityscape, holographic UI elements, rain-soaked streets reflection, Blade Runner aesthetic
色彩方案:
- 主色:霓虹紫 #BF00FF / 霓虹蓝 #00FFFF
- 辅助色:暗黑 #0D0221 / 深紫 #2D0066
- 点缀色:霓虹粉 #FF006E
10. 日系清新(Japanese Fresh Airy)
| 属性 | 说明 |
|---|---|
| 英文标注 | Japanese fresh airy |
| 适用场景 | 社媒配图、餐饮美食、旅游 |
| 色彩特征 | 淡蓝/米白/浅粉、高明度 |
| 设计灵感 | 无印良品、日系杂志 |
Prompt 关键词: Japanese fresh airy style, soft natural lighting, pastel color palette, clean and bright atmosphere, minimal decoration, gentle and warm mood, high-key lighting
色彩方案:
- 主色:淡蓝 #B8D4E3 / 米白 #F8F4ED / 浅粉 #F4D4D4
- 辅助色:浅绿 #C8E6C9 / 暖灰 #E0E0E0
- 点缀色:木色 #D4B896
11. 酸性设计(Acid Graphics Brutism)
| 属性 | 说明 |
|---|---|
| 英文标注 | Acid graphics brutalism |
| 适用场景 | 潮流活动、音乐节 |
| 色彩特征 | 高饱和撞色、液态金属感 |
| 设计灵感 | Y2K 美学、实验性平面设计 |
Prompt 关键词: acid graphics brutalism style, high saturation clashing colors, liquid chrome metallic textures, bold experimental typography, Y2K aesthetic, distorted grid patterns, raw energetic composition
色彩方案:
- 主色:荧光绿 #39FF14 / 亮粉 #FF10F0
- 辅助色:液态银 #C0C0C0 / 亮黄 #FFFF00
- 点缀色:电蓝 #0080FF
12. 3D立体/C4D(3D C4D Render Style)
| 属性 | 说明 |
|---|---|
| 英文标注 | 3D C4D render style |
| 适用场景 | 产品营销、电商图、科技 |
| 色彩特征 | 立体光影、材质质感 |
| 设计灵感 | 3D 产品渲染、C4D 动画 |
Prompt 关键词: 3D C4D render style, realistic lighting and shadows, premium material textures, soft studio lighting, depth of field, professional product visualization, high-quality 3D rendering
色彩方案:
- 主色:根据产品色调
- 辅助色:柔和灰 #E8E8E8 / 深灰 #4A4A4A
- 点缀色:光泽高光
13. 复古怀旧(Retro Vintage)
| 属性 | 说明 |
|---|---|
| 英文标注 | Retro vintage |
| 适用场景 | 节日节气、品牌宣传、餐饮美食 |
| 色彩特征 | 做旧色调、胶片质感 |
| 设计灵感 | 复古海报、老照片、胶片摄影 |
Prompt 关键词: retro vintage style, faded film colors, grain texture, vintage poster layout, aged paper background, classic typography, nostalgic warm tones, 70s-80s color palette
色彩方案:
- 主色:做旧棕 #8B6F47 / 褪色红 #C85A5A / 做旧绿 #6B8E6B
- 辅助色:泛黄米色 #E8DCC4 / 深褐 #4A3728
- 点缀色:暗金 #B8860B
14. 玻璃拟态(Glassmorphism)
| 属性 | 说明 |
|---|---|
| 英文标注 | Glassmorphism |
| 适用场景 | 科技、APP UI 设计、品牌宣传 |
| 色彩特征 | 半透明毛玻璃、模糊背景 |
| 设计灵感 | macOS Big Sur、iOS 设计语言 |
Prompt 关键词: glassmorphism style, frosted glass effect, semi-transparent panels, blurred gradient background, subtle light refraction, modern UI aesthetic, layered depth with blur
色彩方案:
- 主色:半透明蓝 rgba(100,149,237,0.7) / 半透明紫 rgba(147,112,219,0.7)
- 辅助色:模糊渐变背景
- 点缀色:白色高光边框
15. 新国风插画(New Chinese Illustration)
| 属性 | 说明 |
|---|---|
| 英文标注 | New Chinese illustration |
| 适用场景 | 节日节气、城市宣传、品牌宣传、文旅 |
| 色彩特征 | 现代插画+传统元素融合 |
| 设计灵感 | 新国风插画师作品、敦煌文创 |
Prompt 关键词: New Chinese illustration style, modern illustration with traditional Chinese elements, contemporary color palette with cultural motifs, fusion of ink painting and digital art, elegant cultural patterns
色彩方案:
- 主色:靛蓝 #3D5A80 / 朱砂红 #E63946 / 黛绿 #588157
- 辅助色:宣纸白 #FAF3E8 / 墨灰 #495867
- 点缀色:金色 #D4AF37
风格组合建议
某些场景可以组合两种风格产生独特效果:
| 组合 | 效果 | 适用场景 |
|---|---|---|
| 极简主义 + 莫兰迪 | 高级冷淡风 | 品牌宣传、生活方式 |
| 中国风 + 手绘水彩 | 文艺国风 | 城市文旅、节日 |
| 科技感 + 玻璃拟态 | 未来科技感 | 科技产品、APP |
| 杂志风 + 复古怀旧 | 复古杂志感 | 品牌故事、时尚 |
| 新国风 + 扁平化 | 国潮插画风 | 社媒、教育 |
第三部分:营销场景模板库(20 类场景)
> 本文档详细说明 20 类营销场景的设计要点、推荐参数和 prompt 模板。
> 模板中 {占位符} 需根据用户需求替换。
Prompt 通用结构
{主体元素描述} + {背景环境} + {前景装饰元素} + {色彩方案} + {中文文案标注} + {风格定位} + {排版约束} + no watermark, no logo, clean image
1. 城市/景区营销
触发词: "深圳宣传"、"成都旅游"、"杭州城市海报"
推荐尺寸: 1024x1536(竖版)
默认风格: 杂志编辑风
默认模型: custom-textmodel-gt
Prompt 模板
A premium marketing poster for {城市名}.
Main elements: {地标1, 地标2, 地标3, 地标4} arranged in a vertical composition.
Background: {城市天际线/山水景观} with atmospheric depth.
Foreground decorations: {城市花/树/交通工具等装饰元素}.
Color scheme: {2-3种主色 + 1种点缀色}.
Title in Chinese: "{城市宣传标题}"
Subtitle in Chinese: "{副标题/宣传语}"
Bottom tagline in Chinese: "{底部标语}"
Magazine editorial style, sophisticated layout, high-end color grading,
professional travel photography aesthetic, clear legible sharp Chinese text.
No watermark, no logo, clean image.
示例(深圳)
A premium marketing poster for Shenzhen.
Main elements: Ping An Finance Centre, Shenzhen Bay Bridge, Civic Center,
Window of the World arranged in a vertical composition.
Background: Shenzhen skyline at golden hour with ocean and mountains.
Foreground decorations: bougainvillea flowers, modern bus, palm trees.
Color scheme: deep blue #0A4D8C, warm gold #F5A623, white #FFFFFF, accent teal #00B4D8.
Title in Chinese: "深圳,山海相连的城市"
Subtitle in Chinese: "创新之都 · 湾区引擎"
Bottom tagline in Chinese: "来了就是深圳人"
Magazine editorial style, sophisticated layout, high-end color grading,
professional travel photography aesthetic, clear legible sharp Chinese text.
No watermark, no logo, clean image.
2. 产品营销/卖货
触发词: "产品图"、"卖货图"、"新品上市"
推荐尺寸: 1024x1024
默认风格: 极简主义
默认模型: custom-textmodel-gt
Prompt 模板
A premium product marketing poster for {产品名}.
Main elements: {产品主体} placed at center, {产品细节/功能展示}, {使用场景暗示}.
Background: clean {白色/浅色} background with subtle gradient.
Foreground decorations: {相关道具/装饰元素}, soft shadow under product.
Color scheme: {品牌主色} + white + {点缀色}.
Title in Chinese: "{产品标题}"
Subtitle in Chinese: "{产品卖点}"
Bottom tagline in Chinese: "{促销/行动号召}"
Minimalist design, clean white background, lots of negative space,
elegant typography, premium feel, clear legible sharp Chinese text.
No watermark, no logo, clean image.
3. 节日节气海报
触发词: "春节"、"中秋"、"立春"、"端午"
推荐尺寸: 1024x1536
默认风格: 中国风
默认模型: custom-textmodel-gt
Prompt 模板
A festive marketing poster for {节日/节气名}.
Main elements: {节日代表性元素1, 元素2, 元素3, 元素4} arranged in elegant composition.
Background: {节日氛围背景} with traditional texture.
Foreground decorations: {节日装饰物}, {花卉/植物}, {传统纹样}.
Color scheme: {节日主色} + {辅助色} + gold accents.
Title in Chinese: "{节日标题}"
Subtitle in Chinese: "{节日祝福语}"
Bottom tagline in Chinese: "{品牌标语}"
Chinese traditional style, ink wash painting elements, red and gold color scheme,
traditional Chinese patterns, calligraphy-style typography,
clear legible sharp Chinese text.
No watermark, no logo, clean image.
4. 活动促销宣传
触发词: "促销"、"大促"、"年会"、"发布会"
推荐尺寸: 1536x1024(横版)
默认风格: 渐变弥散光
默认模型: custom-textmodel-gt
Prompt 模板
A dynamic promotional poster for {活动名}.
Main elements: {活动核心视觉元素1, 元素2, 元素3} in energetic composition.
Background: soft gradient with dreamy light effects, {主色调} to {辅助色} transition.
Foreground decorations: {装饰元素}, glowing particles, geometric shapes.
Color scheme: {渐变主色1} + {渐变主色2} + {点缀色}.
Title in Chinese: "{活动标题}"
Subtitle in Chinese: "{活动信息/时间地点}"
Bottom tagline in Chinese: "{行动号召/优惠信息}"
Soft gradient diffuse lighting, dreamy color transitions, modern social media aesthetic,
clear legible sharp Chinese text.
No watermark, no logo, clean image.
5. 品牌/企业宣传
触发词: "企业介绍"、"品牌故事"、"公司简介"
推荐尺寸: 1536x1024
默认风格: 极简主义
默认模型: custom-textmodel-gt
Prompt 模板
A professional brand poster for {企业/品牌名}.
Main elements: {企业标志性视觉元素}, {行业相关图形}, {企业愿景关键词}.
Background: clean minimal background with subtle brand color gradient.
Foreground decorations: {行业元素}, geometric accents, soft shadows.
Color scheme: {品牌主色} + white + {辅助色}.
Title in Chinese: "{企业标题}"
Subtitle in Chinese: "{企业定位/使命}"
Bottom tagline in Chinese: "{企业标语}"
Minimalist design, sophisticated layout, premium feel,
elegant typography, clear legible sharp Chinese text.
No watermark, no logo, clean image.
6. 社媒配图
触发词: "小红书"、"公众号封面"、"朋友圈"
推荐尺寸: 1024x1024
默认风格: 日系清新
默认模型: custom-textmodel-gt
Prompt 模板
A social media post image for {平台名} about {主题}.
Main elements: {主体内容元素1, 元素2, 元素3} in aesthetically pleasing arrangement.
Background: soft natural lighting, {浅色/自然色} background.
Foreground decorations: {装饰元素}, {植物/道具}, subtle text labels.
Color scheme: pastel tones, {主色} + {辅助色} + white.
Title in Chinese: "{吸引眼球的标题}"
Subtitle in Chinese: "{补充说明}"
Japanese fresh airy style, soft natural lighting, high-key lighting,
clean and bright atmosphere, clear legible sharp Chinese text.
No watermark, no logo, clean image.
7. 科普百科信息图
触发词: "百科图"、"科普图"、"图鉴"、"信息图"、"知识卡"
推荐尺寸: 1024x1536
默认风格: 杂志编辑风
默认模型: custom-textmodel-gt
Prompt 模板
An educational infographic poster about {主题}.
Main elements: {核心知识点图示1, 图示2, 图示3, 图示4} with clear visual hierarchy.
Background: clean light background with structured grid layout.
Foreground decorations: {图表/标注}, {图标}, {箭头/连接线}.
Color scheme: {知识主题色} + neutral grays + accent color.
Title in Chinese: "{科普标题}"
Section labels in Chinese: "{知识点1}", "{知识点2}", "{知识点3}"
Bottom note in Chinese: "{来源/备注}"
Magazine editorial style, sophisticated layout, structured information design,
professional publication quality, clear legible sharp Chinese text.
No watermark, no logo, clean image.
8. 旅游攻略手绘地图
触发词: "旅游攻略"、"手绘地图"、"CityWalk"
推荐尺寸: 1024x1536
默认风格: 手绘水彩
默认模型: custom-textmodel-gt
Prompt 模板
A hand-drawn travel guide map for {城市/区域}.
Main elements: {景点1, 景点2, 景点3, 景点4, 景点5} marked on a stylized map.
Background: hand-drawn watercolor map base with streets and landmarks.
Foreground decorations: {可爱图标标注}, {路线箭头}, {美食/住宿图标}, small illustrations.
Color scheme: watercolor blue, watercolor green, warm orange, cream paper.
Title in Chinese: "{城市名}CityWalk攻略"
Location labels in Chinese: "{景点名1}", "{景点名2}", "{景点名3}"
Bottom tagline in Chinese: "{攻略提示}"
Hand-drawn watercolor style, soft watercolor washes, delicate brush strokes,
travel journal aesthetic, clear legible sharp Chinese text.
No watermark, no logo, clean image.
9. 电商主图/详情图
触发词: "电商图"、"主图"、"详情页"
推荐尺寸: 1024x1024
默认风格: 3D立体
默认模型: custom-textmodel-gt
Prompt 模板
A premium e-commerce product main image for {产品名}.
Main elements: {产品主体} at center with 3D render quality, {产品特色展示}.
Background: clean studio background with soft gradient.
Foreground decorations: {价格标签位置}, {促销标签}, {品质图标}.
Color scheme: {产品色} + white + {促销红/橙}.
Title in Chinese: "{产品标题}"
Subtitle in Chinese: "{核心卖点}"
Price tag in Chinese: "{价格信息}"
3D C4D render style, realistic lighting and shadows, premium material textures,
professional product visualization, clear legible sharp Chinese text.
No watermark, no logo, clean image.
10. 公众号封面/配图
触发词: "公众号封面"、"推文配图"、"首图"
推荐尺寸: 1024x1024
默认风格: 杂志编辑风
默认模型: custom-textmodel-gt
Prompt 模板
A WeChat article cover image about {文章主题}.
Main elements: {主题视觉元素1, 元素2} in editorial composition.
Background: {背景描述} with professional color grading.
Foreground decorations: {装饰元素}, subtle texture, elegant framing.
Color scheme: {主色} + {辅助色} + white.
Title in Chinese: "{文章标题}"
Subtitle in Chinese: "{副标题/导语}"
Magazine editorial style, sophisticated layout, premium publication design,
clear legible sharp Chinese text.
No watermark, no logo, clean image.
11. 招聘/HR海报
触发词: "招聘海报"、"校招"、"社招"、"招人"
推荐尺寸: 1024x1536
默认风格: 科技感
默认模型: custom-textmodel-gt
Prompt 模板
A professional recruitment poster for {公司名/岗位}.
Main elements: {公司元素}, {岗位相关图标}, {团队场景暗示}.
Background: dark tech gradient with glowing accents.
Foreground decorations: {技能标签}, {福利图标}, geometric patterns.
Color scheme: deep blue + neon blue + white.
Title in Chinese: "{招聘标题}"
Subtitle in Chinese: "{岗位/要求}"
Bottom tagline in Chinese: "{行动号召/投递方式}"
Tech futuristic style, dark blue gradient background, glowing neon blue accents,
clean sans-serif typography, clear legible sharp Chinese text.
No watermark, no logo, clean image.
12. 企业文化海报
触发词: "团建"、"企业文化"、"价值观"
推荐尺寸: 1536x1024
默认风格: 插画风
默认模型: custom-textmodel-gt
Prompt 模板
A corporate culture poster about {文化主题}.
Main elements: {团队活动场景}, {价值观关键词视觉化}, {人物剪影}.
Background: warm {浅色} background with soft texture.
Foreground decorations: {装饰图标}, {植物/几何元素}, quote bubbles.
Color scheme: {温暖主色} + {辅助色} + white.
Title in Chinese: "{文化标题}"
Subtitle in Chinese: "{价值观描述}"
Bottom tagline in Chinese: "{企业标语}"
Flat vector illustration style, bold flat colors, friendly characters,
modern illustration, clear legible sharp Chinese text.
No watermark, no logo, clean image.
13. 金融/投资分析图
触发词: "投资分析"、"基金推荐"、"理财海报"
推荐尺寸: 1024x1536
默认风格: 杂志编辑风
默认模型: custom-textmodel-gt
Prompt 模板
A professional financial analysis infographic about {金融主题}.
Main elements: {数据图表元素1, 图表2}, {金融图标}, {市场趋势可视化}.
Background: clean light background with structured layout.
Foreground decorations: {数据标注}, {趋势箭头}, {图标}.
Color scheme: navy blue + gold + white + red/green accents.
Title in Chinese: "{分析标题}"
Subtitle in Chinese: "{副标题/时间范围}"
Data labels in Chinese: "{数据点1}", "{数据点2}"
Disclaimer in Chinese: "{风险提示}"
Magazine editorial style, sophisticated layout, professional financial publication quality,
clear legible sharp Chinese text.
No watermark, no logo, clean image.
14. 餐饮/美食/菜单
触发词: "美食海报"、"菜品图"、"餐厅推广"
推荐尺寸: 1024x1024
默认风格: 日系清新
默认模型: custom-textmodel-gt
Prompt 模板
An appetizing food marketing poster for {餐厅/菜品名}.
Main elements: {菜品主体} beautifully plated, {食材展示}, {餐具/环境}.
Background: soft natural lighting, {浅色木质/石材} texture background.
Foreground decorations: {食材装饰}, {酱料/点缀}, fresh herbs.
Color scheme: warm natural tones, {主色} + cream + green accent.
Title in Chinese: "{菜品/餐厅标题}"
Subtitle in Chinese: "{菜品描述/特色}"
Bottom tagline in Chinese: "{价格/促销信息}"
Japanese fresh airy style, soft natural lighting, high-key lighting,
clean and bright atmosphere, clear legible sharp Chinese text.
No watermark, no logo, clean image.
15. 教育/培训海报
触发词: "公开课"、"招生"、"培训海报"
推荐尺寸: 1024x1536
默认风格: 扁平化插画
默认模型: custom-textmodel-gt
Prompt 模板
An educational training poster for {课程/培训名}.
Main elements: {课程主题图标}, {学习场景}, {知识可视化元素}.
Background: clean {浅色} background with geometric patterns.
Foreground decorations: {书本/铅笔图标}, {知识标签}, {进度条}.
Color scheme: {活力主色} + {辅助色} + white.
Title in Chinese: "{课程标题}"
Subtitle in Chinese: "{课程信息/时间}"
Bottom tagline in Chinese: "{报名方式/行动号召}"
Flat vector illustration style, bold flat colors, friendly characters,
modern illustration, clear legible sharp Chinese text.
No watermark, no logo, clean image.
16. 医疗健康科普
触发词: "健康科普"、"医疗海报"、"养生"
推荐尺寸: 1024x1536
默认风格: 扁平化插画
默认模型: custom-textmodel-gt
Prompt 模板
A health education infographic about {健康主题}.
Main elements: {人体器官/系统图示}, {健康习惯图标}, {数据可视化}.
Background: clean light background with medical cross patterns.
Foreground decorations: {医疗图标}, {健康标签}, {箭头/连接线}.
Color scheme: medical blue + green + white + warm accent.
Title in Chinese: "{健康标题}"
Section labels in Chinese: "{知识点1}", "{知识点2}"
Bottom tagline in Chinese: "{健康提示}"
Flat vector illustration style, clean and professional,
medical-friendly aesthetic, clear legible sharp Chinese text.
No watermark, no logo, clean image.
17. 房产/家居装饰
触发词: "房产海报"、"楼盘宣传"、"家居图"
推荐尺寸: 1536x1024
默认风格: 极简主义
默认模型: custom-textmodel-gt
Prompt 模板
A premium real estate marketing poster for {楼盘/项目名}.
Main elements: {建筑外观}, {室内场景}, {景观环境}.
Background: {天空/自然环境} with atmospheric depth.
Foreground decorations: {园林/水景}, {生活场景暗示}, soft shadows.
Color scheme: {建筑主色} + warm tones + natural green.
Title in Chinese: "{项目标题}"
Subtitle in Chinese: "{项目定位/卖点}"
Bottom tagline in Chinese: "{价格/联系方式}"
Minimalist design, clean composition, premium real estate aesthetic,
architectural photography quality, clear legible sharp Chinese text.
No watermark, no logo, clean image.
18. 汽车/出行
触发词: "汽车海报"、"出行宣传"
推荐尺寸: 1536x1024
默认风格: 科技感
默认模型: custom-textmodel-gt
Prompt 模板
A dynamic automotive marketing poster for {车型/品牌}.
Main elements: {汽车主体} in dynamic angle, {道路/环境}, {速度感元素}.
Background: {城市/公路/自然} with motion blur effect.
Foreground decorations: {光影效果}, {科技元素}, {性能标签}.
Color scheme: {品牌色} + dark background + neon accents.
Title in Chinese: "{车型标题}"
Subtitle in Chinese: "{核心卖点}"
Bottom tagline in Chinese: "{价格/行动号召}"
Tech futuristic style, dynamic composition, automotive photography quality,
clear legible sharp Chinese text.
No watermark, no logo, clean image.
19. 时尚/穿搭
触发词: "时尚海报"、"穿搭推荐"
推荐尺寸: 1024x1536
默认风格: 杂志编辑风
默认模型: custom-textmodel-gt
Prompt 模板
A fashion editorial poster about {时尚主题}.
Main elements: {时尚单品1, 单品2, 单品3} in editorial composition.
Background: {高级感背景} with professional color grading.
Foreground decorations: {配饰}, {纹理/材质细节}, elegant typography.
Color scheme: {季节色} + neutral tones + accent color.
Title in Chinese: "{时尚标题}"
Subtitle in Chinese: "{穿搭建议}"
Bottom tagline in Chinese: "{品牌/系列}"
Magazine editorial style, sophisticated layout, high fashion aesthetic,
professional photography quality, clear legible sharp Chinese text.
No watermark, no logo, clean image.
20. 公益/社会责任
触发词: "公益海报"、"环保宣传"
推荐尺寸: 1024x1536
默认风格: 手绘水彩
默认模型: custom-textmodel-gt
Prompt 模板
A public service announcement poster about {公益主题}.
Main elements: {主题核心视觉}, {自然/人物元素}, {情感场景}.
Background: {自然/温暖} background with soft texture.
Foreground decorations: {自然元素}, {象征性图标}, gentle illustrations.
Color scheme: {自然色调} + warm tones + white.
Title in Chinese: "{公益标题}"
Subtitle in Chinese: "{行动号召}"
Bottom tagline in Chinese: "{组织/口号}"
Hand-drawn watercolor style, soft watercolor washes, warm and inviting feel,
clear legible sharp Chinese text.
No watermark, no logo, clean image.
图生图场景补充模板
风格迁移模板(gpt-image-2)
Transform to {目标风格} style. Keep the person, text and layout identical.
Change: {具体变更内容,如 colors to X, background to Y}.
Same professional design style and layout as reference image.
创意编辑模板(custom-imagemodel-gt)
{编辑指令},例如:
- Replace the background with {新背景描述}
- Add {新元素} to the image
- Remove {要去除的元素} from the image
- Change the color scheme to {新配色}
第四部分:API 参考文档(hanis-image-mcp)
> 本文档供 Skill 内部参考,完整记录 hanis-image-mcp 服务的 API 规范。
服务信息
| 项目 | 值 |
|---|---|
| 服务名称 | Hanis Image MCP |
| 生产地址 | https://hanis-image-mcp-288810-10-1426987343.sh.run.tcloudbase.com |
| MCP 端点 | /mcp |
| 协议 | MCP Streamable HTTP (JSON-RPC 2.0 + SSE) |
| 工具数量 | 3 个 |
| 支持模型 | 8 种(GPT-Image / Grok / Gemini / 腾讯定制) |
鉴权
所有 MCP 工具调用必须提供 API Key,三选一:
| 方式 | 格式 | 优先级 |
|---|---|---|
| Authorization Header | Authorization: Bearer <key> |
推荐 |
| X-API-Key Header | X-API-Key: <key> |
备选 |
| 工具参数 | arguments.access_key: "<key>" |
兼容模式 |
> 通过 WorkBuddy MCP 连接器调用时,API Key 由连接器自动管理,无需手动传入。
模型速查
| 模型 ID | 文生图 | 图生图 | 返回 | 速度 | 关键特性 |
|---|---|---|---|---|---|
custom-textmodel-gt ⭐ |
✅ | ✅ | URL | ~15-25s | 默认文生图 |
custom-imagemodel-gt ⭐ |
❌ | ✅ | URL | ~27-31s | 默认图生图,⚠️ 会重新生成人物/内容 |
gpt-image-1 |
✅ | ✅ | base64 | ~25-40s | 支持透明背景 |
gpt-image-2 🎯 |
✅ | ✅ | base64 | ~40-70s | 风格迁移首选,内容保持最优 |
grok-imagine |
✅ | ❌ | URL | 快 | xAI 快速模型 |
grok-imagine-image |
✅ | ❌ | URL | 中等 | Grok 变体 |
grok-imagine-image-quality |
✅ | ❌ | URL | 较慢 | Grok 高质量 |
gemini-3.1-flash-image |
✅ | ❌ | URL | 中等 | Google Gemini |
模型选择决策表
用户意图 → 模型
──────────────────────────────────────────────────────
"帮我画一张..." → custom-textmodel-gt(默认)
"把这张图换成XX风格,人物/文字不变" → gpt-image-2 🎯
"换一下背景/加个元素" → custom-imagemodel-gt
"需要透明背景的图" → gpt-image-1 / gpt-image-2
"快速预览效果" → gpt-image-1
"高质量成品输出" → gpt-image-2
> ⚠️ 致命陷阱:custom-imagemodel-gt 图生图时会重新生成人物和内容,完全改变原图。如果用户要求"换风格但保持人物不变",必须用 gpt-image-2,否则结果与原图完全无关。
工具 1:generate_image — 文生图
根据文本描述生成图片。
参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
prompt |
string | ✅ | — | 图片描述,最大 32000 字符 |
model |
string | 否 | custom-textmodel-gt |
仅支持文生图模型 |
size |
string | 否 | 1024x1024 |
auto / 1024x1024 / 1536x1024 / 1024x1536 |
n |
integer | 否 | 1 |
生成数量 1-10 |
quality |
string | 否 | auto |
auto / high / medium / low |
background |
string | 否 | auto |
auto / opaque / transparent(transparent 仅 gpt-image-1) |
output_format |
string | 否 | png |
png / jpeg / webp |
output_compression |
integer | 否 | — | 0-100(仅 jpeg) |
logo_add |
integer | 否 | 0 |
AI 标识:0=不加, 1=加 |
调用示例
{
"prompt": "一只在花丛中飞舞的蝴蝶,中国水墨画风格",
"model": "custom-textmodel-gt",
"size": "1024x1024",
"n": 1
}
工具 2:edit_image — 图生图
基于参考图片进行编辑或风格迁移。
参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
image_url |
string | 三选一 | — | 单张图片 HTTPS URL |
image_urls |
string[] | 三选一 | — | 多张图片 URL(1-16) |
image_base64_data_url |
string | 三选一 | — | base64 Data URL,格式 data:image/{jpeg\|png\|webp};base64,... |
mask_image_url |
string | 否 | — | 遮罩图 URL(PNG,透明=编辑区) |
prompt |
string | 否* | — | 编辑指令(GPT 模型推荐填写) |
model |
string | 否 | custom-imagemodel-gt |
仅图生图模型 |
size |
string | 否 | 1024x1024 |
输出尺寸 |
n |
integer | 否 | 1 |
1-10 |
quality |
string | 否 | auto |
auto / high / medium / low |
background |
string | 否 | auto |
auto / opaque / transparent |
output_format |
string | 否 | png |
png / jpeg |
output_compression |
integer | 否 | — | 0-100 |
response_format |
string | 否 | url |
url / b64_json(仅 custom-imagemodel-gt) |
input_fidelity |
string | 否 | — | high / low(仅 custom-imagemodel-gt) |
logo_add |
integer | 否 | 0 |
AI 标识 |
场景 A:风格迁移(保持内容不变)— 用 gpt-image-2
用户: "把这张课程海报换成极简杂志风格,人物和文字不变"
{
"model": "gpt-image-2",
"image_url": "https://example.com/poster.jpg",
"prompt": "Transform to premium minimal magazine style. Keep the person, text and layout identical. Change: colors to black/white/gray with gold accents, background to clean white.",
"size": "1024x1024",
"n": 1
}
场景 B:创意编辑(换背景/加元素)— 用 custom-imagemodel-gt
用户: "把这张照片的背景换成海滩日落"
{
"model": "custom-imagemodel-gt",
"image_url": "https://example.com/photo.jpg",
"prompt": "Replace the background with a beach at sunset",
"input_fidelity": "high"
}
场景 C:本地/base64 图片
{
"model": "gpt-image-2",
"image_base64_data_url": "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
"prompt": "Add a golden hour lighting effect"
}
图传方式对比
| 方式 | 速度 | 场景 |
|---|---|---|
image_url |
最快 | 公网图片,推荐优先使用 |
image_base64_data_url |
较慢 | 本地/私密图片 |
工具 3:list_image_models — 模型列表
查询可用模型及其能力。
参数
无必填参数(可选 access_key 兼容模式)。
调用示例
{
"name": "list_image_models",
"arguments": {}
}
响应包含 models[] 数组、text_to_image_model_ids[]、image_to_image_model_ids[] 和 defaults。
响应结构
统一成功响应
{
success: true,
request_id: string, // UUID 追踪
mode: "text-to-image" | "image-to-image",
model: string, // 实际使用的模型
size: string, // 输出尺寸
count: number, // 图片数量
images: ImageItem[], // 图片数组
warnings: string[] // 非致命告警
}
ImageItem 三种格式
// URL 格式(有效期约 1 小时)
{ index: number, kind: "url", url: string }
// Base64 格式(GPT 模型,直接解码保存)
{ index: number, kind: "base64", mime_type: string, base64: string, byte_length: number }
// 空结果(生成失败但不算错误)
{ index: number, kind: "empty", warning: string }
错误响应
{
success: false,
request_id: string,
error: {
code: string, // 错误码
message: string, // 人类可读
retryable: boolean // 可否重试
}
}
错误处理决策表
| 错误码 | 含义 | Agent 行动 |
|---|---|---|
UNAUTHORIZED |
Key 无效 | 提示用户检查配置,不重试 |
INVALID_ARGUMENT |
参数错误 | 提示修正(如缩短 prompt),不重试 |
INVALID_IMAGE_URL |
图片 URL 不可访问 | 提示检查 URL 或改用 base64,不重试 |
IMAGE_DOWNLOAD_BLOCKED |
SSRF 拦截 | 确认 URL 合法,不重试 |
UPSTREAM_ERROR |
上游服务报错 | 等 3s 重试 1 次 |
UPSTREAM_UNAVAILABLE |
上游不可用 | 等 10s 重试 1 次 |
UPSTREAM_TIMEOUT |
上游超时 | 提示"生成超时,请重试",可重试 |
UPSTREAM_INVALID_RESPONSE |
响应异常 | 提示"服务异常,尝试换模型",不重试 |
RATE_LIMITED |
限流 | 等 60s 自动重试 |
超时配置
不同模型建议的超时时间:
| 模型 | 1024x1024 | 2048x2048+ |
|---|---|---|
custom-textmodel-gt |
60s | 180s |
custom-imagemodel-gt |
90s | 180s |
gpt-image-1 |
60s | 120s |
gpt-image-2 |
120s | 300s |
| 全模型兜底 | 480s(8 分钟) | — |
实战要点
1. 风格迁移必须用 gpt-image-2
❌ 错误:edit_image(model="custom-imagemodel-gt", prompt="换风格,保持人物不变")
→ 人物、文字、排版全部变了
✅ 正确:edit_image(model="gpt-image-2", prompt="Transform to X style. Keep person and content identical.")
→ 人物内容不变,只换风格
2. prompt 语言策略
- GPT 模型(gpt-image-1/2):英文 prompt 效果更好
- 腾讯模型(custom-*-gt):中英文均可
- 风格迁移推荐英文 prompt,关键词加
Keep the person/text/layout identical
3. 图传优先级
URL 直传 > base64 直传。URL 方式速度快,且保真度更高。base64 会增加 ~33% 传输体积。
4. URL 有效期
返回的图片 URL 有约 1 小时有效期。如需长期使用,应下载保存。
5. 正确解析 SSE 响应
Agent → POST /mcp → 收到 SSE 流
1. 按行读取,过滤 "data:" 前缀
2. 解析 JSON
3. 取 result.structuredContent(不是 result.content[0].text)
4. 遍历 images[],按 kind 处理 url/base64/empty
> 通过 DeferExecuteTool 调用时,SSE 解析已由 MCP 连接器自动完成。