Agent Skill

婚礼请柬生成-万维易源

根据结婚照与婚礼信息,自动分析视觉风格、设计请柬文案排版,融合生成高质量个性化婚礼请柬图片;适用于婚礼请柬制作、婚庆创意设计、个性化邀请函定制、婚礼筹备场景

设计多媒体·万维易源·来自 skill_hub·skillhub.cn ↗
skillhub install @showapi/wedding-invitation-generation-showapi
1 Stars·6.3万 综合热度·5,059 字文档·源站更新 2026-11-22

README 文档

5,059 字

AI婚礼请柬生成

任务目标

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

能力组成

能力流程描述

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

  1. 合规校验优化(prompt_guardian):对用户输入的新人姓名、婚期、地点等文案内容进行合规校验与优化,保障生成内容安全合规。
  2. 结婚照视觉风格分析(weddingphotoanalyze):深度分析结婚照的视觉风格,输出整体风格(中式/西式/现代/可爱/复古等)、色调倾向(暖色/冷色/莫兰迪/高饱和等)、情感氛围(浪漫/温馨/活泼/庄重等)、画面构图特征,并给出适合的请柬设计方向建议,形成结构化分析结果。
  3. 请柬文案与排版设计(invitationtextlayout):根据婚礼日期、婚礼时间、婚礼地点、新郎新娘姓名,设计请柬文案(formattedtext)与排版方案(layoutdesign)。
  4. 请柬生图提示词融合生成(invitationimageprompt):将结婚照分析出的风格/色调/氛围、用户指定风格(style,不填或为空则采用照片分析结果)、画面比例要求与请柬排版设计融合,生成最终的生图提示词(prompt)。此步骤依赖步骤2与步骤3的结果。
  5. 启动请柬图片生成任务(3373):以结婚照为参考图,按指定画面比例(ratio)与融合提示词,异步启动请柬图片生成任务,返回生图任务ID(taskid)与结果地址(resulturl)。
  6. 轮询请柬图片生成状态(polling):以6秒为间隔轮询任务状态,最长等待1500秒,直至任务状态为 SUCCEEDED,输出最终婚礼请柬图片URL(invitationimageurl)与生图任务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. 将获取到的 appkey 保存,后续所有 API 调用 URL 中携带 appKey={appkey} 参数

注意事项

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

操作步骤

模拟体验流程(无 appKey)

  1. 自动触发模拟调用

系统检测到未配置 appKey 时,自动向 https://www.showapi.com/nuxt3/api/2405-105 发送 POST 请求(body: {"flowid":"6a7d861d3c51f28a6f002f6a"}),直接获取完整模拟生成结果。此过程为一次性返回,不执行 executetask.py 和 querytask.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(invitationimageurl)与生图任务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,依据投放渠道选择

生成效果示例

描述

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

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

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

输出案例

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

生成效果示例图:

婚礼请柬示例1

婚礼请柬示例2

婚礼请柬示例3

接口返回 JSON 实际形态:

{
  "showapi_res_body": {
    "invitation_image_url": "最终生成的婚礼请柬高清图片访问地址",
    "task_id": "生图任务唯一标识"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

资源索引

  • scripts/execute_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. imgurl、groom、bride、weddingdate、weddingvenue 为必填项;weddingtime、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 结果,不经过 executetask.py 和 querytask.py,结果仅作效果预览,非真实生成内容。如需真实调用,请通过手机验证获取 AppKey 并配置。

同分类其他技能

查看全部 ›