Démarrage rapide

L'API Autoderm fournit une interface simple pour les développeurs afin de créer une couche intelligente dans leurs applications, alimentée par les modèles d'IA d'Autoderm. Les points de terminaison d'inférence de l'API offrent un moyen simple de prendre une image et d'utiliser nos modèles d'IA pour générer une sortie des affections cutanées les plus probables.

Création de compte

Tout d'abord, créez un compte Autoderm ou connectez-vous. Ensuite, accédez à votre espace personnel pour obtenir votre clé d'API secrète. Veillez à la conserver en sécurité et à ne pas la partager avec quiconque.

Sélection du langage de programmation

L'API Autoderm suit les principes REST et peut être intégrée à partir de n'importe quel langage. Pour des exemples dans différents langages de programmation sur l'utilisation de notre API, vous pouvez consulter nos Exemples Redoc. Dans la plupart des exemples ici, nous utiliserons Python, qui est un langage de programmation populaire couramment utilisé pour les applications de données, le développement web et de nombreuses autres tâches de programmation en raison de sa facilité d'utilisation.

N'hésitez pas à nous faire part de vos besoins si vous souhaitez des exemples dans un autre langage.

Configuration de votre clé d'API

Dans votre espace personnel, vous pouvez récupérer votre clé d'API. Aux fins de ces exemples, supposons que notre clé d'API soit :

Pk566ZkEQRLr9vNwo2Gkr1uL6pr-4VjZUkvdJHAdFsA

Configuration de la clé d'API dans votre environnement

Stocker votre clé d'API dans une variable d'environnement est une pratique sécurisée. Voici comment procéder sur différents systèmes d'exploitation :

macOS et Linux

Ouvrez votre terminal et saisissez la commande suivante :

export AUTODERM_API_KEY='Votre-Clé-API-Ici'

Cela définira la clé d'API pour votre session actuelle. Pour la rendre permanente, ajoutez la ligne à votre fichier ~/.bashrc ou ~/.zshrc.

Windows

Sous Windows, vous pouvez définir une variable d'environnement via la ligne de commande :

set AUTODERM_API_KEY=Votre-Clé-API-Ici

Pour une solution permanente, définissez-la via 'Propriétés système' > 'Variables d'environnement'.

Utilisation de la clé d'API dans votre application

Il est courant d'utiliser un fichier .env dans votre projet pour gérer les variables d'environnement. Voici un exemple :

AUTODERM_API_KEY='Votre-Clé-API-Ici'

Veillez à ajouter le fichier .env à votre .gitignore pour empêcher qu'il soit envoyé au contrôle de version.

Une fois définie, vous pouvez accéder à la clé d'API dans votre application en utilisant la méthode appropriée pour votre langage de programmation ou votre framework.

Envoyer votre première requête API

Une fois que vous avez configuré votre clé d'API, l'étape finale consiste à envoyer une requête API. Pour ce faire, si vous utilisez Python dans cet exemple, créez un fichier nommé python_requests.py à l'aide du terminal ou d'un IDE. Idéalement, disposez d'une image d'une affection cutanée dans le même dossier nommée skin.jpg pour la tester.

Dans le fichier, copiez et collez l'exemple Python ci-dessous :

                import requests
                import os

                API_URL = "https://autoderm.ai/v1/query"

                # set sensitive data as environment variables
                API_KEY = os.getenv("AUTODERM_API_KEY")

                # open the test image and read the bytes
                with open("skin.jpg", "rb") as f:
                    image_contents = f.read()

                # send the query
                response = requests.post(
                    API_URL,
                    headers={{"Api-Key": API_KEY}},
                    files={{"file": image_contents}},
                    params={{"language": "en", "model": "autoderm_v2_2"}},
                )

                # get the JSON data returned
                data = response.json()

                print(data)

                # get only the predictions
                predictions = data["predictions"]

                print(predictions)

            

Pour exécuter le script :

AUTODERM_API_KEY=VotreVraieCléAPI python3 python_requests.py

Le résultat est un contenu JSON contenant les prédictions classées dans l'ordre en fonction de leurs probabilités. Elles incluent également leurs codes ICD-10, les noms médicaux et courants de l'affection, ainsi que des liens pour en savoir plus sur la maladie.

Étapes suivantes

Découvrez notre sélection de modèles et testez-les pour débloquer de nouvelles capacités en dermatologie. Pour plus d'exemples et de détails sur l'API et les modèles, consultez notre page Redoc.