Snabbstart

Kom igång med Autoderm API

Letar du efter att använda modellerna från din webbläsare? Gå till modellgränssnittet.

Autoderm API erbjuder ett enkelt gränssnitt för utvecklare att skapa en intelligent lager i sina applikationer, drivet av Autoderms AI-modeller. API:ets slutpunkter för slutledning ger ett enkelt sätt att ta en bild och använda våra AI-modeller för att generera en utdata av de mest troliga hudtillstånden.

Den här snabbstarten syftar till att hjälpa dig att ställa in din lokala utvecklingsmiljö och skicka din första API-förfrågan. Om du är en erfaren utvecklare eller bara vill dyka in i att använda API:et, är Redoc API-referensen en bra plats att börja. Under den här snabbstarten kommer du att lära dig:

Om du stöter på några utmaningar eller har frågor när du kommer igång, var vänlig kontakta oss.

Skapa konto

Först, skapa ett Autoderm-konto eller logga in. Sedan navigerar du till din personliga yta för att hämta din hemliga API-nyckel. Se till att hålla den säker och dela den inte med någon.

Val av programmeringsspråk

Autoderm API följer REST-principer och kan integreras från alla språk. För exempel på olika programmeringsspråk på hur man använder vårt API, kan du kontrollera våra Redoc-exempel. I de flesta exemplen här kommer vi att använda Python, som är ett populärt programmeringsspråk som vanligtvis används för dataapplikationer, webbutveckling och många andra programmeringsuppgifter på grund av dess enkelhet i användning.

Känn dig fri att låta oss veta om du vill ha exempel på ett annat språk.

Ställa in din API-nyckel

I din personliga yta kan du hämta din API-nyckel. För syfte av dessa exempel, låt oss antaga att vår API-nyckel är:

Pk566ZkEQRLr9vNwo2Gkr1uL6pr-4VjZUkvdJHAdFsA

Ställa in API-nyckeln i din miljö

Att lagra din API-nyckel i en miljövariabel är en säker praxis. Så här ställer du in den på olika operativsystem:

macOS och Linux

Öppna din terminal och ange följande kommando:

export AUTODERM_API_KEY='Ditt-API-Nyckel-Här'

Detta kommer att ställa in API-nyckeln för din nuvarande session. För att göra det permanent, lägg till raden i din ~/.bashrc eller ~/.zshrc fil.

Windows

På Windows kan du ställa in en miljövariabel genom kommandoraden:

set AUTODERM_API_KEY=Ditt-API-Nyckel-Här

För en permanent lösning, ställ in den via 'Systemegenskaper' > 'Miljövariabler'.

Använda API-nyckeln i din applikation

Det är vanligt att använda en .env fil i ditt projekt för att hantera miljövariabler. Här är ett exempel:

AUTODERM_API_KEY='Ditt-API-Nyckel-Här'

Se till att lägga till .env filen i din .gitignore för att förhindra att den sparas i versionshanteringen.

När den är inställd, kan du komma åt API-nyckeln i din applikation med hjälp av den lämpliga metoden för ditt programmeringsspråk eller ramverk.

Skicka din första API-förfrågan

När du har ställt in ditt API-nyckel, är det sista steget att skicka en API-förfrågan. Om du använder python i det här exemplet, skapa en fil som heter python_requests.py med hjälp av terminalen eller en IDE. Idealt sett, ska du ha en bild av en hudsjukdom i samma mapp som heter skin.jpg för att testa den.

Inuti filen, kopiera och klistra in python-exemplet nedan:

            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)

        

För att köra skriptet:

AUTODERM_API_KEY=DittFaktiskaAPIKey python3 python_requests.py

Resultatet är en JSON-innehållstyp som innehåller förutsägelserna sorterade i ordning baserat på deras sannolikheter. De innehåller också deras ICD-10-koder, medicinska och lekmänsnamn på tillståndet, samt länkar för att läsa mer om sjukdomen.

Nästa steg

Hoppa till vårt urval av modeller och testa dem för att låsa upp nya krafter inom dermatologi. För fler exempel och information om API:t och modellerna, se vår Redoc-sida.