API 文档

通过API接口，将PicGenius强大的AI图片处理能力集成到您的应用中。支持智能抠图、背景替换、图片放大、人脸修复等功能。

简介

PicGenius API 提供简单易用的 RESTful 接口，让您可以在自己的应用程序中使用我们的AI图片处理功能。

核心特性

行业领先AI模型 - 使用BiRefNet+U2-Net双模型融合，边缘处理精细
高清输出 - 支持最高4K分辨率输出，图片不压缩
多格式支持 - 支持PNG、JPG、WebP等主流格式
快速响应 - GPU加速，平均处理时间<2秒

认证

所有API请求都需要在Header中携带您的API Key进行认证。

HTTP Header

Authorization: Bearer YOUR_API_KEY

您可以在控制台的「API管理」页面创建和管理您的API Key。请妥善保管，不要泄露给他人。

快速开始

以下示例展示如何使用API进行智能抠图：

cURL

curl -X POST "https://api.picgenius.com/v1/remove-bg" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@/path/to/image.jpg" \
  -F "format=png" \
  -o result.png

Python

import requests

# 设置API Key
headers = {"Authorization": "Bearer YOUR_API_KEY"}

# 上传图片并抠图
with open("image.jpg", "rb") as f:
    response = requests.post(
        "https://api.picgenius.com/v1/remove-bg",
        headers=headers,
        files={"image": f},
        data={"format": "png"}
    )

# 保存结果
with open("result.png", "wb") as f:
    f.write(response.content)

智能抠图

自动识别图片主体并去除背景，返回透明背景的PNG图片。

POST /v1/remove-bg

请求参数

参数	类型	必填	说明
image	file	必填	要处理的图片文件，支持JPG/PNG/WebP
model	string		使用的模型：birefnet（精细）/ u2net（快速），默认birefnet
format	string		输出格式：png / webp，默认png
alpha_matting	boolean		是否启用Alpha精修（处理毛发边缘），默认false

响应

成功时直接返回处理后的图片二进制数据。

单张图片大小限制为25MB，推荐使用分辨率不超过4096x4096的图片以获得最佳性能。

错误处理

当请求失败时，API会返回JSON格式的错误信息：

错误码	说明
400	请求参数错误
401	未授权，API Key无效
402	额度不足
413	图片文件过大
429	请求过于频繁
500	服务器内部错误

速率限制

为保证服务稳定性，API有以下速率限制：

基础版 - 10次/分钟，100次/小时
专业版 - 30次/分钟，500次/小时
企业版 - 自定义配额，联系销售