下方示例中的
YOUR_UID / YOUR_KEY 请替换为登录后的密钥。登录后可在「在线调试」上传图片实测。本接口为 POST JSON,不是短视频解析那种 GET 拼接链接。图片以 base64 / URL / image_id 传入,成功返回
result_base64。接口地址
POST Content-Type: application/json
鉴权字段放在 JSON 里的 uid / key(登录后本页会自动替换示例)。图片不在本站落盘;成功扣点,失败不扣。
限制
| 项 | 说明 |
|---|---|
| 图片大小 | ≤ 8 MB(解码后) |
| 长边像素 | ≤ 4096 px |
| 蒙版 | rectangles / mask_base64 / strokes 至少一种 |
| 原图 | image_base64 / image_url / image_id 三选一 |
请求参数(JSON Body)
| 参数 | 必填 | 说明 |
|---|---|---|
uid | 是 | 用户 UID |
key | 是 | 接口密钥 |
image_base64 | 三选一 | 原图 base64(可带 data:image/...;base64, 前缀) |
image_url | 三选一 | 原图公网 URL |
image_id | 三选一 | 上次成功返回的 id,用于「再次修复」免传原图 |
rectangles | 蒙版三选一 | 矩形数组,坐标为原图像素:[{"x1":10,"y1":10,"x2":100,"y2":40}] |
mask_base64 | 蒙版三选一 | 蒙版图 base64(白=要修区域) |
strokes | 蒙版三选一 | 涂抹笔迹 JSON(高级用法) |
request_id | 否 | 幂等键,≤64;不传则服务端自动生成 |
mode | 否 | 固定传 new 即可 |
最小请求示例
{
"uid": "YOUR_UID",
"key": "YOUR_KEY",
"request_id": "ip_demo_001",
"mode": "new",
"image_base64": "/9j/4AAQ...(原图base64)",
"rectangles": [{"x1": 80, "y1": 40, "x2": 320, "y2": 120}]
}
常见问题
如何获取 UID / KEY? 注册并登录后,本页「在线调试」会自动填入;也可在控制台查看。
是不是 GET? 不是。请 POST JSON 到业务地址 https://syapi.chuangye.site/api/inpaint/v1,不要走短视频的 /home/api?url=。
要传什么? 必填 uid、key;原图三选一(image_base64 / image_url / image_id);蒙版至少一种(常用 rectangles)。详见「API 文档 / 示例代码」。
如何计费? 成功调用扣 1 点,失败不扣;可在本页「立即购买」开通包点或包月。
有免费额度吗? 新用户注册即可免费测试:每个独立计费产品赠送 20 次调用额度(失败不扣点),用完后需购买套餐。「共用默认池」产品与短视频共用同一份额度。