# Skin Color: guia para assistentes de IA HTML: 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 ```http 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 ```json { "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. ### 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 - `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. - [Calculadora da cor da pele do bebê]() - [Como funciona esta simulação de tom de pele?]() - [NHGRI — Polygenic Trait]() - [Crawford et al. (2017), Science — Loci associated with skin pigmentation identified in African populations]() ## 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]()