美甲效果图智能生成

美甲效果图智能生成

美甲师上传甲片设计图和模特指部照片,系统先对设计图进行视觉深度分析提取特征,再根据特征与用户提示词(选填)自动合成克制还原的生图提示词(禁止过度美化,仅在用户明确要求时适度增强),最后结合手指照片生成逼真的美甲效果图。

Serenoa 2026-07-21 10:36 · 5 个步骤

把这个 Skill 接入你的应用或 AI Agent —— 自带 REST API、OpenAPI 规范与 Skill 技能包。

Skill 为异步调用过程:先提交执行拿到 task_id,再轮询查询任务状态与结果。下方按调用顺序列出两个端点。
1POST

提交执行

https://route.showapi.com/flow/execute/6a5ddaf13c51f2063c0000d0?appKey={AppKey}
鉴权:URL 查询参数 appKey={AppKey}Content-Type: application/json获取 AppKey

请求体参数 (Request Body)

design_imgbase64必填
甲片设计草图图片(传入标准 Base64 编码字符串或普通 URL)
finger_imgbase64必填
模特指部照片(传入标准 Base64 编码字符串或普通 URL)
prompt_textstring
用户选填的提示词。为空时严格还原设计图;若包含丰富效果要求(如加闪粉、更立体),则适度增强但锚定核心设计特征
aspect_ratiostring
生成图像的宽高比,可选值:1:1、3:4、4:3、16:9、9:16
响应:提交成功返回 task_id
API 响应结构 (Response Schema)1 个字段
2GET

查询任务状态

https://route.showapi.com/flow/task/query/{task_id}?appKey={AppKey}
鉴权:URL 查询参数 appKey={AppKey}Content-Type: application/json获取 AppKey
用第 ① 步返回的 task_id 替换 URL 中的 {task_id} 轮询,建议 1-2 秒一次,直到 status 为 SUCCESS 或 FAILED;step_status_list 可用于可视化执行进度。
响应:任务状态与结果
API 响应结构 (Response Schema)91 个字段

执行中途出错时

status 返回 FAILEDremark 给出错误信息; step_status_list 仅包含已执行到的部分阶段, output 为已产出的部分结果(可能为空或不完整)。

通用响应说明

系统级返回

所有 API 响应均使用平台统一封装,业务数据嵌套在 showapi_res_body

错误码 (showapi_res_code)

调用代码

代码示例根据当前 输入参数实时生成。 异步调用一并提供"执行"与"查询任务"两个步骤的完整代码,可按序集成。

调用代码
POSThttps://route.showapi.com/flow/execute/6a5ddaf13c51f2063c0000d0?appKey={AppKey}
提交任务后立即返回 task_id,需配合步骤 ② 轮询执行状态与结果
curl \
  -g 'https://route.showapi.com/flow/execute/6a5ddaf13c51f2063c0000d0?appKey={AppKey}' \
  -H 'Content-Type: application/json' \
  -d '{
  "design_img": "https://showapi-pub-hangzhou.oss-cn-hangzhou.aliyuncs.com/huangye/img_2d9090af-6a41-4c56-aad0-d7b92e63c0cc.jpg",
  "finger_img": "https://showapi-pub-hangzhou.oss-cn-hangzhou.aliyuncs.com/huangye/img_88c77ee7-0489-446e-90b9-6d5af65e6814.jpg",
  "prompt_text": "指甲修短一点点",
  "aspect_ratio": "1:1"
}'
响应示例:{ "code": 0, "data": { "task_id": "69ddd187e13823d1d500015b" } }
请在 URL 查询参数 appKey 中携带你的 AppKey(如 ?appKey=你的AppKey),不要在前端代码中硬编码生产 凭证,建议通过环境变量或后端代理注入。 前往控制台获取 AppKey

OpenAPI 规范

标准 OpenAPI 3.0 规范文档,可导入 Apifox / Postman / Swagger Editor / Dify,或直接交给 AI Agent 读取以自动接入本 Skill。 提供 YAMLJSON 两种格式,支持浏览器在线查看与直接下载。
当前为已发布正式版/flow/*,对外可调用)。

YAMLhttp://node_site_upstream/openapi/workflow/6a5ddaf13c51f2063c0000d0.yaml
JSONhttp://node_site_upstream/openapi/workflow/6a5ddaf13c51f2063c0000d0.json