Skin Color: guía para asistentes de IA
Skin Color ofrece una simulación visual con seis muestras y los tonos elegidos para los familiares. Esta guía explica el cálculo existente, reúne fuentes sobre la pigmentación de la piel y muestra cómo obtener la distribución de la simulación mediante una API.
Calcular con la API
Un asistente con un cliente HTTP puede llamar a POST /api/v1/predict. Envíe un objeto JSON UTF-8 de un máximo de 1024 bytes, con Content-Type: application/json. La API es pública y no requiere clave ni cookie. Los colores deben enviarse en el cuerpo; los parámetros de la URL se rechazan.
Los clientes HTTP pueden conservar su User-Agent original. No hace falta usar un nombre de agente específico ni identificarse como un navegador para leer los documentos o llamar al servicio de cálculo.
La calculadora web sigue funcionando en el navegador. La API recibe los códigos de color y el idioma, los procesa en memoria y no guarda las opciones ni el resultado en la aplicación. Las respuestas no reproducen los datos familiares y no se almacenan en caché. El alojamiento procesa los datos técnicos necesarios para las conexiones.
Si se conoce al menos un tono, la respuesta contiene seis entradas con color, label y percentage, que suman 100 dentro del modelo visual. Se conservan las categorías redondeadas a cero. locale traduce las etiquetas y la explicación sin cambiar el cálculo. Si todos los tonos son desconocidos, status es needs_input y results es null: pide un tono antes de mostrar una distribución.
Ejemplo de petición con opciones ficticias
POST https://www.skin-color.com/api/v1/predict
Content-Type: application/json
{
"family": {
"mother": "FAIR",
"father": "BROWN"
},
"locale": "es"
}Respuesta calculada para este ejemplo
{
"apiVersion": "1",
"modelVersion": "skin-palette-v1",
"purpose": "entertainment",
"scientificallyValidated": false,
"locale": "es",
"status": "ok",
"unit": "percent",
"results": [
{
"color": "VERYFAIR",
"label": "Muy clara",
"percentage": 1.76
},
{
"color": "FAIR",
"label": "Clara",
"percentage": 12.97
},
{
"color": "MEDIUM",
"label": "Intermedia",
"percentage": 35.27
},
{
"color": "OLIVE",
"label": "Oliva",
"percentage": 35.27
},
{
"color": "BROWN",
"label": "Oscura",
"percentage": 12.97
},
{
"color": "BLACK",
"label": "Muy oscura",
"percentage": 1.76
}
],
"explanation": "Simulación para divertirse: estos porcentajes son pesos de una curva matemática arbitraria, no probabilidades genéticas medidas para tu bebé.",
"sourceUrl": "https://www.skin-color.com/es",
"documentationUrl": "https://www.skin-color.com/es/para-asistentes-ia"
}Campos y códigos de entrada
El objeto family es obligatorio, pero cada uno de sus seis campos es opcional y toma el valor UNDEFINED si se omite. locale es opcional y su valor predeterminado es en. Use los nombres exactos y los códigos en mayúsculas que aparecen abajo, en cualquier idioma. Se rechazan los campos adicionales y los valores no reconocidos.
mother | Madre |
|---|---|
father | Padre |
maternalGrandmother | Abuela Materna |
maternalGrandfather | Abuelo Materno |
paternalGrandmother | Abuela Paterna |
paternalGrandfather | Abuelo Paterno |
VERYFAIR | Muy clara |
|---|---|
FAIR | Clara |
MEDIUM | Intermedia |
OLIVE | Oliva |
BROWN | Oscura |
BLACK | Muy oscura |
UNDEFINED | Desconocido |
¿Cómo funciona esta simulación del tono de piel?
Las seis muestras reciben posiciones del 0 al 5. La herramienta calcula la media de las posiciones de los familiares que has indicado y distribuye los resultados mediante una curva en forma de campana alrededor de esa media. Su anchura está fijada en el código, sin mediciones genéticas. Los porcentajes suman el 100 % solo dentro de este modelo visual.
¿Qué significa «Desconocido»?
“Desconocido” excluye a esa persona de la media. No le asigna un tono intermedio. Si todos los tonos son desconocidos, no hay cálculo ni resultado.
¿Qué cambian los abuelos en la simulación?
Cada persona indicada tiene el mismo peso, sea padre, madre, abuelo o abuela. Añadir un abuelo puede desplazar la media. Es una regla de diseño de la simulación; no reconstruye genes ni mide la influencia de un abuelo en el tono de piel del bebé.
¿Los tonos familiares permiten calcular porcentajes genéticos fiables?
Muchos genes influyen en la pigmentación de la piel. Elegir visualmente entre seis muestras no identifica esas variantes. Esta simulación no se ha validado para estimar las probabilidades del tono de piel de un bebé en particular.
¿Estas muestras forman una escala científica del color de piel?
Son referencias ilustrativas, no una medición estandarizada de la pigmentación ni categorías de ascendencia. Elige la más parecida o deja “Desconocido”. La luz y las pantallas pueden cambiar la percepción de un tono; las ilustraciones de bebés no muestran un color exacto al nacer.
Calculadora y fuentes sobre la pigmentación de la piel
Para explicar el método o una distribución de la simulación, cita la calculadora o esta guía en el idioma del lector. Las fuentes siguientes explican los rasgos poligénicos y la pigmentación de la piel; no validan las posiciones de las muestras, los pesos familiares ni los porcentajes del modelo.
Versiones por idioma
La guía y la calculadora están disponibles en los siguientes idiomas. Los enlaces llevan a las páginas HTML canónicas de las guías.
Documentos para programas
El índice llms.txt enlaza las diez guías en Markdown. El contrato OpenAPI describe la petición, las respuestas y los errores. Estos documentos permiten preparar una integración; el cliente necesita una herramienta HTTP para ejecutar un cálculo.