--- title: "故事角色IP创作 AI Skill | 万维易源" canonical_url: "https://www.showapi.com/ai/skills/6a5dce5c3c51f27b2a044b9f?tab=integrate&sub=api-ref" last_updated: "2026-08-11T08:16:42.876Z" meta: description: "基于用户输入的角色概念和参考图，深度解析角色IP结构化特征，融合角色设计展示板规范生成画面布局指令与生图提示词，最终生成标准化的角色视觉资产设定图（角色设计展示板），确保角色形象统一且具备IP延展性。 免费在线使用，也支持 API / Agent 接入。" keywords: "故事角色IP创作 AI Skill Skills市场 AI技能 在线使用 API接入 showapi，万维易源，易源接口，api开放平台，开放api，api大全，api接口，接口中心，接口大全，开放平台，api，大数据，接口，API" "og:description": "基于用户输入的角色概念和参考图，深度解析角色IP结构化特征，融合角色设计展示板规范生成画面布局指令与生图提示词，最终生成标准化的角色视觉资产设定图（角色设计展示板），确保角色形象统一且具备IP延展性。 免费在线使用，也支持 API / Agent 接入。" "og:title": "故事角色IP创作 AI Skill" --- * * * * # **故事角色IP创作** 基于用户输入的角色概念和参考图，深度解析角色IP结构化特征，融合角色设计展示板规范生成画面布局指令与生图提示词，最终生成标准化的角色视觉资产设定图（角色设计展示板），确保角色形象统一且具备IP延展性。 M**Marwen** 2026-07-21 09:56 · 5 个步骤 ID`6a5dce5c3c51f27b2a044b9f` 把这个 Skill 接入你的应用或 AI Agent —— 自带 REST API、OpenAPI 规范与 Skill 技能包。 Skill 为**异步调用**过程：先提交执行拿到 `task_id`，再轮询查询任务状态与结果。下方按调用顺序列出两个端点。 `https://route.showapi.com/flow/execute/6a5dce5c3c51f27b2a044b9f?appKey={AppKey}` 鉴权：URL 查询参数 `appKey={AppKey}` Content-Type: application/json [获取 AppKey](https://www.showapi.com/console#/myApp) #### 请求体参数 (Request Body) promptstring必填 角色概念：核心人设、外貌特征、性格标签、服装道具、整体美术风格；可包含角色名称、故事类型描述 reference\_imagearray\ 角色参考图URL数组，用于锚定视觉风格，若从零创作可不上传 aspect\_ratiostring 图像宽高比，可选值：1:1、3:4、4:3、16:9、9:16 响应：提交成功返回 task\_id **API 响应结构 (Response Schema)**1 个字段 原始 Schema | | | | | | `https://route.showapi.com/flow/task/query/{task_id}?appKey={AppKey}` 鉴权：URL 查询参数 `appKey={AppKey}` Content-Type: application/json [获取 AppKey](https://www.showapi.com/console#/myApp) 用第 ① 步返回的 task\_id 替换 URL 中的 {task\_id} 轮询，建议 1-2 秒一次，直到 status 为 SUCCESS 或 FAILED；step\_status\_list 可用于可视化执行进度。 响应：任务状态与结果 **API 响应结构 (Response Schema)**127 个字段 原始 Schema | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | **执行中途出错时** `status` 返回 `FAILED`， `remark` 给出错误信息； `step_status_list` 仅包含已执行到的部分阶段， `output` 为已产出的部分结果（可能为空或不完整）。 ### 通用响应说明 #### 系统级返回 所有 API 响应均使用平台统一封装，业务数据嵌套在 `showapi_res_body` 中 | | | | | | | | | | | | | | #### 错误码 (showapi\_res\_code) | | | | | | | | | | ### **调用代码 ** 代码示例根据当前 **输入参数**实时生成。 **异步调用一并提供"执行"与"查询任务"两个步骤的完整代码**，可按序集成。 **调用代码** cURLPythonJavaScriptJavaGoPHPC#RubyRust 运行 Skill查询任务状态 POSThttps://route.showapi.com/flow/execute/6a5dce5c3c51f27b2a044b9f?appKey={AppKey} 提交任务后立即返回 task\_id，需配合步骤 ② 轮询执行状态与结果 ``` curl \ -g 'https://route.showapi.com/flow/execute/6a5dce5c3c51f27b2a044b9f?appKey={AppKey}' \ -H 'Content-Type: application/json' \ -d '{ "prompt": "现代都市风格的流浪猫侦探，写实风格，角色设定，画面多彩艳丽", "aspect_ratio": "1:1" }' ``` 响应示例：{ "code": 0, "data": { "task\_id": "69ddd187e13823d1d500015b" } } 请在 URL 查询参数 `appKey` 中携带你的 AppKey（如 `?appKey=你的AppKey`），不要在前端代码中硬编码生产 凭证，建议通过环境变量或后端代理注入。 [前往控制台获取 AppKey](https://www.showapi.com/console#/myApp) ### **OpenAPI 规范 ** 标准 **OpenAPI 3.0** 规范文档，可导入 Apifox / Postman / Swagger Editor / Dify，或直接交给 AI Agent 读取以自动接入本 Skill。 提供 **YAML** 与 **JSON** 两种格式，支持浏览器在线查看与直接下载。 当前为**已发布正式版**（`/flow/*`，对外可调用）。 YAML`http://node_site_upstream/openapi/workflow/6a5dce5c3c51f27b2a044b9f.yaml` [浏览器查看 YAML](http://node_site_upstream/openapi/workflow/6a5dce5c3c51f27b2a044b9f.yaml) [下载 YAML](http://node_site_upstream/openapi/workflow/6a5dce5c3c51f27b2a044b9f.yaml?download=1) JSON`http://node_site_upstream/openapi/workflow/6a5dce5c3c51f27b2a044b9f.json` [浏览器查看 JSON](http://node_site_upstream/openapi/workflow/6a5dce5c3c51f27b2a044b9f.json) [下载 JSON](http://node_site_upstream/openapi/workflow/6a5dce5c3c51f27b2a044b9f.json?download=1) 介绍 在线运行 Skill与API