前言¶
婚礼请柬既要带上新人照片的视觉气质，又要把日期、地点、姓名排得得体，还要兼顾竖版朋友圈和横版大屏等不同比例。手工套模板往往风格与照片脱节；纯文生图又容易漏字段或版式不稳。若希望 Agent 在对话里按结构化输入走完合规、分析、排版与出图，可以把 SkillHub 上的企业技能 婚礼请柬生成-万维易源（@showapi/wedding-invitation-generation-showapi）装进当前 Agent，由万维易源维护的 ShowAPI 工作流承接后端能力。
这是什么¶
婚礼请柬生成-万维易源 是 SkillHub 分类 design-media 下的企业来源（enterprise）技能，当前版本 1.0.2，发布者为 万维易源。官方页面标注 requires_api_key=true，调用 ShowAPI 需配置 AppKey。
一句话定位：根据结婚照与婚礼信息，自动分析视觉风格、设计请柬文案排版，融合生成高质量个性化婚礼请柬图片。适用场景包括婚礼请柬制作、婚庆创意设计、个性化邀请函定制与婚礼筹备。
在 SkillHub 上该技能评分为 100000，下载 33398 次（页面统计，截至资料抓取时）。
核心功能¶
技能 SKILL.md 将链路拆为六个串行环节，输入经合规校验后进入分析与排版，再异步生图并轮询取图：
- 合规校验优化（prompt_guardian）：对新人姓名、婚期、地点等文案做合规校验与优化。
- 结婚照视觉风格分析（wedding_photo_analyze）：输出整体风格（如中式/西式/现代等）、色调、情感氛围与构图特征，并给出请柬设计方向。
- 请柬文案与排版设计（invitation_text_layout）：依据婚礼信息与新人姓名生成 formatted_text 与 layout_design。
- 生图提示词融合（invitation_image_prompt）：合并照片分析、可选用户指定 style、画面比例与排版方案，生成最终 prompt。
- 启动请柬图片生成（接口 3373）：以结婚照为参考图异步提交，返回
task_id与result_url。 - 轮询状态（polling）：约每 6 秒查询一次，最长等待 1500 秒，直至
task_status为SUCCEEDED，得到invitation_image_url。
主要输入字段：img_url、groom、bride、wedding_date、wedding_venue 为必填；wedding_time、style、ratio 选填。style 为空时采用照片分析结果；ratio 可选 1:1、3:4、4:3、16:9、9:16，默认 9:16。
无 AppKey 时，技能说明支持走模拟体验（一次性 POST 模拟接口预览效果）；真实生成需配置 showapi_appkey，并在 API URL 查询参数中携带 appKey。官方文档注明单次真实调用预估费用约 0.22 元/次（含模型推理）。脚本依赖仅 Python 标准库。
安装与启用¶
安装 SkillHub CLI¶
若尚未安装 CLI，可先检查版本：
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装文档执行完整安装（示例为官方推荐命令）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本技能¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。本技能坐标为 @showapi/wedding-invitation-generation-showapi，等价安装命令示例：
skillhub install wedding-invitation-generation-showapi --namespace showapi --dir <skills 目录>
常见 Agent 的 skills 路径（来自 SkillHub 安装说明）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可在对话中让 AI 参照 https://skillhub.cn/install/skillhub.md 安装 @showapi/wedding-invitation-generation-showapi。安装后按各客户端要求重启或刷新技能列表。
配置 AppKey¶
凭证名称：showapi_appkey。未注册时可按技能文档通过手机验证码调用 ShowAPI 的 agent_sendCode 与 agent_verify 接口获取 app_key，后续请求在 URL 中附带 appKey={app_key}。
典型用法¶
在技能目录下，配置好 AppKey 后走强制异步流程：先提交任务拿到 task_id，再轮询直至成功。
1、收集信息
确认结婚照可访问 URL、新郎新娘姓名、婚礼日期与地点；按需补充婚礼时间、风格（如 可爱、中式）与比例。
2、提交异步任务
在技能包根目录执行（参数与官方 SKILL.md 示例一致）：
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"
3、轮询结果
python scripts/query_task.py --task-id "返回的task_id值"
按文档节奏约每 6 秒查询一轮，最长等待 1500 秒；每轮应将核心进度反馈给用户。成功后从响应中读取 invitation_image_url 与 task_id，可下载图片或生成简单 HTML 页面展示请柬与文案。
成功时 showapi_res_body 形态示例：
{
"invitation_image_url": "最终生成的婚礼请柬高清图片访问地址",
"task_id": "生图任务唯一标识",
"task_status": "SUCCEEDED"
}
适用场景与注意¶
适合谁：需要在 Agent 对话里快速产出与结婚照风格一致的电子请柬图、或把请柬生成嵌入婚庆类产品的开发者与运营；也适合筹备期反复改文案、改比例时再生成一版的场景。
需要注意：
- 结婚照 URL 需可被后端访问；必填字段缺失会导致流程无法启动。
- 图片生成均为异步，不能只调
execute_task.py而不轮询query_task.py。 - 模拟模式仅作效果预览，与真实 AppKey 调用路径不同，上线前务必完成鉴权与计费确认。
- 企业技能依赖万维易源 ShowAPI 可用性与账号配额，网络与 AppKey 泄露风险需自行管控。
结尾¶
婚礼请柬生成-万维易源 把合规、照片风格分析、文案排版与异步出图封装成一条 Agent 可执行的 SKILL 流程，减少在多个工具间手工对齐风格与版式的工作量。安装与详情见 SkillHub：
- https://www.skillhub.cn/skills/showapi/wedding-invitation-generation-showapi
- https://api.skillhub.cn/showapi/wedding-invitation-generation-showapi
