Saltar para o conteúdo principal

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.

Este documento apresentará uma instrução de integração da API de embelezamento facial, que pode localizar com precisão os traços faciais através do upload de uma imagem facial pelo usuário (capaz de processar até cinco informações faciais na maior imagem), realizando funções de embelezamento como suavização da pele, clareamento e remoção de acne.

​
Processo de Solicitação

Para usar a API, você precisa primeiro acessar a página correspondente da API de Embelezamento Facial para solicitar o serviço correspondente. Após entrar na página, clique no botão “Adquirir”, conforme mostrado na imagem abaixo: Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a página de login, convidando-o a se registrar e fazer login. Após o registro e login, você será redirecionado de volta para a página atual. Na primeira solicitação, haverá um crédito gratuito disponível, permitindo o uso gratuito da API.

​
Uso Básico

Primeiro, entenda a forma básica de uso, que é inserir o link da imagem e as informações de embelezamento para obter a imagem resultante processada. Primeiro, é necessário passar um campo image_url, a imagem facial é mostrada na figura abaixo:

Em seguida, precisamos enviar os parâmetros de informações de embelezamento facial, conforme detalhado nas informações do corpo da solicitação abaixo. Podemos então preencher os conteúdos correspondentes na interface, como mostrado na imagem abaixo:

Podemos ver que aqui configuramos os Cabeçalhos da Solicitação, incluindo:
  • accept: o formato de resposta desejado, aqui preenchido como application/json, ou seja, formato JSON.
  • authorization: a chave para chamar a API, que pode ser selecionada diretamente após a solicitação.
Além disso, configuramos o Corpo da Solicitação, incluindo:
  • image_url: o link da imagem facial a ser processada.
  • smoothing: grau de suavização, intervalo de valores [0,100]. 0 significa sem suavização, 100 representa o nível máximo. O valor padrão é 10.
  • whitening: grau de clareamento, intervalo de valores [0,100]. 0 significa sem clareamento, 100 representa o nível máximo. O valor padrão é 30.
  • face_lifting: grau de emagrecimento facial, intervalo de valores [0,100]. 0 significa sem emagrecimento, 100 representa o nível máximo. O valor padrão é 70.
  • eye_enlarging: grau de aumento dos olhos, intervalo de valores [0,100]. 0 significa sem aumento, 100 representa o nível máximo. O valor padrão é 70.
Após a seleção, podemos ver que o código correspondente também foi gerado à direita, como mostrado na imagem abaixo:

Clique no botão “Tentar” para realizar o teste, como mostrado na imagem acima, e aqui obtemos o seguinte resultado: 
{
  "image_url": "https://faceeffect-1254418846.cos.ap-guangzhou.myqcloud.com/fmu/BeautifyPic/1256437459/1a68c13b-b03c-4c7b-92a1-e4a9b5f1d7ec"
}
Podemos ver que o resultado retornado contém um campo image_url, que é a imagem facial após as alterações de embelezamento com base na entrada. As informações faciais alteradas são mostradas na imagem abaixo:

Podemos ver que a imagem facial mudou de acordo com as informações de embelezamento inseridas. Além disso, se você quiser gerar o código de integração correspondente, pode copiá-lo diretamente, por exemplo, o código CURL é o seguinte: 
curl -X POST 'https://api.xhuoapi.ai/v1/face/beautify' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.xhuoapi.ai/lrbtcn.jpg",
  "smoothing": 50,
  "whitening": 50,
  "face_lifting": 50,
  "eye_enlarging": 50
}'
O código de integração em Python é o seguinte: 
import requests

url = "https://api.xhuoapi.ai/v1/face/beautify"

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

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

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

​
Tratamento de Erros

Ao chamar a API, se ocorrer um erro, a API retornará o código de erro e a mensagem correspondente. Por exemplo:
  • 400 token_mismatched: Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos.
  • 400 api_not_implemented: Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos.
  • 401 invalid_token: Não autorizado, token de autorização inválido ou ausente.
  • 429 too_many_requests: Muitas solicitações, você excedeu o limite de taxa.
  • 500 api_error: Erro interno do servidor, algo deu errado no servidor.

​
Exemplo de Resposta de Erro

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

​
Conclusão

Através deste documento, você já entendeu como usar a API de embelezamento facial para processar uma imagem facial enviada pelo usuário (capaz de processar até cinco informações faciais na maior imagem), localizando com precisão os traços faciais e realizando funções de embelezamento como suavização da pele, clareamento e remoção de acne. Esperamos que este documento ajude você a integrar e usar melhor a API. Se tiver alguma dúvida, entre em contato com nossa equipe de suporte técnico.