API développeur VberAI
VberAI propose une API REST HTTP pour intégrer ses capacités IA (aujourd'hui AI Super Matting) à vos apps, jeux et pipelines. Authentification par clé API + signature, codes d'erreur normalisés, facturation au crédit.
VberAI propose une API REST HTTP pour intégrer ses capacités IA (aujourd'hui AI Super Matting) à vos apps, jeux et pipelines. Authentification par clé API + signature, codes d'erreur normalisés, facturation au crédit.
Générez des images, supprimez des arrière-plans et exécutez les pipelines d'IA de VberAI directement via HTTP, avec des clés d'API personnelles ou d'entreprise.
ai-image-bg-removeSupprime l'arrière-plan d'une image et renvoie un détourage à fond transparent. Asynchrone — soumettez, puis interrogez ou attendez un webhook.
Un tarif fixe par image. Appelez l'endpoint /cost pour le montant exact.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
imageUrl | string | Oui | URL http(s) publique de l'image à traiter. C'est la seule entrée que le service accepte — il n'accepte ni base64 ni source_type. |
width | number | Non | Facultatif. Utilisé uniquement comme valeur de repli pour l'aire de facturation lorsque la résolution source ne peut pas être détectée ; ne modifie pas la sortie. |
height | number | Non | Facultatif. Utilisé uniquement comme valeur de repli pour l'aire de facturation lorsque la résolution source ne peut pas être détectée ; ne modifie pas la sortie. |
Les tâches asynchrones renvoient un taskId. Interrogez la tâche jusqu'à ce que son status atteigne une valeur terminale, puis lisez le résultat. La route que vous interrogez dépend de votre type de clé — c'est le point le plus important à ne pas manquer.
| Action | Clé personnelle | Clé d'entreprise |
|---|---|---|
| Interroger le statut de la tâche | GET /ai/tasks/{taskId} | GET /ai/org-services/tasks/{taskId} |
| Resigner de nouvelles URL de téléchargement | Lu depuis la réponse de statut | GET /ai/org-services/tasks/{taskId}/outputs |
Les clés d'entreprise doivent interroger la route /ai/org-services
Une tâche passe par ces valeurs. Arrêtez d'interroger dès que vous atteignez un status terminal : completed, failed, cancelled ou timeout.
Lorsque status vaut completed, result.assets contient les images de sortie. Chaque asset possède une url (un lien de téléchargement présigné qui expire), un mimeType et un index ; width, height, size et expiresAt apparaissent lorsqu'ils sont disponibles. Récupérez les URL rapidement — les clés d'entreprise peuvent redemander de nouveaux liens depuis l'endpoint /outputs.
Tâche terminée
{
"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"
}
}Passez un webhookUrl HTTPS public (et un webhookSecret facultatif) lorsque vous soumettez la tâche. Les clés d'entreprise les lisent au niveau supérieur du corps ; les clés personnelles les lisent depuis options.
Si vous définissez un webhookSecret, chaque livraison inclut un en-tête X-Webhook-Signature — un HMAC-SHA256 de la charge utile JSON brute, encodé en hexadécimal. Recalculez-le avec votre secret et comparez avant de faire confiance à la charge utile. Les livraisons portent aussi un X-Idempotency-Key (taskId + status) pour que vous puissiez ignorer les doublons.
/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"