← 小描 API 文档

图片去水印接口

使用已有小描 API Key,每次提交一张图片。提交时预留 1 个额度,首次领取结果时正式消耗,重复领取不重复扣费。失败、取消或过期后释放未消耗的额度。

支持 PNG、JPG、WebP,最大 10 MB、3200 万像素。任务和文件自提交起保留 15 分钟,请及时领取。

操作接口
提交图片POST /api/watermark-jobs
查询状态GET /api/watermark-jobs/{job_id}
领取图片GET /api/watermark-jobs/{job_id}/result
取消任务DELETE /api/watermark-jobs/{job_id}

提交图片

curl https://xiaomiao-ai.com/api/watermark-jobs \
  -H "Authorization: Bearer $XIAOMIAO_API_KEY" \
  -F "image=@input.png"

返回 201 和 job_id、status_url、result_file_url、expires_at。查询状态为 completed 后,带相同鉴权请求 result_file_url,响应内容即为处理后的图片。

curl "https://xiaomiao-ai.com/api/watermark-jobs/JOB_ID/result" \
  -H "Authorization: Bearer $XIAOMIAO_API_KEY" \
  -o cleaned.png

401:密钥无效;402:额度不足;409:仍在处理;404:任务不存在或已过期;413:图片过大;415:图片格式无效。

发送前查询实时余额

GET https://xiaomiao-ai.com/api/balance,携带 Authorization: Bearer <客户 API Key>。查询不扣额度。

只在 HTTP 200、ok=true、available_credits 明确足够时提交:路径识别与去水印需 1,期刊图需 3 且已开通。余额已扣除预留;查询失败或字段缺失必须停止。提交时服务器再次核验。services 中的 can_submit 仅代表额度与权限,不代表处理器在线。

响应包含 available_credits、credits_used、checked_at、query_cost(0)及 services。无效 Key 返回401;查询失败返回503,不返回虚构的零余额。请勿缓存余额。