证照工厂

创建时间: 2026-07-01 15:35 | 步骤: 9 个

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

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

提交执行

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

请求体参数 (Request Body)

portrait_imgbase64必填
原始上传肖像人像图(传入标准Base64编码字符串或普通URL)。无图直接终止流程,禁止重绘、替换人脸五官
bg_colorstring必填
底色枚举(white纯白/blue浅蓝/red大红)
id_sizestring必填
证件照尺寸枚举(小一寸/一寸/大一寸/小二寸/二寸/大二寸)或自定义格式(宽x高,如26x32)
响应:提交成功返回 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)35 个字段

执行中途出错时

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

通用响应说明

系统级返回

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

错误码 (showapi_res_code)