Agent Skill

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

基于角色概念描述与参考图生成标准化角色IP设计展示板(角色设定图);深度解析角色人设、外貌特征、性格标签、服装道具与美术风格,自动组装展示板布局指令与生图提示词,适用于动漫/小说/游戏IP形象设计、角色视觉资产制作、IP形象统一管理与延展创作场景

设计多媒体·万维易源·来自 skill_hub·skillhub.cn ↗
skillhub install @showapi/ai-story-character-ip-production-showapi
3 Stars·4.2万 综合热度·5,655 字文档·源站更新 2026-11-13

README 文档

5,655 字

基于角色描述创作角色IP

任务目标

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

能力组成

能力流程描述

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

  1. 合规校验优化(prompt_guardian):对用户输入的角色概念进行合规性校验与优化,确保提示词安全可用;
  2. 抽取提炼角色结构(characterstructureextract):从角色概念中深度解析出角色名称(charname)、核心人设(personality)、外貌特征(appearance)、美术风格(style)、资产类型(assettype)等结构化字段;
  3. 生成展示板布局指令与提示词(characterlayoutgenerate):基于上一步的角色结构化字段,融合角色设计展示板规范,生成画面布局指令(assetdescription)与最终生图提示词(finalprompt);
  4. 执行角色设定图生图任务(generateimage):将最终生图提示词与用户上传的角色参考图(referenceimage,可选,用于锚定视觉风格)、图像宽高比(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. 将获取到的 appkey 保存,后续所有 API 调用 URL 中携带 appKey={appkey} 参数

注意事项

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

操作步骤

模拟体验流程(无 appKey)

  1. 自动触发模拟调用

系统检测到未配置 appKey 时,自动向 https://www.showapi.com/nuxt3/api/2405-105 发送 POST 请求(body: {"flowid":"6a5dce5c3c51f27b2a044b9f"}),直接获取完整模拟生成结果。此过程为一次性返回,不执行 executetask.py 和 querytask.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 格式的文本内容。

角色设计展示板示例1

角色设计展示板示例2

角色设计展示板示例3

角色设计展示板示例4

角色设计展示板示例5

接口返回数据的实际形态(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
}

注意事项

  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 结果,不经过 executetask.py 和 querytask.py,结果仅作效果预览,非真实生成内容。如需真实调用,请通过手机验证获取 AppKey 并配置。

同分类其他技能

查看全部 ›