基于角色描述创作角色IP-万维易源

概述

基于角色描述创作角色IP

任务目标

• 基于用户输入的角色概念描述（可选搭配参考图），一键生成标准化角色视觉资产设定图（角色设计展示板）
• 具备合规校验、角色结构解析、展示板布局指令生成、角色设定图生图、轮询取图等全链路能力
• 确保角色形象统一且具备IP延展性，输出可直接归档使用的结构化角色档案与展示板图像
• 触发场景：动漫/小说/游戏IP形象设计、角色设定图制作、多视图角色资产生成、IP形象统一管理与延展创作

能力组成

能力流程描述

技能从用户输入的角色概念描述（prompt）出发，经过五个阶段的流水线处理，最终产出角色设计展示板：

1. 合规校验优化（prompt_guardian）：对用户输入的角色概念进行合规性校验与优化，确保提示词安全可用；
2. 抽取提炼角色结构（character_structure_extract）：从角色概念中深度解析出角色名称（char_name）、核心人设（personality）、外貌特征（appearance）、美术风格（style）、资产类型（asset_type）等结构化字段；
3. 生成展示板布局指令与提示词（character_layout_generate）：基于上一步的角色结构化字段，融合角色设计展示板规范，生成画面布局指令（asset_description）与最终生图提示词（final_prompt）；
4. 执行角色设定图生图任务（generate_image）：将最终生图提示词与用户上传的角色参考图（reference_image，可选，用于锚定视觉风格）、图像宽高比（aspect_ratio，可选，默认3:4）一起提交图生图任务；
5. 轮询图片生成结果（polling）：自动轮询生成任务（间隔5秒，最长等待1200秒），直至任务状态为 SUCCEEDED，输出展示板图像访问地址（result_url）。

数据在各阶段间通过结构化字段自动流转：角色概念 → 角色结构档案 → 展示板布局指令与提示词 → 图生图任务 → 展示板图像URL。用户仅需提供角色概念描述；参考图与宽高比为可选输入，用于锚定视觉风格与控制画面比例，全程无需人工干预中间环节。

技能能力组成流程图

flowchart TD
    A[用户输入: 角色概念prompt] --> B[step_0 合规校验优化]
    B --> C[step_1 抽取提炼角色结构<br/>char_name / personality / appearance / style / asset_type]
    C --> D[step_2 生成展示板布局指令与提示词<br/>asset_description / final_prompt]
    E[可选输入: 角色参考图reference_image] --> F[step_3 执行角色设定图生图任务]
    G[可选输入: 宽高比aspect_ratio 默认3:4] --> F
    D --> F
    F --> H[step_4 轮询图片生成结果<br/>间隔5秒 最长等待1200秒]
    H --> I{生成成功?}
    I -- 否, 继续轮询 --> H
    I -- 是 --> J[最终输出: 角色设计展示板图像result_url]

前置准备

• 凭证：配置 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 标准库，无需安装第三方包
• 费用说明：参考单价 0.22 元/次，实际费用按消耗的 token 量有一定浮动

操作步骤

模拟体验流程（无 appKey）

1. 自动触发模拟调用

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

1. 可视化预览

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

1. 引导真实调用

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

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

1. 收集用户需求

梳理用户的角色概念描述，需涵盖核心人设、外貌特征、性格标签、服装道具、整体美术风格，可包含角色名称与故事类型；确认是否上传角色参考图以及画面宽高比。

1. 异步提交生成任务

调用脚本异步执行角色IP设定图生成任务，仅返回唯一 task_id，不阻塞等待。调用示例：

   python scripts/execute_task.py --prompt "现代都市风格的流浪猫侦探，写实风格，角色设定，画面多彩艳丽" --aspect-ratio 3:4 --async

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

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

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

1. 等待结果完成

必须轮询直到完成。图像生成内部轮询最长等待1200秒（间隔5秒），请耐心等待。

1. 结果解析与落地应用

提取角色名称、核心人设、外貌特征、美术风格、资产类型、画面布局指令、生图提示词等结构化信息，结合展示板图像 result_url 进行IP资产归档与延展创作。

