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 API de conversão de gênero facial, que pode gerar uma imagem de conversão de gênero facial com base em uma foto de rosto enviada pelo usuário, utilizando algoritmos de edição e geração de rostos. A conversão de homem para mulher pode incluir efeitos de embelezamento, maquiagem leve, franja e cabelo longo; a conversão de mulher para homem pode incluir adição de barba e cabelo curto.

​
Processo de Solicitação

Para usar a API, você precisa primeiro acessar a página correspondente da API de Conversão de Gênero Facial para solicitar o serviço correspondente. Após acessar a página, clique no botão “Acquire”, 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 gênero para obter a imagem resultante processada. Primeiro, você precisa passar um campo image_url, a imagem do rosto é mostrada na imagem abaixo:

Em seguida, precisamos enviar as informações de gênero facial no parâmetro gender_infos, que é um array, permitindo que enviemos várias informações. Podemos preencher o conteúdo correspondente na interface, conforme mostrado na imagem abaixo:

Podemos ver que aqui configuramos os Headers da Requisiçã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 Requisição, incluindo:
  • image_url: o link da imagem do rosto a ser processada.
  • gender_infos: informações sobre o gênero e a área do rosto, onde o gênero é um parâmetro obrigatório, 0 indica a conversão de masculino para feminino, 1 indica a conversão de feminino para masculino.
Após a seleção, podemos ver que o código correspondente também foi gerado à direita, conforme mostrado na imagem abaixo:

Clique no botão “Try” para realizar o teste, como mostrado na imagem acima, e obtemos o seguinte resultado: 
{
  "image_url": "https://faceeffect-1254418846.cos.ap-guangzhou.myqcloud.com/ft/SwapGenderPic/1256437459/1d85ceb9-6847-41ec-a9fd-7a20ddbd13b6"
}
Podemos ver que o resultado retornado contém um campo image_url, que é a imagem do rosto alterada com base nos parâmetros de mudança de gênero inseridos. A informação do rosto alterado é mostrada na imagem abaixo:

Podemos ver que o rosto na imagem mudou de acordo com o gênero inserido. 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/change-gender' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.xhuoapi.ai/lrbtcn.jpg",
  "gender_infos": [{"gender":1}]
}'
O código de integração em Python é o seguinte: 
import requests

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

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

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

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 e a mensagem de erro correspondentes. 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 Conversão de Gênero Facial para que os usuários enviem uma foto de rosto, utilizando algoritmos de edição e geração de rostos, para gerar uma imagem de conversão de gênero facial. 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.