VberAI 開発者 API

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

API v1
安定版

API ドキュメント

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

スーパーマッティング

super-matting

被写体を背景から分離し、きれいなマッティング結果を返す高品質な切り抜きです。非同期——送信してから、ポーリングするか webhook を待ちます。

料金

出力の最長辺で価格が決まります(寸法の段階——たとえば 512 px は 2 クレジット、1024 px は 10 クレジット)。ジョブを実行する前に /cost エンドポイントを呼び出して正確な金額を取得してください。

パラメータ

パラメータ型必須説明
source_typestringはい"url"(input_value は公開された http(s) 画像 URL)または "base64"(input_value は base64 文字列または data: URL)のいずれか。
input_valuestringはいソース画像:source_type が "url" のときは http(s) URL、"base64" のときは base64 画像データ。
widthnumberはいターゲットの幅(ピクセル、64–2048)。
heightnumberはいターゲットの高さ(ピクセル、64–2048)。
seednumberいいえ任意。再現可能な出力のための固定整数 seed。省略時はランダムな seed が使われます。

ポーリングと結果

非同期ジョブは 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": "super-matting",
    "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/super-matting/execute
bash
curl -X POST https://api.vberai.com/api/ai/services/super-matting/execute \
  -H "X-API-Key: vber_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "source_type": "url",
      "input_value": "https://example.com/photo.png",
      "width": 1024,
      "height": 768
    }
  }'
bash
curl https://api.vberai.com/api/ai/tasks/{taskId} \
  -H "X-API-Key: vber_sk_YOUR_KEY"