Skip to content

查任务 · GET /api/jobs

填入你的 API Key本站所有示例里的 $MUSEAV_API_KEY 会就地换成它

只存在你自己浏览器的 localStorage 里,不会发给任何人——本站是纯静态页面,没有后端可发。 共用电脑上看完记得点「清除」。

bash
curl "https://manager.museav.top/api/jobs" -H "X-API-Key: $MUSEAV_API_KEY"

只返回你自己的任务:租户 Key 看本租户名下全部,账户 Key 和个人登录只看自己的。

什么时候用它

主要是回调丢失时的兜底轮询

正常路径是 /api/generatecallback_url,出完了中台通知你。 但回调走的是公网,你那边重启、网络抖动都可能丢一条。 所以生产环境应该两条腿走路:回调为主,轮询为辅。

别把轮询当主路径

出图十几秒到一分钟,秒级轮询是在浪费两边的资源。 合理的兜底节奏是「提交后 N 秒查一次,之后指数退避」, 或者干脆定时扫一遍还处于 pending 的任务。

查单个

bash
curl "https://manager.museav.top/api/jobs?id=<jobId>" -H "X-API-Key: $MUSEAV_API_KEY"

任务状态

job.status 只有三种:pending / done / failed

业务阶段不在 status

图片转模板这种多步骤任务, 「解析图片」「抽取文字层」「创建模板」这些阶段在 job.steps 里,不在 status 里。

想给用户显示「正在解析图片…」,读 stepsstatusrunning 的那一项。 任务结束后不会再有 running

相关