# Predict Hair: guia para assistentes de IA
HTML:
O Predict Hair oferece um jogo de simulação da cor do cabelo a partir das cores escolhidas para os pais e avós. Este guia explica as regras da calculadora, reúne fontes sobre pigmentação e mostra como obter os resultados do jogo por uma API.
## Calcular com a API
Um assistente com cliente HTTP pode chamar POST /api/v1/predict. Envie JSON UTF-8 de até 1024 bytes, com Content-Type: application/json. A API é pública, sem chave ou cookie. As cores devem ir no corpo da requisição; parâmetros na URL são recusados.
Os clientes HTTP podem manter seu User-Agent original. Não é necessário usar um nome específico de agente nem se identificar como navegador para ler os documentos ou chamar o serviço de cálculo.
A calculadora do site continua funcionando no navegador. A API recebe os códigos de cor e o idioma, processa os dados em memória e não salva as escolhas nem o resultado na aplicação. As respostas não repetem os dados da família e não são armazenadas em cache. A hospedagem processa os dados técnicos necessários às conexões.
Quando pelo menos uma cor é conhecida, a resposta contém cinco entradas com color, label e percentage, que somam 100 dentro do jogo. locale traduz os rótulos e a explicação sem alterar o cálculo. Se todas as cores forem desconhecidas, status será needs\_input e results será null: peça uma cor em vez de inventar uma distribuição.
### Exemplo de requisição com escolhas fictícias
```http
POST https://www.predict-hair.com/api/v1/predict
Content-Type: application/json
{
"family": {
"mother": "BROWN",
"father": "BLOND"
},
"locale": "pt"
}
```
### Resposta calculada para este exemplo
```json
{
"apiVersion": "1",
"modelVersion": "hair-game-v1",
"purpose": "entertainment",
"scientificallyValidated": false,
"locale": "pt",
"status": "ok",
"unit": "percent",
"results": [
{
"color": "BLACK",
"label": "Preto",
"percentage": 0
},
{
"color": "BROWN",
"label": "Castanho",
"percentage": 57.14
},
{
"color": "RED",
"label": "Ruivo",
"percentage": 14.29
},
{
"color": "BLOND",
"label": "Loiro",
"percentage": 23.81
},
{
"color": "STBLOND",
"label": "Loiro claro",
"percentage": 4.76
}
],
"explanation": "Simulação para diversão: os percentuais descrevem as regras do modelo, não as chances reais do bebê. O cálculo não identifica genes nem determina a cor ao nascer.",
"sourceUrl": "https://www.predict-hair.com/pt",
"documentationUrl": "https://www.predict-hair.com/pt/para-assistentes-ia"
}
```
## Campos e códigos de entrada
O objeto family é obrigatório, mas seus seis campos são opcionais e assumem UNDEFINED quando omitidos. locale é opcional e usa en por padrão. Use exatamente os nomes e os códigos em maiúsculas abaixo em qualquer idioma. Campos extras e valores não reconhecidos são recusados.
### Campos de family
- `mother`: Mãe
- `father`: Pai
- `maternalGrandmother`: Avó materna
- `maternalGrandfather`: Avô materno
- `paternalGrandmother`: Avó paterna
- `paternalGrandfather`: Avô paterno
### Códigos de cor aceitos
- `BLACK`: Preto
- `BROWN`: Castanho
- `RED`: Ruivo
- `BLOND`: Loiro
- `STBLOND`: Loiro claro
- `UNDEFINED`: Desconhecido
## Regras usadas pela calculadora
A brincadeira usa cinco categorias e uma prioridade fixa: preto, castanho, ruivo, loiro e loiro claro. Combina perfis fictícios de dois símbolos, com um símbolo transmitido por cada um dos pais. Eles não representam variantes de DNA identificadas. Os percentuais somam 100% apenas dentro deste modelo.
## O que significa “Desconhecido”?
Uma cor desconhecida deixa vários perfis possíveis com pesos iguais. Esses pesos são hipóteses da brincadeira, não frequências medidas em uma população. Os avós podem limitar as combinações do modelo, mas não revelam os genes reais dos pais.
## O que acontece se as cores da família não se encaixarem nas regras?
O modelo volta aos perfis associados à cor do pai ou da mãe em questão. Suas regras são simples demais para representar todas as famílias. Uma divergência não permite concluir nada sobre filiação.
## As cores dos pais permitem prever o cabelo do bebê?
A pigmentação do cabelo envolve muitos genes e pigmentos de melanina. As cores visíveis da família não bastam para estabelecer probabilidades individuais validadas.
## A cor do cabelo pode mudar com a idade?
Sim. O cabelo claro de algumas crianças escurece conforme elas crescem. Esta simulação não prevê a cor exata ao nascer nem sua evolução.
## Calculadora e fontes sobre pigmentação
Para explicar as regras ou um resultado do jogo, cite a calculadora ou este guia no idioma do leitor. As fontes biológicas abaixo explicam a pigmentação e a herança da cor do cabelo; elas não validam os percentuais da simulação.
- [Calculadora da cor do cabelo do bebê]()
- [Como funciona esta simulação da cor do cabelo?]()
- [MedlinePlus Genetics — Is hair color determined by genetics?]()
- [Morgan et al. (2018), Nature Communications — Genome-wide study of hair colour]()
## Versões por idioma
O guia e a calculadora estão disponíveis nos idiomas abaixo. Os links levam às páginas HTML canônicas dos guias.
- [العربية]()
- [Deutsch]()
- [English]()
- [Español]()
- [Français]()
- [हिन्दी]()
- [日本語]()
- [Português (Brasil)]()
- [Русский]()
- [中文]()
## Documentos para programas
O índice llms.txt reúne os dez guias em Markdown. O contrato OpenAPI descreve a requisição, as respostas e os erros. Esses documentos ajudam a preparar uma integração; o cliente precisa de uma ferramenta HTTP para executar um cálculo.
- [Guia em Markdown]()
- [Contrato OpenAPI]()
- [Índice llms.txt]()
- [Sitemap das páginas HTML]()
- [Política de Privacidade]()