Hoppa till huvudinnehåll
Denna artikel kommer att introducera en anslutning till ansiktsförbättrings-API, som kan exakt lokalisera ansiktsdrag genom att användaren laddar upp en bild av sitt ansikte (maximalt kan den hantera information om fem ansikten i en bild) och uppnå funktioner som hudförbättring, ljusare hud, aknebehandling och andra skönhetsfunktioner.

​
Ansökningsprocess

För att använda API:et måste du först gå till ansiktsförbättrings-API motsvarande sida för att ansöka om den tjänst som behövs. När du kommer till sidan, klicka på knappen “Acquire”, som visas i bilden nedan: Om du inte har loggat in eller registrerat dig kommer du automatiskt att omdirigeras till inloggningssidan där du blir inbjuden att registrera dig och logga in. Efter att ha loggat in eller registrerat dig kommer du automatiskt att återvända till den aktuella sidan. Vid första ansökan kommer det att finnas en gratis kvot som ges, så att du kan använda API:et gratis.

​
Grundläggande användning

Först bör du förstå den grundläggande användningsmetoden, vilket innebär att du anger en bildlänk och skönhetsinformation för att få den bearbetade resultatbilden. Först behöver du enkelt överföra ett image_url-fält, ansiktsbilden visas nedan:

Sedan behöver vi också ladda upp parametrarna för ansiktsförbättringsinformationen, se specifikt nedan för begärningskroppens information. Vi kan sedan fylla i motsvarande innehåll på gränssnittet, som visas i bilden nedan:

Här kan vi se att vi har ställt in begärningshuvuden, inklusive:
  • accept: vilken format av svar du vill ta emot, här anges som application/json, det vill säga JSON-format.
  • authorization: nyckeln för att anropa API:et, efter ansökan kan du direkt välja från rullgardinsmenyn.
Dessutom har vi ställt in begärningskroppen, inklusive:
  • image_url: länken till den ansiktsbild som ska bearbetas.
  • smoothing: graden av hudslätning, värdeintervallet [0,100]. 0 betyder ingen slätning, 100 representerar högsta graden. Standardvärde 10.
  • whitening: graden av hudblekning, värdeintervallet [0,100]. 0 betyder ingen blekning, 100 representerar högsta graden. Standardvärde 30.
  • face_lifting: graden av ansiktslyft, värdeintervallet [0,100]. 0 betyder inget lyft, 100 representerar högsta graden. Standardvärde 70.
  • eye_enlarging: graden av ögonförstoring, värdeintervallet [0,100]. 0 betyder ingen förstoring, 100 representerar högsta graden. Standardvärde 70.
När du har valt kan du se att motsvarande kod också genererades till höger, som visas i bilden nedan:

Klicka på knappen “Try” för att testa, som visas i bilden ovan, här får vi följande resultat: 
{
  "image_url": "https://faceeffect-1254418846.cos.ap-guangzhou.myqcloud.com/fmu/BeautifyPic/1256437459/1a68c13b-b03c-4c7b-92a1-e4a9b5f1d7ec"
}
Som du kan se finns det ett image_url-fält i det returnerade resultatet, vilket är den bearbetade ansiktsbilden baserat på den angivna skönhetsinformationen. Den förändrade ansiktsinformationen visas nedan:

Du kan se att ansiktet i bilden har förändrats baserat på den angivna skönhetsinformationen. Om du vill generera motsvarande anslutningskod kan du direkt kopiera den som genererats, till exempel CURL-koden nedan: 
curl -X POST 'https://api.acedata.cloud/face/beautify' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg",
  "smoothing": 50,
  "whitening": 50,
  "face_lifting": 50,
  "eye_enlarging": 50
}'
Python-anslutningskoden ser ut så här: 
import requests

url = "https://api.acedata.cloud/face/beautify"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg",
    "smoothing": 50,
    "whitening": 50,
    "face_lifting": 50,
    "eye_enlarging": 50
}

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

​
Felhantering

När du anropar API:et, om du stöter på fel, kommer API:et att returnera motsvarande felkod och information. Till exempel:
  • 400 token_mismatched: Bad request, möjligtvis på grund av saknade eller ogiltiga parametrar.
  • 400 api_not_implemented: Bad request, möjligtvis på grund av saknade eller ogiltiga parametrar.
  • 401 invalid_token: Unauthorized, ogiltig eller saknad auktoriseringstoken.
  • 429 too_many_requests: För många begärningar, du har överskridit hastighetsgränsen.
  • 500 api_error: Intern serverfel, något gick fel på servern.

​
Exempel på felrespons

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Slutsats

Genom detta dokument har du fått en förståelse för hur man använder ansiktsförbättrings-API för att bearbeta en bild av ett ansikte som användaren laddar upp (maximalt kan den hantera information om fem ansikten i en bild), exakt lokalisera ansiktsdrag och uppnå funktioner som hudförbättring, ljusare hud, aknebehandling och andra skönhetsfunktioner. Vi hoppas att detta dokument kan hjälpa dig att bättre ansluta och använda API:et. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.