VberAI 開發者 API
VberAI 提供 RESTful HTTP API,將 AI 超強去背等能力嵌入到你的應用、遊戲與自動化流程。使用 API Key + 簽章驗證,統一錯誤碼,按點數計費。
VberAI 提供 RESTful HTTP API,將 AI 超強去背等能力嵌入到你的應用、遊戲與自動化流程。使用 API Key + 簽章驗證,統一錯誤碼,按點數計費。
透過 HTTP 直接生成圖片、去除背景並執行 VberAI 的 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。
當 status 為 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"