API для разработчиков VberAI
VberAI предоставляет REST HTTP API, чтобы встраивать AI-возможности (сегодня — AI Super Matting) в приложения, игры и пайплайны. Аутентификация по ключу + подписи, единые коды ошибок, оплата по кредитам.
VberAI предоставляет REST HTTP API, чтобы встраивать AI-возможности (сегодня — AI Super Matting) в приложения, игры и пайплайны. Аутентификация по ключу + подписи, единые коды ошибок, оплата по кредитам.
Генерируйте изображения, удаляйте фон и запускайте AI-конвейеры VberAI прямо по HTTP — с личными или корпоративными 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 — HMAC-SHA256 сырого JSON-payload в шестнадцатеричном представлении. Пересчитайте его с вашим секретом и сравните, прежде чем доверять payload. Доставки также несут 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"