A API de Penteados de IA

Obtenha sua chave de API

Crie uma conta e, na seção do seu perfil, crie uma chave de API.

Compre créditos (ou use o modo de teste)

Visite a seção do seu perfil para comprar créditos da API. Cada geração bem-sucedida consumirá um crédito do seu saldo.

Os créditos nunca expiram e podem ser usados a qualquer momento. Descontos por volume estão disponíveis para compras em grande quantidade.

Para testar, você pode usar o modo: 'test' na solicitação da API. Isso não consumirá nenhum crédito do seu saldo, mas permitirá testar o fluxo completo da API.

Obtenha os estilos

Envie uma solicitação GET para obter os estilos:

https://api.aihairstyles.com/api/styles

Você receberá uma resposta JSON com os estilos, como abaixo. Observe que o objeto preview_images contém as imagens para ambos os sexos.

{
  "description": "Bob - disheveled",
  "preview_images": {
    "man-white": "https://ik.imagekit.io/aicosmetic/AAA-hairstyle_images/models/man-white/00037.png?updatedAt=1710976848880",
    "woman-white": "https://ik.imagekit.io/aicosmetic/AAA-hairstyle_images/models/woman-white/bob%20dishevled.png?updatedAt=1707320590149"
  },
  "preview_image": "https://ik.imagekit.io/aicosmetic/null",
  "sex": "feminine",
  "id": 817941,
  "tags": "disheveled, bob"
}

Crie uma geração

Envie uma solicitação POST para criar uma nova geração em

https://api.aihairstyles.com/api/preview

Sua chave de API deve estar nos cabeçalhos da sua solicitação, no campo x-api-key.

A solicitação deve ser enviada como dados de formulário com os seguintes campos:

Imagem (obrigatório)

• Idealmente, deve ser uma imagem quadrada com o rosto do sujeito claramente visível. As imagens serão cortadas para ficarem quadradas se não forem quadradas
• Com área suficiente ao redor do rosto e do cabelo para o AI gerar estilos diferentes.
• O tamanho máximo de arquivo permitido é de 8Mb.

Múltiplos estilos separados por vírgula

Opções: loiro, castanho, preto, ruivo, cinza

Opções: masculino, feminino, ou pessoa (padrão)

URL do seu webhook

Opções: teste. Use durante o desenvolvimento para evitar cobranças.

Resposta bem-sucedida

{
  "data": {
    "id": 1234,
    "inputUrl": "https://ik.imagekit.io/aicosmetic/f8b915b2-57df-49b7/123123123"
  },
  "message": "Job created successfully",
  "status": "success"
}

Manipulação do resultado (polling ou webhook)

Você tem duas opções para manipular o resultado.

Webhook

Especifique uma callback_url na solicitação POST original para criar uma visualização, e enviaremos uma solicitação POST para esse URL quando a geração estiver completa.

Polling

Envie uma solicitação GET para o ID da visualização para verificar o status. Observe que o polling mais rápido do que uma vez por segundo resultará em limitação de taxa.

https://aihairstyles.com/api/preview/[preview_id]

Resposta bem-sucedida

{
  "data": {
    "images": [
      "https://ik.imagekit.io/aicosmetic/3291-preview-723335832172-7679_Se7y5RMBR"
    ],
    "status": "done"
  },
  "message": "",
  "status": "success"
}

Resposta de erro

{
  "data": null,
  "message": "Invalid API key",
  "status": "error"
}