WORKSPACE / IMAGE PROCESSING
服务概览
FOCUS ON WHAT MATTERS
留住主体。
释放图片的可能。
从一张图片到批量工作流,统一管理你的抠图服务。
运行状态
正在读取真实服务状态…
轻量服务器使用 CPU 推理时可能较慢;队列可缓冲请求,但不会提升模型的处理速度。
给图片一个干净的背景
上传后加入真实处理队列,完成后预览并下载透明 PNG。
任务队列
查看处理状态、下载结果或取消尚未执行的任务。
为每个调用方分配独立密钥
支持 Bearer Token 和 HMAC-SHA256 签名。停用后立即阻止新的 API 请求。
密钥仅在此显示一次,请立即保存
完整 Token 用于 Bearer;签名时使用 Key ID 和 Secret。不要放进公开前端代码。
DEVELOPER QUICKSTART
连接你的图片工作流
外部服务器通过 HTTPS 调用。图片处理采用异步任务模式:上传 → 轮询 → 下载。
1 / 上传单张或批量图片
响应 HTTP 202,包含 batch_id 和 jobs。每个任务有独立 id。
或:提交图片 URL
同样返回 202,服务器在后台下载、校验和抠图。URL 下载失败会记录为 failed。
2 / 查询任务
状态:queued → processing → succeeded / failed;另有 cancelled 和 expired。
3 / 下载透明 PNG
ERP 异步接入
ERP 后端提交后保存任务 ID,立即返回“处理中”。后台定时任务只轮询未完成批次,间隔建议 3、5、10 秒,随后最多 30 秒,结束即停止。完成后下载 PNG 到 ERP 自己的存储,本站结果只保留 24 小时。页面关闭不影响后台任务;API 密钥仅存后端。目前采用轮询,尚未实现 Webhook 回调。
HMAC 签名(sign)
请求头:X-Key-Id、X-Timestamp(秒)、X-Nonce(16–128 字符随机数)、X-Signature。
canonical = timestamp + "\n" + nonce + "\n" + METHOD + "\n"
+ path_with_query + "\n" + sha256(raw_request_body).hexdigest()
signature = hmac_sha256(secret, canonical).hexdigest()签名覆盖原始请求体;multipart 应先构建请求再签名。时间误差限 5 分钟,随机数禁止复用。GET 空请求体也需要计算 SHA-256。
429:队列已满,请退避重试;413:文件或像素超限;401:凭证失效;409:结果未完成或签名重放;410:结果已清理。
查看完整 OpenAPI 定义 ↗修改管理员密码
至少 12 位。修改后所有管理登录会话失效,请重新登录;API 密钥和图片任务不受影响。
HTTPS 自动续签
正在读取证书维护状态…
每 6 小时检查,失败后 15 分钟重试(每小时最多 3 次)。续签成功后自动加载新证书,不中断抠图任务。