概览
理解 API 响应
ByByBG API 使用标准 HTTP 状态码来表示成功处理、错误、上传限制和速率限制。
提示：
在生产环境中，请始终实施适当的错误处理机制，以确保稳定的用户体验。
STATUS CODES
常见 HTTP 状态码
Code
Description
200
背景移除成功完成。
400
请求无效或缺少图片文件。
401
缺少 API 密钥或 API 密钥无效。
403
访问被拒绝。
413
上传的图片文件过大。
415
不支持的图片格式。
429
请求过于频繁，已超出速率限制。
500
服务器内部处理错误。
503
服务暂时不可用。
LIMITS
上传限制
- 最大图片大小：10MB
- 支持格式：PNG、JPG、JPEG、WEBP
- 透明输出格式：PNG
- API 请求可能受速率限制约束。
- 较大的图片可能需要更长的处理时间。
TROUBLESHOOTING
常见问题与解决方案
无效 API 密钥
请检查您的 API 密钥和请求头设置。
图片过大
上传前压缩或调整图片大小。
网络错误
检查您的互联网连接和后端服务器状态。
超出速率限制
减少请求频率或升级您的套餐。
BEST PRACTICES
生产环境最佳实践
- 为失败请求实现自动重试机制。
- 向用户显示清晰易懂的错误信息。
- 发送前验证上传文件。
- 预先压缩大型图片。
- 尽可能缓存成功响应。
- 监控 API 使用情况和速率限制。
ERROR RESPONSE
错误 JSON 响应示例
{
"success": false,
"error": "Invalid API key"
}文档完成
现在您已经准备好将 ByByBG API 集成到网站、移动应用、SaaS 平台和自动化系统中了。