Hoppa till huvudinnehåll
Denna artikel kommer att introducera en ansökan om API för ansikts könsbyte, som kan generera en bild av ett ansikte med ändrat kön baserat på en bild som användaren laddar upp, med hjälp av algoritmer för ansiktsredigering och -generering. Från man till kvinna kan det uppnå effekter som skönhetsbehandling, lätt smink, lugg och långt hår; från kvinna till man kan det uppnå effekter som skägg och kort hår.

​
Ansökningsprocess

För att använda API:et måste du först gå till API för ansikts könsbyte och ansöka om den tjänst som motsvarar sidan. 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 uppmanas att registrera dig och logga in. Efter att du har 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 kan användas för att gratis använda detta API.

​
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 könsinformation för att få den bearbetade resultatbilden. Först behöver du enkelt överföra ett image_url-fält, där ansiktsbilden visas nedan:

Sedan behöver vi också ladda upp könsinformationen för ansiktet, gender_infos, som är en array där vi kan ange flera uppgifter. 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 Request Headers, 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, som kan väljas direkt efter ansökan.
Dessutom har vi ställt in Request Body, inklusive:
  • image_url: länken till den ansiktsbild som ska bearbetas.
  • gender_infos: information om ansiktets kön och område, där kön är en obligatorisk parameter, 0 betyder att det går från man till kvinna, 1 betyder att det går från kvinna till man.
När du har valt kan du se att det också har genererats motsvarande kod 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/ft/SwapGenderPic/1256437459/1d85ceb9-6847-41ec-a9fd-7a20ddbd13b6"
}
Som du kan se finns det ett image_url-fält i det returnerade resultatet, vilket är den ansiktsbild som har ändrats baserat på de angivna könsparametrarna. Den förändrade ansiktsinformationen visas nedan:

Du kan se att ansiktet i bilden har förändrats baserat på det angivna könet. Om du vill generera motsvarande anslutningskod kan du enkelt kopiera den som genererats, till exempel CURL-koden nedan: 
curl -X POST 'https://api.acedata.cloud/face/change-gender' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg",
  "gender_infos": [{"gender":1}]
}'
Python-koden för anslutning ser ut så här: 
import requests

url = "https://api.acedata.cloud/face/change-gender"

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

payload = {
    "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg",
    "gender_infos": [{"gender":1}]
}

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, kan bero på saknade eller ogiltiga parametrar.
  • 400 api_not_implemented: Bad request, kan bero på saknade eller ogiltiga parametrar.
  • 401 invalid_token: Unauthorized, ogiltig eller saknad auktoriseringstoken.
  • 429 too_many_requests: För många förfrågningar, 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 du använder API för ansikts könsbyte för att bearbeta en bild av ett ansikte som användaren laddar upp, baserat på algoritmer för ansiktsredigering och -generering, för att producera en bild av ett ansikte med ändrat kön. Vi hoppas att detta dokument kan hjälpa dig att bättre ansluta och använda detta API. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.