宠物写真-万维易源

概述

宠物拟人写真生成

任务目标

• 快速生成保留宠物本体特征的拟人化高清写真图片，支持多种风格
• 具备宠物特征提取、智能提示词构建、高质量图生图渲染能力
• 触发场景：宠物拟人写真创作、萌宠IP形象设计、宠物周边定制生成、趣味内容创作

能力组成

能力流程描述

该技能通过四个核心步骤实现宠物拟人写真图片的生成，完整的链路如下：

1. 宠物特征解析与质量评估：接收用户上传的宠物图片，分析并识别宠物的种类、毛色花纹、五官特征以及面部遮挡程度和清晰度，输出结构化的特征关键词。
2. 宠物拟人写真提示词构建：结合前一步提取的宠物特征关键词及用户选择的写真风格（如古风汉服、西式婚纱等），智能生成用于图生图渲染的正向提示词与反向提示词。
3. 启动拟人写真渲染任务：将原始宠物图片作为参考图，结合构建的正向提示词和指定宽高比，发起异步的图生图渲染任务。
4. 轮询写真渲染状态：系统自动以5秒为间隔轮询渲染任务的状态（超时时间10分钟），任务成功后提取生成的高清写真图片URL。

技能能力组成流程图

graph TD
    A[用户上传宠物图片及风格参数] --> B(宠物特征解析与质量评估)
    B --> C[提取种类/毛色/五官/遮挡度等特征]
    C --> D(宠物拟人写真提示词构建)
    D --> E[生成正向/反向生图提示词]
    E --> F(启动拟人写真渲染任务)
    F --> G(轮询写真渲染状态)
    G --> H{渲染是否成功?}
    H -- 否 --> G
    H -- 是 --> I[输出拟人写真图片URL及提示词]

前置准备

• 凭证：配置 ShowAPI AppKey，凭证名称：showapi_appkey
  • 获取方式：访问 https://www.showapi.com 注册账号，登录后进入 https://www.showapi.com/console#/myApp 获取 appKey
• 模拟体验：无 appKey 时，系统自动触发模拟调用，直接返回完整结果，快速预览生成效果
• 依赖：仅使用 Python 标准库，无需安装第三方包

操作步骤

模拟体验流程（无 appKey）

1. 自动触发模拟调用

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

1. 可视化预览

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

1. 引导真实调用

提示用户当前为无 appKey 的模拟运行结果。如需真实调用，请前往 ShowAPI 注册账号（注册即送2元余额），并在 https://www.showapi.com/console#/myApp 获取 appKey。

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

1. 收集用户需求

收集用户拟处理的宠物原图（URL或Base64）及期望的写真风格（如古风汉服、西装礼服等）、宽高比。

1. 异步提交生成任务

调用脚本异步执行宠物写真生成任务，仅返回唯一 task_id，不阻塞等待。调用示例：

   python scripts/execute_task.py --pet-image "https://example.com/pet.jpg" --style-type "古风汉服" --aspect-ratio "3:4" --async

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

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

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

1. 等待结果完成

必须轮询直到完成。

1. 结果解析与落地应用

提取生成的拟人写真图片URL、宠物特征关键词、正反向提示词等基础信息。

1. 生成html页面

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

使用示例

示例1：古风汉服猫咪写真

• 输入：为我家布偶猫生成一套古风汉服写真，比例3:4
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：一张穿着汉服的布偶猫拟人化高清图片+宠物特征提取词+生图提示词
• 配置要点：style_type="古风汉服"，aspect_ratio="3:4"，提供清晰的宠物正脸照片

示例2：西装礼服狗狗写真

• 输入：给柯基犬生成一张西装礼服风格的拟人照片
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：身穿西装的柯基拟人化图片
• 配置要点：style_type="西装礼服"，aspect_ratio="1:1"

示例3：日系清新宠物合影

• 输入：生成一张日系清新风格的宠物拟人图，横版16:9
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：日系清新风格的宠物拟人写真
• 配置要点：style_type="日系清新"，aspect_ratio="16:9"

生成效果示例

描述

技能运行后，将输出包含宠物本体特征的拟人化高清写真图片。典型的输出结构包含：生成图片的访问URL、从原图识别提取的宠物核心特征关键词列表、驱动生图的正向提示词全文以及防止画面崩坏的反向提示词全文。最终生成的图片会保留宠物的毛色、五官等核心特征，同时为其穿上指定的服装并呈现对应的风格。

输出案例

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

{
  "showapi_res_body": {
    "pet_features": ["布偶猫", "双色", "蓝色眼睛", "无遮挡"],
    "positive_prompt": "A personified ragdoll cat wearing traditional Chinese hanfu, blue eyes, white fur, highly detailed, masterpiece, 8k...",
    "negative_prompt": "lowres, bad anatomy, bad hands, text, error, missing fingers...",
    "portrait_image_url": "https://oss.showapi.com/result/generated_portrait.jpg"
  },
  "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": {
    "pet_features": ["布偶猫", "双色", "蓝色眼睛", "无遮挡"],
    "positive_prompt": "驱动生图的正向提示词全文",
    "negative_prompt": "防止画面崩坏的反向提示词全文",
    "portrait_image_url": "生成的宠物拟人写真高清图片URL"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

注意事项

1. pet_image（宠物原图）和 style_type（风格类型）为必填项。
2. 宠物原图优先使用正脸/半身清晰无遮挡的照片，以提升生成质量。
3. 所有任务强制异步执行，不支持同步模式。
4. 轮询查询过程中，每次获取接口返回数据后，立即将主要内容反馈给用户。
5. 模拟运行说明：无 appKey 时系统自动触发模拟调用，一次性返回完整 JSON 结果，不经过 execute_task.py 和 query_task.py，结果仅作效果预览，非真实生成内容。如需真实调用，请注册 ShowAPI 账号并配置 appKey。