VberAI 開発者 API
VberAI は AI スーパー切り抜きなどの機能をアプリ、ゲーム、自動化パイプラインに組み込める RESTful HTTP API を提供します。API キーと署名による認証、統一されたエラーコード、クレジット課金で従量制です。
VberAI は AI スーパー切り抜きなどの機能をアプリ、ゲーム、自動化パイプラインに組み込める RESTful HTTP API を提供します。API キーと署名による認証、統一されたエラーコード、クレジット課金で従量制です。
画像の生成、背景の除去、VberAI の AI パイプラインの実行を、個人またはエンタープライズの API キーで HTTP から直接行えます。
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 を 16 進エンコードしたものです。あなたの 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"