VberAI 开发者 API
VberAI 提供 RESTful HTTP API,把 AI 超强抠图等能力嵌入到你的应用、游戏与自动化流程。使用 API Key + 签名鉴权,统一错误码,按积分按次计费。
VberAI 提供 RESTful HTTP API,把 AI 超强抠图等能力嵌入到你的应用、游戏与自动化流程。使用 API Key + 签名鉴权,统一错误码,按积分按次计费。
通过 HTTP 直接调用 VberAI 的 AI 能力——生成图片、去除背景、运行各类 AI 管线,支持个人与企业 API 密钥。
ai-image-bg-remove去除图片背景,返回透明背景的抠图。异步服务——提交后轮询或等待 webhook。
每张图片固定收费。调用 /cost 端点获取精确金额。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
imageUrl | string | 是 | 待处理图片的公网 http(s) URL。这是该服务唯一的输入——不接受 base64,也没有 source_type。 |
width | number | 否 | 可选。仅在无法探测源图分辨率时用作计费面积兜底,不影响出图。 |
height | number | 否 | 可选。仅在无法探测源图分辨率时用作计费面积兜底,不影响出图。 |
异步任务返回一个 taskId。轮询任务直到状态进入终态,再读取结果。轮询哪条路由取决于你的密钥类型——这一点最关键,务必用对。
| 操作 | 个人密钥 | 企业密钥 |
|---|---|---|
| 轮询任务状态 | GET /ai/tasks/{taskId} | GET /ai/org-services/tasks/{taskId} |
| 重新签发新鲜下载 URL | 从状态响应中读取 | GET /ai/org-services/tasks/{taskId}/outputs |
企业密钥必须轮询 /ai/org-services 路由
任务会在这些状态间流转。一旦进入终态即停止轮询:completed、failed、cancelled 或 timeout。
当状态为 completed 时,result.assets 承载输出图片。每个 asset 含 url(预签名下载链接,会过期)、mimeType 与 index;width、height、size、expiresAt 在可得时才有。请及时获取 URL——企业密钥可从 /outputs 端点重新申请新鲜链接。
已完成的任务
{
"success": true,
"data": {
"taskId": "6a97e277a148c970dd545f40",
"serviceCode": "ai-image-bg-remove",
"status": "completed",
"creditsEstimated": 10,
"creditsActual": 10,
"outputCount": 1,
"result": {
"type": "images",
"assets": [
{
"index": 0,
"url": "https://assets.vberai.org/tmp/user-assets/.../0.png?signature=...",
"mimeType": "image/png",
"expiresAt": "2026-01-22T10:30:12.000Z"
}
]
},
"completedAt": "2026-01-15T10:30:12.000Z"
}
}提交任务时传入一个公网 HTTPS 的 webhookUrl(以及可选的 webhookSecret)。企业密钥从请求体顶层读取这两个字段;个人密钥从 options 中读取。
若设置了 webhookSecret,每次投递都带一个 X-Webhook-Signature 头——对原始 JSON 负载做 HMAC-SHA256 并十六进制编码。用你的 secret 重新计算并比对,通过后再信任负载。投递还带 X-Idempotency-Key(taskId + status),便于忽略重复。
/ai/services/ai-image-bg-remove/executecurl -X POST https://api.vberai.com/api/ai/services/ai-image-bg-remove/execute \
-H "X-API-Key: vber_sk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"input": {"imageUrl": "https://example.com/photo.png"}}'curl https://api.vberai.com/api/ai/tasks/{taskId} \
-H "X-API-Key: vber_sk_YOUR_KEY"