婚礼请柬生成-万维易源

概述

AI婚礼请柬生成

任务目标

• 根据用户上传的结婚照和婚礼信息，一键生成高质量个性化婚礼请柬图片
• 具备合规校验、结婚照视觉风格分析、请柬文案排版设计、生图提示词融合、异步图片生成与轮询取图能力
• 触发场景：婚礼请柬制作、婚庆创意设计、个性化邀请函定制、婚礼筹备

能力组成

能力流程描述

该技能由 6 个环节串行协作完成，完整链路如下：

1. 合规校验优化（prompt_guardian）：对用户输入的新人姓名、婚期、地点等文案内容进行合规校验与优化，保障生成内容安全合规。
2. 结婚照视觉风格分析（wedding_photo_analyze）：深度分析结婚照的视觉风格，输出整体风格（中式/西式/现代/可爱/复古等）、色调倾向（暖色/冷色/莫兰迪/高饱和等）、情感氛围（浪漫/温馨/活泼/庄重等）、画面构图特征，并给出适合的请柬设计方向建议，形成结构化分析结果。
3. 请柬文案与排版设计（invitation_text_layout）：根据婚礼日期、婚礼时间、婚礼地点、新郎新娘姓名，设计请柬文案（formatted_text）与排版方案（layout_design）。
4. 请柬生图提示词融合生成（invitation_image_prompt）：将结婚照分析出的风格/色调/氛围、用户指定风格（style，不填或为空则采用照片分析结果）、画面比例要求与请柬排版设计融合，生成最终的生图提示词（prompt）。此步骤依赖步骤2与步骤3的结果。
5. 启动请柬图片生成任务（3373）：以结婚照为参考图，按指定画面比例（ratio）与融合提示词，异步启动请柬图片生成任务，返回生图任务ID（task_id）与结果地址（result_url）。
6. 轮询请柬图片生成状态（polling）：以6秒为间隔轮询任务状态，最长等待1500秒，直至任务状态为 SUCCEEDED，输出最终婚礼请柬图片URL（invitation_image_url）与生图任务ID（task_id）。

数据流转：用户输入（结婚照URL、新人姓名、婚期、地点、可选风格与比例）→ 合规校验 → 风格分析与文案排版并行处理 → 提示词融合 → 异步生图 → 轮询取图 → 输出请柬图片。人机协作节点：启动前由用户提供结婚照与婚礼信息；生成过程中通过轮询查询逐轮获取进度并反馈给用户。

技能能力组成流程图

flowchart TD
    A[用户输入: img_url/groom/bride/wedding_date/wedding_venue/wedding_time/style/ratio] --> B[step_0 合规校验优化 prompt_guardian]
    B --> C[step_1 结婚照视觉风格分析 wedding_photo_analyze]
    B --> D[step_2 请柬文案与排版设计 invitation_text_layout]
    C --> E[step_3 请柬生图提示词融合生成 invitation_image_prompt]
    D --> E
    E --> F[step_4 启动请柬图片生成任务 3373 异步返回 task_id]
    F --> G{step_5 轮询生成状态 polling}
    G -- 未完成, 每6秒重试, 最长1500秒 --> G
    G -- task_status === SUCCEEDED --> H[输出: invitation_image_url + task_id]

前置准备

• 凭证：配置 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":"6a7d861d3c51f28a6f002f6a"}），直接获取完整模拟生成结果。此过程为一次性返回，不执行 execute_task.py 和 query_task.py。

1. 可视化预览

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

1. 引导真实调用

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

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

1. 收集用户需求

收集结婚照图片URL、新郎姓名、新娘姓名、婚礼日期、婚礼地点（均必填），以及婚礼时间、请柬风格、画面比例（选填），确认信息完整无误。

1. 异步提交生成任务

调用脚本异步执行风格分析、文案排版、提示词融合与请柬图片生成任务，仅返回唯一 task_id，不阻塞等待。调用示例：

   python scripts/execute_task.py --img-url "结婚照图片URL" --groom "张三" --bride "李四" --wedding-date "2026年8月29日（周六）" --wedding-venue "洛克酒店海棠厅" --wedding-time "18:00" --style "可爱" --ratio "9:16"

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

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

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

1. 等待结果完成

必须轮询直到完成（任务完成状态为 SUCCEEDED，参考节奏为间隔6秒轮询一次、最长等待1500秒）。

1. 结果解析与落地应用

提取请柬图片URL（invitation_image_url）与生图任务ID（task_id），可将请柬图片下载、分享给新人确认或用于电子请柬分发。

1. 生成html页面

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

使用示例

示例1：标准婚礼请柬生成

• 输入：结婚照URL + 张三/李四 + 2026年8月29日（周六）+ 洛克酒店海棠厅
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：与结婚照视觉风格一致的个性化婚礼请柬图片
• 配置要点：ratio 默认 9:16，适合手机端查看与朋友圈分享

示例2：指定风格请柬定制

• 输入：结婚照URL + 婚礼信息 + style="中式"
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：融合用户指定风格与照片分析结果的请柬
• 配置要点：style 不填或为空则自动采用结婚照分析结果；填入则覆盖分析结论

示例3：横版电子请柬

• 输入：结婚照URL + 婚礼信息 + ratio="16:9"
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：横版排版的婚礼请柬图片
• 配置要点：ratio 可选 1:1, 3:4, 4:3, 16:9, 9:16，依据投放渠道选择

生成效果示例

描述

技能运行后输出两项核心结果：

• invitation_image_url（婚礼请柬图片）：最终生成的婚礼请柬高清图片访问地址。图片融合了结婚照的视觉风格（整体风格/色调倾向/情感氛围）、新人姓名、婚礼日期时间、婚礼地点等文案与排版设计，可直接用于电子请柬分发或印刷。
• task_id（生图任务ID）：异步图片生成任务的唯一标识，可用于追溯和查询。

可视化呈现方式：可将请柬图片直接展示，或生成 HTML 页面融合请柬图片与婚礼文案信息进行展示。

输出案例

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

生成效果示例图：

接口返回 JSON 实际形态：

{
  "showapi_res_body": {
    "invitation_image_url": "最终生成的婚礼请柬高清图片访问地址",
    "task_id": "生图任务唯一标识"
  },
  "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": {
    "task_id": "生图任务唯一标识",
    "invitation_image_url": "最终生成的婚礼请柬高清图片访问地址",
    "task_status": "SUCCEEDED"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

注意事项

1. img_url、groom、bride、wedding_date、wedding_venue 为必填项；wedding_time、style、ratio 为选填项。
2. style 不填或为空时，自动采用结婚照视觉风格分析的结果。
3. ratio 可选值：1:1, 3:4, 4:3, 16:9, 9:16，默认 9:16。
4. 所有任务强制异步执行，图片生成需轮询等待，参考节奏为间隔6秒轮询一次、最长等待1500秒。
5. 轮询查询过程中，每次获取接口返回数据后，立即将主要内容反馈给用户。
6. 预估费用约 0.22 元/次（含模型推理价格）。
7. 模拟运行说明：无 appKey 时系统自动触发模拟调用，一次性返回完整 JSON 结果，不经过 execute_task.py 和 query_task.py，结果仅作效果预览，非真实生成内容。如需真实调用，请通过手机验证获取 AppKey 并配置。