节日创意生成-万维易源

概述

节日创意生成

任务目标

• 根据用户自然语言需求与指定节日，一键生成包含实际文字渲染的节日创意图片
• 具备合规校验优化、节日创意意图解析、极简文案生成、生图提示词构建、高清图片生成、状态轮询能力
• 触发场景：节日贺卡制作、社交媒体节日配图、电商节日营销素材、创意海报生成（new_media_content / ecommerce_marketing）

能力组成

能力流程描述

该技能由 6 个串行步骤组成，从用户输入到最终图片输出的完整链路如下：

1. 合规校验优化（prompt_guardian）：对用户输入的需求文本进行合规性校验与优化，过滤不合规内容，保障后续生成内容安全可靠。
2. 解析节日创意意图（creative_intent_analyzer）：结合用户需求（prompt）与指定节日（holiday），解析出创意主题、核心实体（entities）与语义结构中的核心主题（core_theme），形成结构化创意分析结果。
3. 生成极简图片文案（image_text_copywriter）：基于创意主题与目标受众（取自用户需求描述），生成一句简短、适合直接排版进图片的极简文案。
4. 构建融合文案的生图提示词（image_prompt_composer）：将极简文案、创意主题、核心元素、视觉风格与图片比例融合，生成专业的英文生图提示词。
5. 启动高清图片生成任务（3373）：使用生图提示词与指定图片比例，启动高清图片生成任务，获取生成任务地址。
6. 轮询图片生成状态（polling）：以 5 秒间隔轮询图片生成状态（最长 1200 秒），直至任务状态为 SUCCEEDED。

数据流转方式：前序步骤的结构化结果（意图分析 → 极简文案 → 生图提示词）逐级向下传递，图片生成任务的结果 URL 经轮询确认成功后作为最终输出 image_url。全链路由系统自动串联执行，用户仅需提供需求描述，中间环节无需人工干预。

技能能力组成流程图

flowchart TD
    A["用户输入<br/>prompt: 需求描述(必填)<br/>holiday: 指定节日(选填)<br/>aspect_ratio: 图片比例(选填)"] --> B["step_0 合规校验优化<br/>(prompt_guardian)"]
    B --> C["step_1 解析节日创意意图<br/>(creative_intent_analyzer)<br/>输出: 创意主题/核心实体/核心主题"]
    C --> D["step_2 生成极简图片文案<br/>(image_text_copywriter)"]
    D --> E["step_3 构建融合文案的生图提示词<br/>(image_prompt_composer)"]
    E --> F["step_4 启动高清图片生成任务<br/>(3373)"]
    F --> G["step_5 轮询图片生成状态<br/>(polling: 间隔5s / 超时1200s)"]
    G -->|"task_status === 'SUCCEEDED'"| H["最终输出<br/>image_url: 节日创意图片URL"]
    G -->|未完成| G

官方流程图快照：

前置准备

• 凭证：配置 ShowAPI AppKey，凭证名称：showapi_appkey
• 鉴权配置：

本 Skill 调用需要 AppKey 鉴权。所有 API 请求的 URL 查询参数中需携带 appKey={你的AppKey}。

如何获取 AppKey

如果你还没有 AppKey，请按以下步骤通过手机验证获取：

1. 请用户提供手机号（中国大陆手机号）
2. 调用发送验证码接口：

“` POST https://www.showapi.com/auth/agent_sendCode Content-Type: application/x-www-form-urlencoded

phone={手机号} “ 成功响应：{"flag":true,"remark":"发送成功"}`

1. 请用户查看手机收到的6位验证码并告诉你
2. 调用验证接口获取 AppKey：

“` POST https://www.showapi.com/auth/agent_verify Content-Type: application/x-www-form-urlencoded

phone={手机号}&code={验证码} “ 成功响应：{"flag":true,"app_key":"你的AppKey"}`

1. 将获取到的 app_key 保存，后续所有 API 调用 URL 中携带 appKey={app_key} 参数

注意事项

• 验证码5分钟有效，每分钟只能发送1次
• 如果手机号已注册过易源数据平台账户，会直接返回该账户的 AppKey，不会重复注册
• AppKey 获取后请妥善保存，避免重复验证
• 模拟体验：无 appKey 时，系统自动触发模拟调用，直接返回完整结果，快速预览生成效果
• 依赖：仅使用 Python 标准库，无需安装第三方包

操作步骤

模拟体验流程（无 appKey）

1. 自动触发模拟调用

系统检测到未配置 appKey 时，自动向 https://www.showapi.com/_nuxt3/api/2405-105 发送 POST 请求（body: {"flow_id":"6ab215eb3c51f2596c00867a"}），直接获取完整模拟生成结果。此过程为一次性返回，不执行 execute_task.py 和 query_task.py。

1. 可视化预览

将返回的 JSON 结果以 HTML 形式可视化展示，重点呈现图片内容。

1. 引导真实调用

提示用户当前为无 appKey 的模拟运行结果。如需真实调用，请通过手机验证获取 AppKey（步骤见「前置准备-鉴权配置」），并在后续所有 API 调用 URL 中携带 appKey={app_key} 参数。

