📚 API 文档

首页 用户中心 价格方案

API 文档

智能抠图 API 提供高质量的图像分割服务，支持通用、人像、商品、食品等多种类型。

使用前需要注册账号并生成 API Key。所有 API 请求都需要在参数中包含有效的 API Key（格式：ak_xxx...）。

抠图 API

1. 通用分割 API

POST /api/segment-common.php

适用于大多数场景的通用图像分割，自动识别主体并去除背景。

请求参数（multipart/form-data）

参数 类型 必填 说明
image file 是 图片文件（JPG/PNG，最大 3MB）
token string 是 API Key
crop int 否 是否裁剪边缘（0=否，1=是，默认：1）

请求示例（cURL）

curl -X POST "http://kkt.jisucdr.top/api/segment-common.php" \
  -F "image=@photo.jpg" \
  -F "token=ak_your_api_key_here" \
  -F "crop=1"

请求示例（Python）

import requests

url = "http://kkt.jisucdr.top/api/segment-common.php"
files = {'image': open('photo.jpg', 'rb')}
data = {
    'token': 'ak_your_api_key_here',
    'crop': 1
}

response = requests.post(url, files=files, data=data)
result = response.json()

if result['code'] == 200:
    print("抠图成功:", result['data']['result_url'])
else:
    print("错误:", result['message'])

返回示例

{
  "code": 200,
  "message": "通用分割成功",
  "data": {
    "original_url": "https://oss.example.com/original/xxx.jpg",
    "result_url": "https://oss.example.com/result/xxx.png",
    "type": "common",
    "points_cost": 10,
    "balance_after": 490
  }
}

2. 人像分割 API

POST /api/segment-portrait.php

专门针对人像优化，适合证件照、头像等场景。

3. 商品分割 API

POST /api/segment-product.php

针对商品图片优化，适合电商场景。

4. 食品分割 API

POST /api/segment-food.php

针对食品图片优化，适合餐饮场景。

5. 高清分割 API

POST /api/segment-hd.php

支持超高分辨率（最高 9999×9999），无 3MB 限制（最大 10MB）。

所有抠图 API 的请求参数和返回格式基本相同，只需替换接口地址即可。

积分消耗

API 类型 积分消耗 说明
通用分割 10 积分/次 默认配置，可在后台调整
人像分割 10 积分/次 默认配置，可在后台调整
商品分割 10 积分/次 默认配置，可在后台调整
食品分割 10 积分/次 默认配置，可在后台调整
高清分割 20 积分/次 默认配置，可在后台调整
每次调用都会扣除相应积分，请确保账户余额充足。扣费仅在抠图成功后执行。

错误码说明

错误码 说明 解决方案
400 请求参数错误 检查参数格式和必填项
401 认证失败 检查 API Key 是否有效
403 权限不足 检查 API Key 是否被禁用
405 请求方法不允许 使用正确的 HTTP 方法
429 频率超限 降低调用频率或提升 rate_limit
500 服务器错误 联系技术支持

常见错误消息