Documentation API — VisionLabs

Authentification

Toutes les requêtes doivent inclure votre clé API dans l'en-tête Authorization. Vous pouvez générer et révoquer vos clés depuis le tableau de bord VisionLabs.

HTTP

Authorization: Bearer vl_your_api_key

POST /v1/classify

Classifiez une image en lui attribuant le label le plus probable ainsi qu'un score de confiance.

Paramètres

Champ	Type	Requis	Description
`image_url`	string	non*	URL publique de l'image à classifier.
`image_base64`	string	non*	Image encodée en base64 (JPEG/PNG/WebP/TIFF).
`model`	string	non	Identifiant du modèle. Défaut : `general-v2`.
`top_k`	integer	non	Nombre de labels retournés. Défaut : 1, max : 10.

* Vous devez fournir image_url ou image_base64, mais pas les deux.

Réponse

JSON

{
  "label": "electronics/smartphone",
  "confidence": 0.982,
  "inference_time_ms": 87,
  "model": "general-v2"
}

Formats supportés

JPEG, PNG, WebP, TIFF
Taille maximale : 20 Mo par image
Résolution recommandée : entre 256×256 et 4096×4096 pixels
Redimensionnement et normalisation automatiques côté serveur

Exemples

cURL

curl -X POST https://api.visionlabs.ai/v1/classify \
  -H "Authorization: Bearer vl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://example.com/photo.jpg"}'

Python

import requests

url = "https://api.visionlabs.ai/v1/classify"
headers = {"Authorization": "Bearer vl_your_api_key"}
payload = {"image_url": "https://example.com/photo.jpg"}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Tester l'API

Créez un compte gratuit pour obtenir une clé API Starter. Aucune carte de crédit n'est requise pour les 1 000 premières requêtes mensuelles.

Demander une clé API

Codes de retour

Code	Signification
200	Classification réussie.
400	Requête invalide : paramètre manquant ou format non supporté.
401	Clé API manquante ou invalide.
429	Limite de débit atteinte.
500	Erreur interne. Réessayez dans quelques instants.