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:
- Hur du ställer in din utvecklingsmiljö
- Några av de grundläggande koncepten i Autoderm API
- Hur du skickar din första API-förfrågan
- Tolka AI-resultat för medicinska applikationer
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.