VberAI 開発者 API

VberAI は AI スーパー切り抜きなどの機能をアプリ、ゲーム、自動化パイプラインに組み込める RESTful HTTP API を提供します。API キーと署名による認証、統一されたエラーコード、クレジット課金で従量制です。

API v1
安定版

API ドキュメント

画像の生成、背景の除去、VberAI の AI パイプラインの実行を、個人またはエンタープライズの API キーで HTTP から直接行えます。

背景除去

ai-image-bg-remove

画像から背景を除去し、背景が透明な切り抜きを返します。非同期——送信してから、ポーリングするか webhook を待ちます。

料金

画像ごとの定額課金です。正確な金額は /cost エンドポイントを呼び出してください。

パラメータ

パラメータ型必須説明
imageUrlstringはい処理する画像の公開された http(s) URL。これはこのサービスが受け取る唯一の入力です——base64 や source_type は受け付けません。
widthnumberいいえ任意。ソースの解像度を検出できない場合の課金面積のフォールバックとしてのみ使われ、出力は変わりません。
heightnumberいいえ任意。ソースの解像度を検出できない場合の課金面積のフォールバックとしてのみ使われ、出力は変わりません。

ポーリングと結果

非同期ジョブは taskId を返します。ステータスが終端の値になるまでタスクをポーリングし、それから結果を読み取ります。ポーリングするルートはキーの種類によって決まります——これは正しく行うべき最も重要な点です。

アクション個人キーエンタープライズキー
タスクのステータスをポーリングGET /ai/tasks/{taskId}GET /ai/org-services/tasks/{taskId}
新しいダウンロード URL を再署名ステータスレスポンスから読み取るGET /ai/org-services/tasks/{taskId}/outputs

エンタープライズキーは /ai/org-services ルートをポーリングする必要があります

エンタープライズキー(vber_org_sk_)を個人用の /ai/tasks ルートに送ると 401 INVALID_API_KEY が返ります——個人用ルートは個人キーのみを受け付けます。エンタープライズのジョブは常に /ai/org-services/tasks/{taskId} でポーリングしてください。cancel と batch-status は個人キー専用です。

タスクはこれらの値を経て遷移します。終端ステータスに達したらポーリングを停止してください:completed、failed、cancelled、timeout。

createdqueueddispatchingsubmittedprocessingcompletedfailedcancelledtimeout

status が completed のとき、result.assets が出力画像を保持します。各 asset には url(期限付きの署名済みダウンロードリンク)、mimeType、index が含まれ、width、height、size、expiresAt は取得できる場合に現れます。URL は速やかに取得してください——エンタープライズキーは /outputs エンドポイントから新しいリンクを再取得できます。

完了すると、result.assets が背景が透明な切り抜き画像を保持します。

完了したタスク

json
{
  "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"
  }
}

Webhook

ジョブを送信する際に、公開された HTTPS の webhookUrl(および任意の webhookSecret)を渡します。エンタープライズキーはこれらをボディのトップレベルから読み取り、個人キーは options から読み取ります。

webhookSecret を設定した場合、各配信には X-Webhook-Signature ヘッダーが含まれます——生の JSON ペイロードの HMAC-SHA256 を 16 進エンコードしたものです。あなたの secret で再計算して比較し、確認できてからペイロードを信頼してください。配信には X-Idempotency-Key(taskId + status)も付くため、重複を無視できます。

POST/ai/services/ai-image-bg-remove/execute
bash
curl -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"}}'
bash
curl https://api.vberai.com/api/ai/tasks/{taskId} \
  -H "X-API-Key: vber_sk_YOUR_KEY"