查任务 · 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/generate 传 callback_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 里。
想给用户显示「正在解析图片…」,读 steps 中 status 为 running 的那一项。 任务结束后不会再有 running。