海报魔法屋

创建时间: 2026-06-22 13:12 | 步骤: 5 个

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

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

提交执行

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

请求体参数 (Request Body)

grid_numinteger必填
画面宫格排版枚举,仅支持固定值:1=单幅,2=双格2宫格,4=四格2×2四宫格;非法值自动降级为1
promptstring必填
海报用途、视觉风格、投放场景、主辅配色、版式布局、整体氛围、材质肌理、光影质感、文字排版要求等完整设计需求
reference_imagebase64必填
海报核心基底参考图URL,支持人像、实物产品、风景、品牌LOGO
aspect_ratiostring
成品图像宽高比例,可选枚举:1:1、3:4、4:3、16:9、9:16;未传入默认使用3:4
响应:提交成功返回 task_id
API 响应结构 (Response Schema)3 个字段
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)112 个字段

执行中途出错时

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

通用响应说明

系统级返回

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

错误码 (showapi_res_code)