VberAI 開発者 API
VberAI は AI スーパー切り抜きなどの機能をアプリ、ゲーム、自動化パイプラインに組み込める RESTful HTTP API を提供します。API キーと署名による認証、統一されたエラーコード、クレジット課金で従量制です。
VberAI は AI スーパー切り抜きなどの機能をアプリ、ゲーム、自動化パイプラインに組み込める RESTful HTTP API を提供します。API キーと署名による認証、統一されたエラーコード、クレジット課金で従量制です。
画像の生成、背景の除去、VberAI の AI パイプラインの実行を、個人またはエンタープライズの API キーで HTTP から直接行えます。
super-matting被写体を背景から分離し、きれいなマッティング結果を返す高品質な切り抜きです。非同期——送信してから、ポーリングするか webhook を待ちます。
出力の最長辺で価格が決まります(寸法の段階——たとえば 512 px は 2 クレジット、1024 px は 10 クレジット)。ジョブを実行する前に /cost エンドポイントを呼び出して正確な金額を取得してください。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
source_type | string | はい | "url"(input_value は公開された http(s) 画像 URL)または "base64"(input_value は base64 文字列または data: URL)のいずれか。 |
input_value | string | はい | ソース画像:source_type が "url" のときは http(s) URL、"base64" のときは base64 画像データ。 |
width | number | はい | ターゲットの幅(ピクセル、64–2048)。 |
height | number | はい | ターゲットの高さ(ピクセル、64–2048)。 |
seed | number | いいえ | 任意。再現可能な出力のための固定整数 seed。省略時はランダムな seed が使われます。 |
非同期ジョブは 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": "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"
}
}ジョブを送信する際に、公開された HTTPS の webhookUrl(および任意の webhookSecret)を渡します。エンタープライズキーはこれらをボディのトップレベルから読み取り、個人キーは options から読み取ります。
webhookSecret を設定した場合、各配信には X-Webhook-Signature ヘッダーが含まれます——生の JSON ペイロードの HMAC-SHA256 を 16 進エンコードしたものです。あなたの secret で再計算して比較し、確認できてからペイロードを信頼してください。配信には X-Idempotency-Key(taskId + status)も付くため、重複を無視できます。
/ai/services/super-matting/executecurl -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
}
}'curl https://api.vberai.com/api/ai/tasks/{taskId} \
-H "X-API-Key: vber_sk_YOUR_KEY"