Skin Color: guia para assistentes de IA
O Skin Color oferece uma simulação visual com seis amostras e os tons escolhidos para os familiares. Este guia explica o cálculo existente, reúne fontes sobre pigmentação da pele e mostra como obter a distribuição da simulação 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 um tom é conhecido, a resposta contém seis entradas com color, label e percentage, que somam 100 dentro do modelo visual. As categorias arredondadas para zero são mantidas. locale traduz os rótulos e a explicação sem alterar o cálculo. Se todos os tons forem desconhecidos, status será needs_input e results será null: peça um tom antes de exibir uma distribuição.
Exemplo de requisição com escolhas fictícias
POST https://www.skin-color.com/api/v1/predict
Content-Type: application/json
{
"family": {
"mother": "FAIR",
"father": "BROWN"
},
"locale": "pt"
}Resposta calculada para este exemplo
{
"apiVersion": "1",
"modelVersion": "skin-palette-v1",
"purpose": "entertainment",
"scientificallyValidated": false,
"locale": "pt",
"status": "ok",
"unit": "percent",
"results": [
{
"color": "VERYFAIR",
"label": "Muito clara",
"percentage": 1.76
},
{
"color": "FAIR",
"label": "Clara",
"percentage": 12.97
},
{
"color": "MEDIUM",
"label": "Intermediária",
"percentage": 35.27
},
{
"color": "OLIVE",
"label": "Oliva",
"percentage": 35.27
},
{
"color": "BROWN",
"label": "Escura",
"percentage": 12.97
},
{
"color": "BLACK",
"label": "Muito escura",
"percentage": 1.76
}
],
"explanation": "Simulação para brincar: estes percentuais são pesos de uma curva matemática arbitrária, não chances genéticas medidas para o seu bebê.",
"sourceUrl": "https://www.skin-color.com/pt",
"documentationUrl": "https://www.skin-color.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.
mother | Mãe |
|---|---|
father | Pai |
maternalGrandmother | Avó Materna |
maternalGrandfather | Avô Materno |
paternalGrandmother | Avó Paterna |
paternalGrandfather | Avô Paterno |
VERYFAIR | Muito clara |
|---|---|
FAIR | Clara |
MEDIUM | Intermediária |
OLIVE | Oliva |
BROWN | Escura |
BLACK | Muito escura |
UNDEFINED | Desconhecida |
Como funciona esta simulação de tom de pele?
As seis amostras recebem posições de 0 a 5. A ferramenta calcula a média das posições dos familiares informados e distribui os resultados em uma curva em forma de sino ao redor dessa média. A largura é fixada no código, sem medições genéticas. Os percentuais somam 100% apenas dentro deste modelo visual.
O que significa “Desconhecido”?
“Desconhecido” exclui essa pessoa da média. Não atribui a ela um tom intermediário. Se todos os tons forem desconhecidos, não há cálculo nem resultado.
O que os avós mudam na simulação?
Cada pessoa informada tem o mesmo peso, seja um dos pais ou um dos avós. Adicionar um avô ou uma avó pode deslocar a média. É uma regra de criação da simulação; ela não reconstrói genes nem mede a influência de um avô no tom de pele do bebê.
Os tons da família permitem calcular percentuais genéticos confiáveis?
Muitos genes influenciam a pigmentação da pele. Escolher visualmente entre seis amostras não identifica essas variantes. Esta simulação não foi validada para estimar as probabilidades do tom de pele de um bebê em particular.
Estas amostras formam uma escala científica da cor da pele?
São referências para a ilustração, não uma medição padronizada da pigmentação nem categorias de ancestralidade. Escolha a mais próxima ou deixe “Desconhecido”. A luz e as telas podem mudar a percepção de um tom; as ilustrações de bebês não mostram uma cor exata ao nascer.
Calculadora e fontes sobre pigmentação da pele
Para explicar o método ou uma distribuição da simulação, cite a calculadora ou este guia no idioma do leitor. As fontes abaixo explicam características poligênicas e pigmentação da pele; elas não validam as posições das amostras, os pesos familiares nem os percentuais do modelo.
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.
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.