标准流程（有 appKey，强制异步执行）

1. 收集用户需求

梳理用户的创意需求描述（prompt，必填），确认是否指定节日（holiday，选填，未指定则留空由模型自动判断）与图片比例（aspect_ratio，选填，默认 1:1）。

1. 异步提交生成任务

调用脚本异步执行节日创意图片生成任务，仅返回唯一 task_id，不阻塞等待。调用示例：

   python scripts/execute_task.py --prompt "给妈妈做一张母亲节卡片，她喜欢温馨的花卉风格。主画面用康乃馨和暖色光晕，配色奶油色 + 淡粉。文案想表达：谢谢您操劳这么多年，现在换我来照顾您。用一句简短的话呈现，不要太长" --holiday "母亲节" --aspect-ratio 1:1 --async

1. 轮询查询任务结果（必选）

使用 task_id 循环查询任务状态，每一轮轮询后，即时将当前返回的核心资料同步反馈给用户，直至获取完整结果。调用示例：

   python scripts/query_task.py --task-id "返回的task_id值"

1. 等待结果完成

必须轮询直到完成。

1. 结果解析与落地应用

提取输出的 image_url 图片链接，可直接下载或嵌入贺卡、社媒帖子、营销素材中使用。

1. 生成 HTML 页面

生成一个简单的 HTML 页面来融合返回的主要信息，特别是图片。

使用示例

示例1：母亲节贺卡生成

• 输入：给妈妈做一张母亲节卡片，温馨花卉风格，主画面康乃馨 + 暖色光晕，奶油色 + 淡粉配色，文案"谢谢您操劳这么多年，现在换我来照顾您"
• 流程：异步提交任务 → 获取 task_id → 轮询查询（每轮反馈进度/数据）
• 产出：包含实际文字渲染的母亲节创意卡片图片 URL
• 配置要点：holiday="母亲节"，aspect_ratio=1:1

示例2：电商节日营销配图

• 输入：为电商大促活动生成节日氛围营销海报配图
• 流程：异步提交任务 → 获取 task_id → 轮询查询（每轮反馈进度/数据）
• 产出：适配电商主图/详情页的节日创意图片
• 配置要点：按投放位置选择比例，主图 1:1，详情页 3:4 或 4:3

示例3：社交媒体节日祝福图

• 输入：批量制作社交媒体节日祝福配图
• 流程：异步提交任务 → 获取 task_id → 轮询查询（每轮反馈进度/数据）
• 产出：适配社媒平台的竖版/横版节日祝福图片
• 配置要点：朋友圈/短视频封面可选 9:16 或 3:4，横版场景选 16:9

生成效果示例

描述

技能运行完成后，返回 image_url 字段，指向最终生成的节日创意图片。输出特点：

• 实际文字渲染：极简排版的短文案已直接渲染在图片中，无需二次加工
• 融合视觉风格：画面元素、配色与构图均依据意图解析出的核心实体与核心主题生成
• 指定比例输出：图片按用户指定的宽高比生成（1:1、3:4、4:3、16:9、9:16）

典型输出为单张高清创意图片，可直接下载或嵌入贺卡、社媒、营销素材使用。

输出案例

说明：若输出结果包含图片，优先插入对应图片资源，之后再输出 JSON / Markdown 格式的文本内容。

以下为该技能的历史生成效果示例图：

接口返回的实际 JSON 形态（任务查询完成后）：

{
  "showapi_res_body": {
    "image_url": "https://oss.showapi.com/workflow/output/6ab215eb3c51f2596c00867a/holiday_card_mothers_day_result.png"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

资源索引

• [scripts/execute_task.py](scripts/execute_task.py)：异步提交节日创意图片生成任务（真实调用时使用）
• [scripts/query_task.py](scripts/query_task.py)：轮询查询异步任务结果（真实调用时使用）

响应数据结构

1. 异步任务提交响应

{
  "showapi_res_body": {
    "task_id": "唯一任务ID",
    "status": "pending",
    "msg": "任务已提交，正在异步处理中"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

2. 任务查询响应（单轮轮询返回数据，需实时同步给用户）

{
  "showapi_res_body": {
    "image_url": "生成的节日创意图片URL（包含实际文字渲染，可直接访问下载）"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

注意事项

1. prompt 为必填项，需清晰描述创意需求（画面风格、配色、想表达的文案等），描述越具体生成效果越好。
2. holiday 为选填项，未指定时系统将根据需求描述自动判断节日主题。
3. 所有任务强制异步执行，不支持同步模式。
4. 图片生成耗时较长（轮询上限 1200 秒、间隔 5 秒），每次获取接口返回数据后，立即将主要内容反馈给用户，耐心等待直至任务完成。
5. 输出的 image_url 已包含实际渲染的文案文字，如需修改文案，请调整 prompt 后重新生成。
6. 计费说明：实际计费按输出内容消耗 token 数量有所浮动。
7. 模拟运行说明：无 appKey 时系统自动触发模拟调用，一次性返回完整 JSON 结果，不经过 execute_task.py 和 query_task.py，结果仅作效果预览，非真实生成内容。如需真实调用，请通过手机验证获取 AppKey 并配置。