Hoppa till huvudinnehåll
Detta dokument kommer att introducera en Porträtt Anime API integrationsbeskrivning, som kan generera personliga anime-figurer genom att mata in ett foto av ett ansikte. Det kan användas för att skapa personliga avatarer, roliga aktiviteter, specialeffektsapplikationer och andra scenarier, vilket förbättrar upplevelsen av social underhållning.

​
Ansökningsprocess

För att använda API:et måste du först gå till Porträtt Anime API motsvarande sida för att ansöka om den tjänst som behövs. När du kommer till sidan, klicka på “Acquire”-knappen, som visas i bilden nedan: Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till inloggningssidan för att registrera dig och logga in. Efter inloggning eller registrering 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 och främst, förstå den grundläggande användningsmetoden, vilket innebär att du matar in en bildlänk för att få den bearbetade resultatbilden. Du behöver först enkelt överföra ett image_url-fält, ansiktsbilden visas nedan:

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 typ 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 ansiktsbilden som ska bearbetas.
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å “Try”-knappen 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/FaceCartoonPic/1256437459/8567833b-7831-406c-9ff5-890e5f7e020e"
}
Som du kan se finns det ett image_url-fält i det returnerade resultatet, vilket är den förändrade tecknade ansiktsbilden. Den förändrade ansiktsinformationen visas nedan:

Du kan se att ansiktet i bilden har genererat en personlig anime-figur. Om du vill generera motsvarande integrationskod kan du direkt kopiera den som genererats, till exempel CURL-koden nedan: 
curl -X POST 'https://api.acedata.cloud/face/cartoon' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg"
}'
Python integrationskoden ser ut som följer: 
import requests

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

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

payload = {
    "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg"
}

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, troligen på grund av saknade eller ogiltiga parametrar.
  • 400 api_not_implemented: Bad request, troligen på grund av 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 Porträtt Anime API för att generera personliga anime-figurer från inmatade bilder. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda API:et. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.