1. 生成html页面

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

使用示例

示例1：从零创作流浪猫侦探IP

• 输入：prompt="现代都市风格的流浪猫侦探，写实风格，角色设定，画面多彩艳丽"
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：角色名称/人设/外貌/风格结构化档案 + 标准化角色设计展示板图像
• 配置要点：从零创作不上传参考图，宽高比 3:4

示例2：基于参考图锚定风格生成

• 输入：prompt="奇幻冒险风格的小魔法师，卡通风格，角色设定" + reference_image（已有角色草图URL数组）
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：与参考图视觉风格一致的角色设计展示板
• 配置要点：reference_image 传入图片URL数组，可多图锚定风格

示例3：横版设定图制作

• 输入：prompt="赛博朋克风格的机械义体少女，冷峻高效，暗色调霓虹风格，角色设定"
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：横版角色设计展示板
• 配置要点：aspect_ratio 可选 16:9 或 4:3，适配横版展示场景

生成效果示例

描述

技能运行后输出一份完整的角色IP视觉资产包：

1. 结构化角色档案：包含角色名称、核心人设、外貌特征、美术风格、资产类型（固定为角色设计展示板）等字段，便于IP信息归档与二次编辑；
2. 展示板创作过程数据：包含基于展示板规范生成的画面布局指令（markdown格式）与最终组装的完整生图提示词，可复用于同风格角色的批量生产；
3. 角色设计展示板图像：一张标准化的角色设定图（含角色多视图、表情、服装道具等展示板内容），通过 result_url 提供访问地址，确保角色形象统一且具备IP延展性。

可视化呈现方式：展示板图像以 result_url 直接插入HTML页面展示，结构化字段以JSON/表格形式并列呈现。

输出案例

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

接口返回数据的实际形态（JSON）：

{
  "showapi_res_body": {
    "char_name": "流浪猫侦探",
    "personality": "机敏睿智、外冷内热、观察力极强",
    "appearance": "灰白相间的短毛猫，左耳带一道浅疤，身穿棕色风衣，随身携带复古放大镜",
    "style": "现代都市写实风格，画面多彩艳丽",
    "asset_type": "角色设计展示板",
    "asset_description": "展示板采用标准三视图布局：左侧为正面全身立绘，中部为侧面与背面视图，右下角排列表情集与道具细节特写……",
    "final_prompt": "现代都市风格的流浪猫侦探，写实风格，角色设定，画面多彩艳丽，角色设计展示板，三视图……",
    "result_url": "https://oss.showapi.com/xxx/character_design_sheet.png"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

资源索引

• [scripts/execute_task.py](scripts/execute_task.py)：异步提交角色IP设定图生成任务（真实调用时使用）
• [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": {
    "char_name": "提取的角色IP名称",
    "personality": "角色的核心人设与性格特征",
    "appearance": "角色的外貌特征描述",
    "style": "角色的整体美术风格",
    "asset_type": "角色设计展示板",
    "asset_description": "基于展示板规范生成的画面排版与内容指令",
    "final_prompt": "最终组装的完整生图提示词",
    "result_url": "生成的角色设计展示板图像访问地址"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

注意事项

1. prompt 为必填项，需清晰描述角色的核心人设、外貌特征、性格标签、服装道具、整体美术风格，可包含角色名称与故事类型描述。
2. 所有任务强制异步执行，不支持同步模式。
3. 轮询查询过程中，每次获取接口返回数据后，立即将主要内容反馈给用户。
4. 图像生成任务内部轮询最长等待1200秒（间隔5秒），生成期间请耐心等待，不要中断轮询。
5. reference_image 为可选参数，传入图片URL数组可锚定视觉风格；从零创作时可不上传。
6. aspect_ratio 可选值为 1:1、3:4、4:3、16:9、9:16，默认 3:4。
7. 模拟运行说明：无 appKey 时系统自动触发模拟调用，一次性返回完整 JSON 结果，不经过 execute_task.py 和 query_task.py，结果仅作效果预览，非真实生成内容。如需真实调用，请通过手机验证获取 AppKey 并配置。