成功才扣费
提交时先预留 1 积分；抠成功再实扣，处理失败会退回。同步等太久只是先给你任务 ID，后台还在跑，预留不会因此退掉。
批图牛开发者 API
几行代码， 给产品加上自动抠图
传图片 URL 或 Base64，拿回透明底结果图。抠成功扣 1 积分，失败不扣。 图少可以用同步接口直接等结果；量大建议走异步，也可以用 Webhook 收通知。
同步或异步
少量图可以直接等结果；批量处理交完立刻返回任务 ID，再慢慢查。
断线也能重试
每次请求带上 Idempotency-Key。网络抖了再发一次，不会多扣费。
结果保留 24 小时
返回的下载链接有效期一天，请及时存到自己的空间。
认证与计费
去 个人中心 → API 管理 创建 Key，然后在请求头里带上：
Authorization: Bearer YOUR_API_KEY
每个请求还要带 Idempotency-Key（最长 128 字符）。同一张业务图固定用一个 Key，重试时别换——这样断线重发不会多扣费。 Key 本身只放服务端，别写进网页、小程序或 App 客户端。
余额不够
会直接返回 HTTP 402，错误码 INSUFFICIENT_CREDITS，不会开始处理。
积分不够了？
按量购买，抠成功 1 张扣 1 积分。100 积分
¥10¥0.1/张500 积分
¥45¥0.09/张1000 积分
¥80¥0.08/张5000 积分
¥350¥0.07/张10000 积分
¥650¥0.065/张20000 积分
¥1200¥0.06/张格式限制
| 怎么传图 | image_url 或 image_base64，二选一 |
|---|---|
| 输入格式 | JPG、PNG、WebP、AVIF、JXL |
| 输出格式 | PNG、WebP、AVIF、JXL（都带透明通道），默认 PNG |
| 文件大小 | 最大 50 MB |
| 图片尺寸 | 宽、高都不超过 10000 像素，总像素不超过 1 亿 |
| 结果链接 | 成功后保留 24 小时 |
调用方式
选同步还是异步
POST
https://apix.ai-gptbot.com/v1/matting
请求发出后会等抠图完成再返回。如果大约 120 秒还没好，会先返回任务 ID（HTTP 202，body 里可能有 sync_timeout: true）， 后台会继续处理；你再用查询接口拿结果就行，不会多扣一次费。 传图字段和异步一样：image_url / image_base64 二选一，可选 output_format。
curl -X POST https://apix.ai-gptbot.com/v1/matting \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: order-20260727-0001" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://example.com/product.jpg",
"output_format": "png"
}'用 Base64 传图
curl -X POST https://apix.ai-gptbot.com/v1/matting \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: order-20260727-0002" \
-H "Content-Type: application/json" \
-d '{
"image_base64": "data:image/png;base64,iVBORw0KGgo...",
"output_format": "webp"
}'参考
返回结果与错误
返回结果
任务状态一般是：排队 queued → 处理中 processing → 成功 succeeded。 失败是 failed，结果过期后是 expired。
queuedprocessingsucceeded
{
"job_id": "8ea7c37d-9ab4-4e82-8e5c-46c9fb9f42c8",
"status": "succeeded",
"result": {
"url": "https://aihuihuaoss01.ai-gptbot.com/...",
"format": "png",
"contentType": "image/png",
"sizeBytes": 864321,
"width": 2400,
"height": 2400,
"expiresAt": "2026-07-28T08:30:00Z"
},
"created_at": "2026-07-27T08:29:51Z",
"started_at": "2026-07-27T08:29:52Z",
"finished_at": "2026-07-27T08:30:00Z",
"status_url": "https://apix.ai-gptbot.com/v1/matting/jobs/8ea7c37d-9ab4-4e82-8e5c-46c9fb9f42c8"
}常见错误码
| HTTP | 错误码 | 意思 |
|---|---|---|
| 400 | INVALID_IMAGE_SOURCE | image_url 和 image_base64 只能填一个 |
| 400 | INVALID_IDEMPOTENCY_KEY | 缺少 Idempotency-Key，或超过 128 字符 |
| 400 | UNSUPPORTED_IMAGE_FORMAT | 图片格式不支持 |
| 400 | UNSUPPORTED_OUTPUT_FORMAT | output_format 不在支持列表里 |
| 400 | INVALID_CALLBACK | 回调地址和 secret 没成对填写，或长度不合规 |
| 400 | IMAGE_RESOLUTION_TOO_LARGE | 宽/高超过 10000，或总像素超过 1 亿 |
| 401 | MISSING_API_KEY | 请求头里没有 Authorization |
| 401 | INVALID_API_KEY | Bearer 格式不对 |
| 402 | INSUFFICIENT_CREDITS | API 积分不够 |
| 404 | JOB_NOT_FOUND | 任务不存在，或不属于当前 Key |
| 409 | IDEMPOTENCY_CONFLICT | 同一个 Idempotency-Key 被用在了内容不同的请求上 |
| 413 | IMAGE_TOO_LARGE | 图片超过 50 MB |
| 422 | PROCESSING_FAILED | 抠图失败，不会扣积分 |
注意事项
- 01同一张业务图固定用一个 Idempotency-Key，重试时不要换。
- 02批量生产优先走异步 + Webhook，别长时间挂着同步请求。
- 03结果链接 24 小时后失效，拿到后尽快下载保存。
- 04Webhook 可能重复发送，按任务 ID 去重，并校验签名。