我的工作空间
管理你的积分、资料与 API 接入。
个人资料
设置头像、昵称与联系邮箱。
JPG / PNG / WebP · 最大 2 MB、400 万像素
上传后居中裁剪为正方形，仅自己登录后可访问。
API 密钥
每个应用使用独立密钥，方便管理与撤销。
抠图接口 · POST
完整密钥仅在生成时显示一次。密钥共享账号积分；撤销立即生效，历史调用记录保留。
| 名称 / 密钥前缀 | 权限 | 状态 / 有效期 | 最近使用 | 操作 |
|---|
最多保留 20 个密钥。权限与有效期受管理员配置约束，不可通过新建密钥增加积分。
几行代码，开始抠图。
两种处理方式，共用一个接口。
1. 生成你的密钥
在 API 密钥 页面生成并保存密钥，将它存入应用服务器的环境变量 CUTOUT_API_KEY，通过请求头 X-API-Key 传入。
2. 选择处理方式
mode=local：本机快速高质量处理。mode=ai：本机处理后由大模型指导精修，耗时更长。上传字段为 image，格式 JPG / PNG / WebP，最大 15 MB / 1600 万像素。
cURL
Python · requests
3. 读取结果与积分
成功返回透明 PNG 二进制，可直接保存。output=mask 返回灰度蒙版。响应头 X-Credits-Charged 表示本次扣除积分，X-Request-ID 用于排查问题。
使用同一密钥请求 可查询余额和调用记录。失败不扣费；客户端超时不代表服务器失败，重试前应核对记录。
| 状态码 | 处理方式 |
|---|---|
| 401 / 403 | 检查密钥是否有效、权限是否允许。 |
| 402 | 积分不足，购买套餐后继续。 |
| 413 / 422 | 检查图片大小、格式和请求参数。 |
| 503 | 服务繁忙，按 Retry-After 延迟重试。 |
| 500 / 502 | 处理或模型渠道异常，保留请求 ID 以便排查。 |