基于角色描述创作角色IP-万维易源
基于角色概念描述与参考图生成标准化角色IP设计展示板(角色设定图);深度解析角色人设、外貌特征、性格标签、服装道具与美术风格,自动组装展示板布局指令与生图提示词,适用于动漫/小说/游戏IP形象设计、角色视觉资产制作、IP形象统一管理与延展创作场景
skillhub install @showapi/ai-story-character-ip-production-showapi
README 文档
5,655 字基于角色描述创作角色IP
任务目标
- 基于用户输入的角色概念描述(可选搭配参考图),一键生成标准化角色视觉资产设定图(角色设计展示板)
- 具备合规校验、角色结构解析、展示板布局指令生成、角色设定图生图、轮询取图等全链路能力
- 确保角色形象统一且具备IP延展性,输出可直接归档使用的结构化角色档案与展示板图像
- 触发场景:动漫/小说/游戏IP形象设计、角色设定图制作、多视图角色资产生成、IP形象统一管理与延展创作
能力组成
能力流程描述
技能从用户输入的角色概念描述(prompt)出发,经过五个阶段的流水线处理,最终产出角色设计展示板:
- 合规校验优化(prompt_guardian):对用户输入的角色概念进行合规性校验与优化,确保提示词安全可用;
- 抽取提炼角色结构(characterstructureextract):从角色概念中深度解析出角色名称(charname)、核心人设(personality)、外貌特征(appearance)、美术风格(style)、资产类型(assettype)等结构化字段;
- 生成展示板布局指令与提示词(characterlayoutgenerate):基于上一步的角色结构化字段,融合角色设计展示板规范,生成画面布局指令(assetdescription)与最终生图提示词(finalprompt);
- 执行角色设定图生图任务(generateimage):将最终生图提示词与用户上传的角色参考图(referenceimage,可选,用于锚定视觉风格)、图像宽高比(aspect_ratio,可选,默认3:4)一起提交图生图任务;
- 轮询图片生成结果(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,请按以下步骤通过手机验证获取:
- 请用户提供手机号(中国大陆手机号)
- 调用发送验证码接口:
POST https://www.showapi.com/auth/agent_sendCode
Content-Type: application/x-www-form-urlencoded
phone={手机号}
成功响应:{"flag":true,"remark":"发送成功"}
- 请用户查看手机收到的6位验证码并告诉你
- 调用验证接口获取 AppKey:
POST https://www.showapi.com/auth/agent_verify
Content-Type: application/x-www-form-urlencoded
phone={手机号}&code={验证码}
成功响应:{"flag":true,"app_key":"你的AppKey"}
- 将获取到的 appkey 保存,后续所有 API 调用 URL 中携带
appKey={appkey} 参数
注意事项
- 验证码5分钟有效,每分钟只能发送1次
- 如果手机号已注册过易源数据平台账户,会直接返回该账户的 AppKey,不会重复注册
- AppKey 获取后请妥善保存,避免重复验证
- 模拟体验:无 appKey 时,系统自动触发模拟调用,直接返回完整结果,快速预览生成效果
- 依赖:仅使用 Python 标准库,无需安装第三方包
- 费用说明:参考单价 0.22 元/次,实际费用按消耗的 token 量有一定浮动
操作步骤
模拟体验流程(无 appKey)
- 自动触发模拟调用
系统检测到未配置 appKey 时,自动向 https://www.showapi.com/nuxt3/api/2405-105 发送 POST 请求(body: {"flowid":"6a5dce5c3c51f27b2a044b9f"}),直接获取完整模拟生成结果。此过程为一次性返回,不执行 executetask.py 和 querytask.py。
- 可视化预览
将返回的 JSON 结果以 HTML 形式可视化展示,重点呈现角色设计展示板图片内容。
- 引导真实调用
提示用户当前为无 appKey 的模拟运行结果。如需真实调用,请通过手机验证获取 AppKey(步骤见「前置准备-鉴权配置」),并在后续所有 API 调用 URL 中携带 appKey={app_key} 参数。
标准流程(有 appKey,强制异步执行)
- 收集用户需求
梳理用户的角色概念描述,需涵盖核心人设、外貌特征、性格标签、服装道具、整体美术风格,可包含角色名称与故事类型;确认是否上传角色参考图以及画面宽高比。
- 异步提交生成任务
调用脚本异步执行角色IP设定图生成任务,仅返回唯一 task_id,不阻塞等待。 调用示例:
python scripts/execute_task.py --prompt "现代都市风格的流浪猫侦探,写实风格,角色设定,画面多彩艳丽" --aspect-ratio 3:4 --async
- 轮询查询任务结果(必选)
使用 task_id 循环查询任务状态,每一轮轮询后,即时将当前返回的核心资料同步反馈给用户,直至获取完整结果。 调用示例:
python scripts/query_task.py --task-id "返回的task_id值"
- 等待结果完成
必须轮询直到完成。图像生成内部轮询最长等待1200秒(间隔5秒),请耐心等待。
- 结果解析与落地应用
提取角色名称、核心人设、外貌特征、美术风格、资产类型、画面布局指令、生图提示词等结构化信息,结合展示板图像 result_url 进行IP资产归档与延展创作。
- 生成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视觉资产包:
- 结构化角色档案:包含角色名称、核心人设、外貌特征、美术风格、资产类型(固定为角色设计展示板)等字段,便于IP信息归档与二次编辑;
- 展示板创作过程数据:包含基于展示板规范生成的画面布局指令(markdown格式)与最终组装的完整生图提示词,可复用于同风格角色的批量生产;
- 角色设计展示板图像:一张标准化的角色设定图(含角色多视图、表情、服装道具等展示板内容),通过 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:异步提交角色IP设定图生成任务(真实调用时使用)
- 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
}
注意事项
- prompt 为必填项,需清晰描述角色的核心人设、外貌特征、性格标签、服装道具、整体美术风格,可包含角色名称与故事类型描述。
- 所有任务强制异步执行,不支持同步模式。
- 轮询查询过程中,每次获取接口返回数据后,立即将主要内容反馈给用户。
- 图像生成任务内部轮询最长等待1200秒(间隔5秒),生成期间请耐心等待,不要中断轮询。
- reference_image 为可选参数,传入图片URL数组可锚定视觉风格;从零创作时可不上传。
- aspect_ratio 可选值为 1:1、3:4、4:3、16:9、9:16,默认 3:4。
- 模拟运行说明:无 appKey 时系统自动触发模拟调用,一次性返回完整 JSON 结果,不经过 executetask.py 和 querytask.py,结果仅作效果预览,非真实生成内容。如需真实调用,请通过手机验证获取 AppKey 并配置。
同分类其他技能
查看全部 ›通过同一个AI创作工具完成AI图片、视频、音乐与语音创作,查找公开社交数据,编辑视觉成果,并集中查看和管理生成资产。Beatra 全能创
135 180.6万 AI音乐MV短片制作用一首歌的情绪、节奏和视觉概念,制作一个短视觉短片。这个 AI 音乐 MV 短片制作与歌曲生成视频工作流可以把音乐片段和视觉方向变成电影
15 66.1万 MiniMax H3 AI视频创作用 MiniMax H3 这款 AI视频生成器创作高质感 2K AI 视频。从文字创意出发完成文生视频,让静态图片自然动起来,用首尾画面
27 64.2万 AI数字人口播与虚拟主播视频用一张人像和一段短脚本或语音,制作有明确讲述内容的数字人口播视频。可使用现成录音,也可以先选择音色,把脚本生成旁白,让画面中的人物随声音
44 61.3万 架构图一键生成使用 ContextWeave 生成或修改架构图、流程图、思维导图和复杂信息图。适用于需要从代码、文件或自然语言中提取结构与关系并实际产
288 54.7万 海报设计工作室将一段活动描述、一张产品照片或品牌参考图,转化为抓人眼球的活动海报、宣传 banner 或社交媒体配图。这款 AI海报设计与制作工具生成
39 42.1万