Inici ràpid

Posa't en marxa amb l'API d'Autoderm

Voleu utilitzar els models des del vostre navegador web? Aneu a la interfície del model.

L'API d'Autoderm proporciona una interfície senzilla perquè els desenvolupadors creïn una capa intel·ligent a les seves aplicacions, impulsada pels models d'IA d'Autoderm. Els extrems de inferència de l'API proporcionen una manera senzilla de prendre una imatge i utilitzar els nostres models d'IA per generar una sortida de les condicions cutànies més probables.

Aquest inici ràpid té com a objectiu ajudar el vostre entorn de desenvolupament local a configurar-se i enviar la vostra primera sol·licitud d'API. Si sou un desenvolupador experimentat o simplement voleu submergir-vos en l'ús de l'API, la referència de l'API de Redoc és un bon lloc per començar. Al llarg d'aquest inici ràpid, aprendreu:

Com configurar el vostre entorn de desenvolupament
Alguns dels conceptes bàsics de l'API d'Autoderm
Com enviar la vostra primera sol·licitud d'API
Interpretació de resultats d'IA per a aplicacions mèdiques

Si trobeu algun repte o teniu preguntes per començar, no dubteu a posar-vos en contacte amb nosaltres.

Creació de compte

En primer lloc, creeu un compte d'Autoderm o inicieu sessió. A continuació, navegueu fins al vostre espai personal per obtenir la vostra clau d'API secreta. Assegureu-vos de mantenir-la segura i no la compartiu amb ningú.

Selecció del llenguatge de programació

L'API d'Autoderm segueix els principis REST i es pot integrar des de qualsevol llenguatge. Per exemple, en diferents llenguatges de programació sobre com utilitzar la nostra API, podeu comprovar els nostres Exemples de Redoc. En la majoria d'exemples, utilitzarem Python, que és un llenguatge de programació popular que es fa servir habitualment per a aplicacions de dades, desenvolupament web i moltes altres tasques de programació a causa de la seva facilitat d'ús.

No dubteu a demanar-nos exemples en un altre llenguatge si us plau.

Configuració de la vostra clau d'API

A el vostre espai personal, podeu recuperar la vostra clau d'API. Per als propòsits d'aquests exemples, suposem que la nostra clau d'API és:

Pk566ZkEQRLr9vNwo2Gkr1uL6pr-4VjZUkvdJHAdFsA

Configuració de la clau d'API al vostre entorn

Emmagatzemar la vostra clau d'API en una variable d'entorn és una bona pràctica. Aquí teniu com configurar-la en diferents sistemes operatius:

macOS i Linux

Obriu el terminal i introduïu el següent comando:

export AUTODERM_API_KEY='Your-API-Key-Here'

Això configurarà la clau d'API per a la vostra sessió actual. Per fer-la permanent, afegiu la línia al vostre fitxer /.bashrc o /.zshrc.

Windows

A Windows, podeu configurar una variable d'entorn a través de la línia d'ordres:

set AUTODERM_API_KEY=Your-API-Key-Here

Per a una solució permanent, configureu-la a 'Propietats del sistema' > 'Variables d'entorn'.

Ús de la clau d'API a la vostra aplicació

És habitual utilitzar un fitxer .env al vostre projecte per gestionar les variables d'entorn. Aquí teniu un exemple:

AUTODERM_API_KEY='Your-API-Key-Here'

Assegureu-vos d'afegir el fitxer .env al vostre .gitignore per evitar que es comprometi amb el control de versions.

Un cop configurat, podeu accedir a la clau d'API a la vostra aplicació utilitzant el mètode adequat per al vostre llenguatge de programació o marc de treball.

Envieu la vostra primera sol·licitud d'API

Un cop tingueu configurada la vostra clau d'API, l'últim pas és enviar una sol·licitud d'API. Per fer-ho, si utilitzeu Python en aquest exemple, creeu un fitxer anomenat python_requests.py utilitzant el terminal o un IDE. Idealment, tingueu una imatge d'una condició de la pell a la mateixa carpeta anomenada skin.jpg per provar-la.

Dins del fitxer, còpia i enganxa l'exemple de Python següent:

                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)

Per executar el script:

AUTODERM_API_KEY=YourActualAPIKey python3 python_requests.py

El resultat és un contingut JSON que conté les prediccions classificades en ordre segons les seves probabilitats. També conté els seus codis ICD-10, els noms mèdics i populars de la condició, així com enllaços per llegir més sobre la malaltia.

Passos següents

Salti a la nostra selecció de models i provi'ls per desbloquejar nous poders en dermatologia. Per a més exemples i detalls sobre l'API i els models, consulteu la nostra pàgina de Redoc.

Comença

Guies