> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ansökningsbeskrivning för API för ansiktsåldersförändring

> Face Transformation 集成指南 - XHuoAPI

Denna artikel kommer att introducera en ansökningsbeskrivning för API för ansiktsåldersförändring, som kan ändra åldern på ansiktet i en bild genom att mata in en bild och en ålder. Den ungefärliga användningen är att användaren laddar upp en bild av ett ansikte, baserat på algoritmer för ansiktsredigering och generering, och får ut en bild där ansiktet ser äldre eller yngre ut, vilket stöder förändringar av ansiktets ålder.

## Ansökningsprocess

För att använda API:et måste du först gå till [API för ansiktsåldersförändring](https://api.xhuoapi.ai/documents/0c5b4165-25ba-4dc2-8f02-e3cd74ab4238) och ansöka om den tjänst som motsvarar. När du kommer till sidan klickar du på knappen "Acquire", som visas i bilden nedan:

![](https://cdn.xhuoapi.ai/q6ytrc.png)

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 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 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ändningen, vilket innebär att du anger en bildlänk och åldersinformation för att få den bearbetade resultatbilden. Du behöver först enkelt skicka ett `image_url`-fält, där ansiktsbilden visas nedan:

<p>
  <img src="https://cdn.xhuoapi.ai/f5687u.png" width="500" className="m-auto" />
</p>

Sedan behöver vi också ladda upp information om ansiktsåldern, `age_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:

<p>
  <img src="https://cdn.xhuoapi.ai/cn95e8.png" width="500" className="m-auto" />
</p>

Här kan vi se att vi har ställt in Request Headers, inklusive:

* `accept`: vilken format av svar vi 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.
* `age_infos`: information om ansiktsålder och områdesinformation, där ålder är en obligatorisk parameter.

När du har valt kan du se att det också har genererats motsvarande kod till höger, som visas i bilden nedan:

<p>
  <img src="https://cdn.xhuoapi.ai/zk8qkl.png" width="500" className="m-auto" />
</p>

Klicka på knappen "Try" för att testa, som visas i bilden ovan, och här får vi följande resultat:

```json theme={null}
{
  "image_url": "https://faceeffect-1254418846.cos.ap-guangzhou.myqcloud.com/ft/ChangeAgePic/1256437459/bfce1ab8-5fd7-464d-8878-b38433f84d0e"
}
```

Vi kan se att det i det returnerade resultatet finns ett `image_url`-fält, vilket är bilden av ansiktet efter åldersförändringen baserat på den angivna åldern. Den förändrade ansiktsinformationen visas nedan:

<p>
  <img src="https://cdn.xhuoapi.ai/01rmiv.png" width="500" className="m-auto" />
</p>

Vi kan se att ansiktet i bilden har förändrats baserat på den angivna åldern.

Om du vill generera motsvarande anslutningskod kan du direkt kopiera den som genererats, till exempel CURL-koden nedan:

```shell theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/face/change-age' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "age_infos": [{"age":60}],
  "image_url": "https://cdn.xhuoapi.ai/f5687u.png"
}'
```

Python-anslutningskoden ser ut så här:

```python theme={null}
import requests

url = "https://api.xhuoapi.ai/v1/face/change-age"

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

payload = {
    "age_infos": [{"age":60}],
    "image_url": "https://cdn.xhuoapi.ai/f5687u.png"
}

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 förfrågningar, du har överskridit hastighetsgränsen.
* `500 api_error`: Intern serverfel, något gick fel på servern.

### Exempel på felrespons

```json theme={null}
{
  "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åldersförändring för att bearbeta den angivna bilden och åldersinformationen för att förändra ansiktets ålder. 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.